decidim 0.28.3 → 0.29.0.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e0f298e4eabcc50477309820599b7e816b35f89270a4bf9e8368083d262fe1cd
-  data.tar.gz: d8d1f0b469cecffd71fcdd4d5b125dea9dde610006550a4d0f7d146801fa8987
+  metadata.gz: ebd04f0caaf87134717507a36fcf80b38e264d816d8255b5b5fbb039d86b8700
+  data.tar.gz: 1924c2e4c641993c0f9f7af0cb57b23dfa67beafa3244a832af122b0a57f691b
 SHA512:
-  metadata.gz: 33bfe014d7f1209743d11bcbd5cc0e7f303d525fe8d4a8c6c6f0d6408007ac08d31319066f62c5b01fc8c405b8a450333054ab3134705c98af5315bc16c1f81c
-  data.tar.gz: df62264255c2e292b969e5afe394780dbd4f6fbcc13251a44b18a3103752d0304099f380709f91ae370bb04601f3e591cba6eb37c2439bc4ec7f2e84f5a32f5c
+  metadata.gz: 95d414b2529227f587e08b474f709ba9d8826445bac39ef06d6cf414f8b774c61f3dd2dc9c93284e718885f3f675ad207643525030199e157d563be57200e7b5
+  data.tar.gz: ef978ea37753656c348f4dce34abe3c1049e7c0fb52b997a44c50c7575549e3c1b2a50bb8492dbba6aac8e58d04cfc9ef8a8d56ca4fcfb52cb1c6f548341958d

data/decidim-core/lib/decidim/webpacker/esbuild.config.js

@@ -0,0 +1,14 @@
+// eslint-disable-next-line no-undef
+module.exports = {
+  options: {
+    tsconfigRaw: JSON.stringify({}),
+    target: "es2015"
+  },
+  bundle: true,
+  sourcemap: true,
+  minify: true,
+  outdir: "public",
+  outExtension: {
+    ".css": ".scss"
+  }
+};

data/decidim-core/lib/decidim/webpacker/shakapacker.yml

@@ -22,12 +22,12 @@ default: &default
   cache_manifest: false
 
   # Select loader to use, available options are 'babel' (default), 'swc' or 'esbuild'
-  webpack_loader: 'babel'
+  webpack_loader: 'esbuild'
 
   # Set to true to enable check for matching versions of shakapacker gem and NPM package - will raise an error if there is a mismatch or wildcard versioning is used
   ensure_consistent_versioning: true
 
-  # Select whether the compiler will use SHA digest ('digest' option) or most most recent modified timestamp ('mtime') to determine freshness
+  # Select whether the compiler will use SHA digest ('digest' option) or most recent modified timestamp ('mtime') to determine freshness
   compiler_strategy: digest
 
   # Select whether the compiler will always use a content hash and not just in production

data/decidim-core/lib/decidim/webpacker/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "strict": true,                                      /* Enable all strict type-checking options. */
+    "removeComments": true,                              /* Disable emitting comments. */
+    "allowJs": true,                                     /* Allow JavaScript files to be a part of your program. Use the `checkJS` option to get errors from these files. */
+    "module": "commonjs",                                /* Specify what module code is generated. */
+    "incremental": true,                                 /* Enable incremental compilation */
+    "target": "es6",                                     /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
+    "skipLibCheck": true,                                /* Skip type checking all .d.ts files. */
+  }
+}

data/decidim-core/lib/decidim/webpacker/webpack/custom.js

@@ -1,7 +1,7 @@
 /* eslint-disable */
 const { config } = require("shakapacker");
 const { InjectManifest } = require("workbox-webpack-plugin");
-const TerserPlugin = require('terser-webpack-plugin')
+const { EsbuildPlugin } = require("esbuild-loader");
 
 module.exports = {
   module: {
@@ -15,8 +15,8 @@ module.exports = {
       },
       {
         test: /\.(js|jsx)$/,
-        exclude: /node_modules\/(?!tributejs)/,
-        loader: "babel-loader"
+        exclude: /node_modules\//,
+        loader: "esbuild-loader"
       },
       {
         test: /\.(graphql|gql)$/,
@@ -37,14 +37,11 @@ module.exports = {
         }
       },
       {
-        test: [
-          /\.md$/,
-          /\.odt$/,
-        ],
+        test: [/\.md$/, /\.odt$/],
         exclude: [/\.(js|mjs|jsx|ts|tsx)$/],
-        type: 'asset/resource',
+        type: "asset/resource",
         generator: {
-          filename: 'media/documents/[hash][ext][query]'
+          filename: "media/documents/[hash][ext][query]"
         }
       },
       // Overwrite webpacker files rule to amend the filename output
@@ -68,9 +65,9 @@ module.exports = {
           /\.svg$/
         ],
         exclude: [/\.(js|mjs|jsx|ts|tsx)$/],
-        type: 'asset/resource',
+        type: "asset/resource",
         generator: {
-          filename: 'media/images/[name]-[hash][ext][query]'
+          filename: "media/images/[name]-[hash][ext][query]"
         }
       }
     ]
@@ -81,32 +78,13 @@ module.exports = {
       crypto: false
     }
   },
-  // https://github.com/rails/webpacker/issues/2932
-  // As Decidim uses multiple packs, we need to enforce a single runtime, to prevent duplication
   optimization: {
     minimizer: [
-      new TerserPlugin({
-        parallel: Number.parseInt(process.env.SHAKAPACKER_PARALLEL, 10) || true,
-        terserOptions: {
-          parse: {
-            // Let terser parse ecma 8 code but always output
-            // ES5 compliant code for older browsers
-            ecma: 8
-          },
-          compress: {
-            ecma: 5,
-            warnings: false,
-            comparisons: false
-          },
-          mangle: { safari10: true },
-          output: {
-            ecma: 5,
-            comments: false,
-            ascii_only: true
-          }
-        }
+      new EsbuildPlugin({
+        target: "es2015",
+        css: true
       })
-    ].filter(Boolean)
+    ]
   },
   entry: config.entrypoints,
   plugins: [
@@ -122,4 +100,4 @@ module.exports = {
       swDest: "../sw.js"
     })
   ]
-}
+};

data/decidim.gemspec

@@ -18,7 +18,7 @@ Gem::Specification.new do |s|
     "homepage_uri" => "https://decidim.org",
     "source_code_uri" => "https://github.com/decidim/decidim"
   }
-  s.required_ruby_version = "~> 3.1.0"
+  s.required_ruby_version = "~> 3.2.0"
 
   s.name = "decidim"
 
@@ -63,6 +63,7 @@ Gem::Specification.new do |s|
   s.add_dependency "decidim-sortitions", Decidim.version
   s.add_dependency "decidim-surveys", Decidim.version
   s.add_dependency "decidim-system", Decidim.version
+  s.add_dependency "decidim-templates", Decidim.version
   s.add_dependency "decidim-verifications", Decidim.version
 
   s.add_development_dependency "bundler", "~> 2.2", ">= 2.2.18"

data/docs/README.adoc

@@ -15,7 +15,7 @@ Read more about https://asciidoctor.org/docs/asciidoc-vs-markdown/[Markdown vs A
 
 If you want to convert from Markdown to AsciiDoc:
 
-. online pandoc conversor or
+. online pandoc converter or
 . using kramdoc:
 
 [source,bash]
@@ -36,7 +36,7 @@ If you want to try changes in this folder and how it'd be shown in https://docs.
 . Build the antora playbook
 . Open the generated website with your web browser
 
-For instructions on how to clone the repository, install dependencies, build the antora playbook and open the generated webiste, see https://github.com/decidim/documentation[Decidim's documentation repository README file].
+For instructions on how to clone the repository, install dependencies, build the antora playbook and open the generated website, see https://github.com/decidim/documentation[Decidim's documentation repository README file].
 
 Regarding "3. Change the antora-playbook.yml url key in source", if this is the configuration at antora-playbook.yml:
 

data/docs/antora.yml

@@ -1,6 +1,6 @@
 name: en
 title: "Decidim Documentation"
-version: v0.28
+version: v0.29
 asciidoc:
   attributes:
     page-lang: en@

data/docs/modules/configure/pages/environment_variables.adoc

@@ -263,7 +263,7 @@ Also some more refined configurations:
 
 
 |MAPS_PROVIDER
-|For a simple geolocation and tile maps service configuration define this value to one of the supported providers, currently `here` for https://HERE.com[HERE Maps] or `osm` for https://www.openstreetmap.org[OpenStreatMap]. See xref:services:maps.adoc[Maps].
+|For a simple geolocation and tile maps service configuration define this value to one of the supported providers, currently `here` for https://HERE.com[HERE Maps] or `osm` for https://www.openstreetmap.org[OpenStreetMap]. See xref:services:maps.adoc[Maps].
 |
 |No
 
@@ -353,7 +353,7 @@ Also some more refined configurations:
 |No
 
 |OMNIAUTH_FACEBOOK_APP_ID
-|App ID for enabling access through Facebook.com accounts. See xref:services:social_providers.adoc[Social Providers]. Note that defining this variable automatically renders the "login with" button.
+|App ID for enabling access through Facebook.com accounts. See xref:services:social_providers.adoc[Social Providers]. Note that defining this variable automatically renders the "log in with" button.
 |
 |*Yes*
 
@@ -382,76 +382,6 @@ Also some more refined configurations:
 |
 |*Yes*
 
-|BULLETIN_BOARD_SERVER
-|The full URL to identify a https://github.com/decidim/decidim-bulletin-board[Bulletin Board Server]. *It must point to the Graphql API* (ie: https://bulletinboard.example.org/api) See xref:services:elections_bulletin_board.adoc[Elections Bulletin Board].
-|
-|No
-
-|BULLETIN_BOARD_PUBLIC_KEY
-|The public RSA key used to verify the Bulletin Board Server. See xref:services:elections_bulletin_board.adoc[Elections Bulletin Board].
-|
-|No
-
-|BULLETIN_BOARD_API_KEY
-|An additional API key to add additional security with the communications with the Elections Bulletin Board Server. See xref:services:elections_bulletin_board.adoc[Elections Bulletin Board].
-|
-|No
-
-|AUTHORITY_NAME
-|The name of the Authority registered in the Bulletin Board Server corresponding to this Decidim instance. See xref:services:elections_bulletin_board.adoc[Elections Bulletin Board].
-|
-|No
-
-|AUTHORITY_PRIVATE_KEY
-|The private RSA key of this Decidim instance corresponding to the Authority public key registered in the Bulletin Board Server. See xref:services:elections_bulletin_board.adoc[Elections Bulletin Board].
-|
-|No
-
-|ELECTIONS_SCHEME_NAME
-|The type of strategy used in the Bulletin Board Server used for encrypting the Election. *Currently only `electionguard` is available for production* See xref:services:elections_bulletin_board.adoc[Elections Bulletin Board].
-|electionguard
-|No
-
-|ELECTIONS_NUMBER_OF_TRUSTEES
-|Number of trustees for `electionguard` election scheme, minimum number is 2. See xref:services:elections_bulletin_board.adoc[Elections Bulletin Board].
-|
-|No
-
-|ELECTIONS_QUORUM
-|Number of trustees required to be present in order to decrypt an election in case of the `electionguard` scheme. Minimum is 2, maximum the number of trustees. See xref:services:elections_bulletin_board.adoc[Elections Bulletin Board].
-|
-|No
-
-|ELECTIONS_SETUP_MINIMUM_HOURS_BEFORE_START
-|Public Setting that defines how many hours should the setup be run before the election starts
-|3
-|No
-
-|ELECTIONS_START_VOTE_MAXIMUM_HOURS_BEFORE_START
-|Public Setting that defines how many hours the ballot box can be opened before the election starts
-|6
-|No
-
-|ELECTIONS_VOTER_TOKEN_EXPIRATION_MINUTES
-|How long any time of message sent to the bulletin board will be valid for any kind of processing.
-|120
-|No
-
-|VOTINGS_CHECK_CENSUS_MAX_REQUESTS
-|Max requests in a time period to check the census. Only applied in production and test.
-|5
-|No
-
-|VOTINGS_THROTTLING_PERIOD
-|Time window in which the VOTINGS_CHECK_CENSUS_MAX_REQUESTS throttling is applied (in minutes).
-|1
-|No
-
-|VOTINGS_CENSUS_ACCESS_CODES_EXPORT_EXPIRY_TIME
-|How long the census access codes export file will are available in the server (in days)
-|2
-|No
-
 |VAPID_PUBLIC_KEY
 |VAPID public key that will be used to sign the Push API requests. It can be generated running the task: `rails decidim:pwa:generate_vapid_keys`
 |
@@ -479,7 +409,7 @@ Also some more refined configurations:
 |DECIDIM_DEFAULT_LOCALE
 |The default locale to be used as a fallback (note that, in practice, this value must always be defined in the System configuration for each organization anyway).
 
-*Note that `DECIDIM_AVALABLE_LOCALES` must include this value*
+*Note that `DECIDIM_AVAILABLE_LOCALES` must include this value*
 |en
 |*Partially*, Only when creating a new organization
 
@@ -618,7 +548,7 @@ Notice that expire_session_after will not take effect when the user wants to be
 |No
 
 |DECIDIM_FOLLOW_HTTP_X_FORWARDED_HOST
-|Exposes a configuration option: `HTTP_X_FORWADED_HOST` header follow-up.
+|Exposes a configuration option: `HTTP_X_FORWARDED_HOST` header follow-up.
 
 If a caching system is in place, it can also allow cache and log poisoning attacks, allowing attackers to control the contents of caches and logs that could be used for other attacks.
 |false
@@ -684,7 +614,7 @@ Additional context: This has been revealed as an issue during a security audit o
 |No
 
 |*DECIDIM_SERVICE_WORKER_ENABLED*
-|Enable/Disable the service worker. This is used to enable offline support and to deliver push notifications. In development it is recommended to be disabled because its aggresive cache configuration might cause some issues when submitting forms.
+|Enable/Disable the service worker. This is used to enable offline support and to deliver push notifications. In development it is recommended to be disabled because its aggressive cache configuration might cause some issues when submitting forms.
 |false
 |No
 
@@ -711,22 +641,6 @@ Additional context: This has been revealed as an issue during a security audit o
 |15
 |No
 
-|PROPOSALS_SIMILARITY_THRESHOLD
-|When users create proposals, there are presented with a list of alternative, similar, proposals already created.
-Similarity goes from 0 (no similar at all) to 1 (exactly the same content).
-
-Lower this number to require less coincidences between the texts to create the alternative list.
-Increase this number to force the alternative proposal be very similar in order to be considered an alternative.
-
-Using a very high number (ie: 0.99) can effectively deactivate the comparison step when creating proposals.
-|0.25
-|No
-
-|PROPOSALS_SIMILARITY_LIMIT
-|Max number of proposals from the alternative, similar, proposals to be presented to the user.
-|10
-|No
-
 |PROPOSALS_PARTICIPATORY_SPACE_HIGHLIGHTED_PROPOSALS_LIMIT
 |Number of proposals to be shown in blocks with highlighted content across different participatory spaces.
 |4
@@ -860,7 +774,7 @@ Note that this only applies to production environments.
 |No
 
 |RAILS_ASSET_HOST
-|If you use a CDN or another type of assets management, you can specify the host (and path) for it so, instead of Rails serving your assets (CSS, Javascript, Images) will use your custom system. For instance `https://assets.example.org`
+|If you use a CDN or another type of assets management, you can specify the host (and path) for it so, instead of Rails serving your assets (CSS, JavaScript, Images) will use your custom system. For instance `https://assets.example.org`
 |
 |No
 

data/docs/modules/configure/pages/index.adoc

@@ -33,7 +33,7 @@ For instance, if you are planing to use some external cloud storage service (suc
 decidim --storage s3 my_decidim_application
 ----
 
-It is also recommended to use a proper Job Queue processor such as `sidekiq` or `delayed_job`. The `--queue` modifier allows you to generate a Decidim Application with a proper Sidekiq configuration (DelayedJob is not supported yet, PR wellcomed, but you can easily just follow the https://github.com/collectiveidea/delayed_job[official instructions]):
+It is also recommended to use a proper Job Queue processor such as `sidekiq` or `delayed_job`. The `--queue` modifier allows you to generate a Decidim Application with a proper Sidekiq configuration (DelayedJob is not supported yet, PR welcomed, but you can easily just follow the https://github.com/collectiveidea/delayed_job[official instructions]):
 
 [source,console]
 ----

data/docs/modules/configure/pages/initializer.adoc

@@ -447,7 +447,7 @@ Defines additional content security policies following the structure keys are th
 List of additional content security policies to be appended to the default ones
 This is useful for adding custom CSPs for external services like Here Maps, YouTube, X (former Twitter) etc.
 
-Below you will find a the recepy of enabling X (former Twitter) timelines, based on https://content-security-policy.com/examples/twitter/[Content Security Policy (CSP) Examples Twitter example].
+Below you will find a the recipe of enabling X (former Twitter) timelines, based on https://content-security-policy.com/examples/twitter/[Content Security Policy (CSP) Examples Twitter example].
 The format is a Hash with the following structure:
 [source,ruby]
 ....

data/docs/modules/customize/pages/admin_filters.adoc

@@ -0,0 +1,32 @@
+= Admin filters
+
+Filters in admin panels are defined with a common Filterable concern and each one defines a series of methods defining the different available filters, the options for each one, etc.
+
+Decidim provides an Api to manage and add custom elements to each admin filter defined in the application. Each defined filter can be accessed by a unique symbol and provides the methods `add_filters` and `add_dynamically_translated_filters` which allows us to add new items to the respective `filters` and `dynamically_translated` arrays provided by the filter registry and `add_filters_with_values` which allows us to merge new items into the `filters_with_values` hash also provided by the registry.
+
+Note that those methods are called at filter rendering time, so all methods provided by the controller and the concern filterable are available to evaluate when defining new elements
+
+For example, to add new filter to proposals index:
+
+[source,ruby]
+....
+Decidim.admin_filter(:proposals) do |filter|
+  # An example of how to access to the context. In this case the custom
+  # filter is only enabled for valuators of the space
+  if current_participatory_space.user_roles(:valuator).where(user: current_user).exists?
+    filter.add_filters(:custom_new_filter)
+    filter.add_filters_with_values(custom_new_filter: %w(custom_new_value_1 custom_new_value_2))
+  end
+end
+....
+
+The filter registry definition block is called from the proposals filterable concern in this way:
+
+[source,ruby]
+....
+delegate :filters, :dynamically_translated_filters, :filters_with_values, to: :filter_config
+
+def filter_config
+  @filter_config ||= Decidim::AdminFilter.new(:proposals).build_for(self)
+end
+....

data/docs/modules/customize/pages/data_consent.adoc

@@ -26,7 +26,7 @@ NOTE: Script type should be "text/plain". Without that, user's data consent sett
 
 == Adding data consent category and related documentation
 
-You are able to modify data consent categories via the `consent_gategories` configuration option.
+You are able to modify data consent categories via the `consent_categories` configuration option.
 
 For example if you want to add a "statistics" category you need to add following code to your app's initializer:
 

data/docs/modules/customize/pages/index.adoc

@@ -20,9 +20,10 @@ Inside of your application you can customize it in different ways:
 * xref:customize:data_consent.adoc[Data consent]
 * xref:customize:gemfile.adoc[Gemfile]
 * xref:customize:images.adoc[Images]
-* xref:customize:javascript.adoc[Javascript]
+* xref:customize:javascript.adoc[JavaScript]
 * xref:customize:logic.adoc[Logic]
 * xref:customize:menu.adoc[Menu]
+* xref:customize:admin_filters.adoc[Admin filters]
 * xref:customize:oauth.adoc[OAuth]
 * xref:customize:styles.adoc[Styles]
 * xref:customize:texts.adoc[Texts]

data/docs/modules/customize/pages/javascript.adoc

@@ -1,6 +1,6 @@
-= Javascript
+= JavaScript
 
-You can add Javascript code by multiple ways in Decidim:
+You can add JavaScript code by multiple ways in Decidim:
 
 == Webpacker
 

data/docs/modules/customize/pages/logic.adoc

@@ -4,7 +4,7 @@ There are occasions you find yourself in a situation that you need to change Dec
 As an example, we will add a new validation rule to the Admin panel, where Admin cannot add projects with budgets more than half the total budget. Once we applied such limitation, admins should not be able to add a project with the cost of 5,001 euros to a budget with total of 10,000 euros.
 
 [#maximum-budget-rule]
-.Trying to create a project with the budget of €5,001 for a budget with the total amount of €10,000(My budget) reults in error(buttom-right error message)
+.Trying to create a project with the budget of €5,001 for a budget with the total amount of €10,000(My budget) results in error(bottom-right error message)
 
 image::maximum_budget.png[Maximum budget error]
 

data/docs/modules/customize/pages/social_shares.adoc

@@ -28,7 +28,7 @@ The format of this variable is as follows
 DECIDIM_SOCIAL_SHARE_SERVICES="Facebook, X"
 ----
 
-NOTE: Services names are case sensitive.
+NOTE: Services names are case-sensitive.
 
 == Default services
 
@@ -38,7 +38,7 @@ image::social-share-modal-default.png[Social share modal]
 
 == Custom services
 
-If you have the need, you can enable your own service. To do that, as an example for a ficticious social service called "Foo", you will need to follow these steps:
+If you have the need, you can enable your own service. To do that, as an example for a fictitious social service called "Foo", you will need to follow these steps:
 
 . Add the logo of your service to the images' pack at `app/packs/images/`. Following the example, it'd be "foo.svg"
 

data/docs/modules/customize/pages/styles.adoc

@@ -8,7 +8,7 @@ If you only want to change colors and anything more, the most easy and fast way
 
 image::organization-colors.png[Organization colors]
 
-This works for any Organization inside of a Muiltitenant.
+This works for any Organization inside of a Multitenant.
 
 == Head extra file
 
@@ -62,7 +62,7 @@ We use http://sass-lang.com/guide[SASS, with SCSS syntax] as CSS preprocessor.
 
 == Tailwind CSS
 
-Decidim uses Taiwind CSS as a CSS framework, which has a default configuration that is being handled by `tailwind.config.js` in the root of your project.
+Decidim uses Tailwind CSS as a CSS framework, which has a default configuration that is being handled by `tailwind.config.js` in the root of your project.
 
 Since this file is being managed by Decidim, it will be impossible to customize it.
 
@@ -81,6 +81,6 @@ If you want to override other layouts, you can do so by creating new files:
 
 == Accessibility
 
-To maintain accesibility level, if you add new colors use a http://webaim.org/resources/contrastchecker/[Color contrast checker] (WCAG AA is mandatory, WCAG AAA is recommended)
+To maintain accessibility level, if you add new colors use a http://webaim.org/resources/contrastchecker/[Color contrast checker] (WCAG AA is mandatory, WCAG AAA is recommended)
 
 For more information about accessibility, see the xref:develop:guide_accessibility.adoc[accessibility guide].

data/docs/modules/customize/pages/views.adoc

@@ -17,7 +17,7 @@ As an example, if I want to change the footer, you'd need to search for the file
 
 == Deface method
 
-You will need the https://github.com/spree/deface[`deface` gem] installed on your application, and follow their instructions on how to use the different overridign methods that they support.
+You will need the https://github.com/spree/deface[`deface` gem] installed on your application, and follow their instructions on how to use the different overriding methods that they support.
 
 As an example, if you want to change the footer, you can do so by creating the file `app/overrides/layouts/decidim/_main_footer/pre_footer.html.erb.deface` with these contents:
 

data/docs/modules/develop/pages/authorable.adoc

@@ -1,14 +1,14 @@
 = Authorship
 
-Regarging authorship of Decidim resources/entities, there are three concerns
+Regarding authorship of Decidim resources/entities, there are three concerns
 involved directly:
 
 * `Decidim::ActsAsAuthor`: which defines how an author should behave.
 * `Decidim::Authorable` and `Decidim::Coauthorable`: which define the behaviour around who authored a resource.
 
 But the presenters for the classes including `ActsAsAuthor` should also behave
-in a certain maneer. This has been resolved using the duck typing strategy
-(remember, if it quaks as as duck, then it is a duck). Thus, there is not any
+in a certain manner. This has been resolved using the duck typing strategy
+(remember, if it quacks as as duck, then it is a duck). Thus, there is not any
 interface declaring which are the methods to be implemented by the presenter
 of an author. Anyway one of the ``OfficialAuthorPresenter``s may be used as a
 reference.

data/docs/modules/develop/pages/backports.adoc

@@ -11,23 +11,24 @@ The process for making backports is the following:
 . Check in the git commit history what was the latest backports on the branch that you are working with. https://github.com/decidim/decidim/commits/release/0.27-stable[Example for v0.27]. Copy the number of the last PR backported.
 . Search in GitHub for the this PR in the list of merged PRs of the `type: fix`. https://github.com/decidim/decidim/pulls?page=1&q=is%3Apr+sort%3Aupdated-desc+label%3A%22type%3A+fix%22+is%3Amerged[Example URL].
 . Check the PRs merged just before and after this one. You need to find the last ones that were not backported already to start with the backport process. A fast way for checking this out is to open the PRs and see the mentions from the backports in the GitHub references.
-. Once you have the list of the PRs that you want to backport, you can start with the process by using the https://github.com/decidim/decidim/blob/develop/bin/backporter[backporter script]. This script mostly handles the branch creation, cherrypicking, labeling and pushing of the fix. For using it you will need to have a GitHub Personal Access Token.
+. Once you have the list of the PRs that you want to backport, you can start with the process by using the https://github.com/decidim/decidim-maintainers_toolbox[decidim-backporter script]. This script mostly handles the branch creation, cherrypicking, labeling and pushing of the fix. For using it you will need to have a GitHub Personal Access Token.
 
 This is an example on how this command is called:
 
 ```shell
-$ backporter --github-token=GITHUB_TOKEN --pull-request-id=10248 --version-number=0.27
+$ gem install UPDATE_WITH_YOUR_GEM_NAME_PRIOR_TO_RELEASE_TO_RUBYGEMS_ORG
+$ decidim-backporter --github-token=GITHUB_TOKEN --pull-request-id=10248 --version-number=0.27
 ```
 
 And this is the current full documentation for this script:
 
 ```shell
-$ ./bin/backporter --help
+$ decidim-backporter --help
 Usage:
-  backporter --github-token=GITHUB_TOKEN --pull-request-id=PULL_REQUEST_ID --version-number=VERSION_NUMBER
+  decidim-backporter --github-token=GITHUB_TOKEN --pull-request-id=PULL_REQUEST_ID --version-number=VERSION_NUMBER
 
 Options:
-  --github-token=GITHUB_TOKEN                                        # Required. Github Personal Access Token (PAT). It can be obtained from https://github.com/settings/tokens/new. You will need to create one with `public_repo` access.
+  --github-token=GITHUB_TOKEN                                        # Required. GitHub Personal Access Token (PAT). It can be obtained from https://github.com/settings/tokens/new. You will need to create one with `public_repo` access.
   --version-number=VERSION_NUMBER                                    # Required. The version number that you want to do the backport to. It must have the format MAJOR.MINOR.
   --pull-request-id=PULL_REQUEST_ID                                  # Required. The ID of the pull request that you want to make the backport from. It should have the "type: fix" label.
   [--exit-with-unstaged-changes], [--no-exit-with-unstaged-changes]  # Optional. Whether the script should exit with an error if there are unstaged changes in the current project.

data/docs/modules/develop/pages/c4_component.adoc

@@ -11,7 +11,7 @@ title System Component diagram for Decidim Applications (https://decidim.org)
 
 ContainerDb(rel_db, "Relational Database", "PostgreSQL 9.5.x", "Stores users, participatory processes, assemblies, initiatives, proposals, meetings, etc.")
 Container(filesystem, "File System", "Local or remote", "Stores uploads (images, documents, etc.)")
-Container(worker, "Worker", "Ruby on Rails 5.2", "ActiveJob queues for non syncronuos jobs. Works for open data requests, sending emails, etc.")
+Container(worker, "Worker", "Ruby on Rails 5.2", "ActiveJob queues for non synchronous jobs. Works for open data requests, sending emails, etc.")
 
 Container_Boundary(web_app, "Web Application") {
 
@@ -25,7 +25,7 @@ Container_Boundary(web_app, "Web Application") {
     Component(system, "System module", "Ruby On Rails Engine", "Multitenant configuration, mounted in /system. Can create and manage all the instances of an installation.")
     Component(verifications, "Verifications module", "Ruby On Rails Engine", " Offers several methods for allowing participants to get authorization to perform certain privileged actions.")
 
-    Component(assemblies, "Assemblies module", "Ruby On Rails Engine (Space)", "A permament Space, mounted in /assemblies.")
+    Component(assemblies, "Assemblies module", "Ruby On Rails Engine (Space)", "A permanent Space, mounted in /assemblies.")
     Component(conferences, "Conferences module", "Ruby On Rails Engine (Space)", "A temporal Space, mounted in /conferences.")
     Component(initiatives, "Initiatives module", "Ruby On Rails Engine (Space)", "A bottom-up Space, mounted in /initiatives. A participant can collect signatures to bring an issue to the organization.")
     Component(participatory_processes, "Participatory Processes module (Space)", "Ruby On Rails Engine", "A temporal Space, mounted in /processes.")
@@ -34,7 +34,6 @@ Container_Boundary(web_app, "Web Application") {
     Component(budgets, "Budgets module", "Ruby On Rails Engine", "Component. Adds a participatory budgets system to any participatory space.")
     Component(blogs, "Blogs module", "Ruby On Rails Engine", "Component. Makes possible to add posts ordered by publication time to spaces.")
     Component(debates, "Debates module", "Ruby On Rails Engine", "Component. Adds a CRUD engine to the admin and public view scoped inside the participatory process.")
-    Component(elections, "Elections module", "Ruby On Rails Engine", "Components. Adds voting with cryptographic capabilities.")
     Component(meetings, "Meetings module", "Ruby On Rails Engine", "Component. Adds a CRUD engine to the admin and public view scoped inside the participatory process.")
     Component(pages, "Pages module", "Ruby On Rails Engine", "Component. adds static page capabilities to any participatory space. It basically provides an interface to include arbitrary HTML content to any step.")
     Component(proposals, "Proposals module", "Ruby On Rails Engine", "Component. Adds one of the main components of Decidim: allows users to contribute to a participatory space by creating proposals.")
@@ -43,7 +42,6 @@ Container_Boundary(web_app, "Web Application") {
 
     Rel(surveys, forms, "Consumes")
     Rel(meetings, forms, "Consumes")
-    Rel_Back(forms, elections, "Consumes")
 
     ' Rel(proposals, assemblies, "Mounts in")
     ' Rel(proposals, participatory_processes, "Mounts in")
@@ -67,17 +65,14 @@ Container_Boundary(web_app, "Web Application") {
     ' Rel(debates, admin, "Managed in")
     ' Rel(proposals, admin, "Managed in")
     ' Rel(blogs, admin, "Managed in")
-    ' Rel(elections, admin, "Managed in")
 
 }
 
-System_Ext(decidim_bulletin_board_system, "Decidim Bulletin Board", "Allows participants to cast end-to-end verifiable secret votes.")
 System_Ext(mail_system, "SMTP system (e-mail)", "Sends mails to users, like confirmations, reminders, notifications, etc.")
 System_Ext(etherpad_system, "Etherpad-Lite system", "Optional. Allows real-time text edition in Meetings.")
 System_Ext(geocoding_system, "Geocoding system", "Optional. An Open Street Maps provider, allows geographical localization of Proposals and Meetings..")
 System_Ext(oauth_system, "OAUTH2 System", "Optional. Third party sign on systems. Could be Twitter, Facebook, Google or any other OAUTH2 providers.")
 
-Rel_Back_Neighbor(decidim_bulletin_board_system, elections, "Uses")
 Rel_Neighbor(worker, mail_system, "Sends e-mails", "SMTP")
 Rel(web_app, rel_db, "Uses")
 Rel(web_app, filesystem, "Uses")

data/docs/modules/develop/pages/c4_container.adoc

@@ -17,10 +17,9 @@ System_Boundary(decidim_system, "decidim"){
     Container(web_app, "Web Application", "Ruby on Rails 5.2", "Allows participants to make decisions collaboratively through participatory processes, assemblies, initiatives, etc.")
     ContainerDb(rel_db, "Relational Database", "PostgreSQL 9.5.x", "Stores users, participatory processes, assemblies, initiatives, proposals, meetings, etc.")
     Container(filesystem, "File System", "Local or remote", "Stores uploads (images, documents, etc.)")
-    Container(worker, "Worker", "Ruby on Rails 5.2", "ActiveJob queues for non syncronuos jobs. Works for open data requests, sending emails, etc.")
+    Container(worker, "Worker", "Ruby on Rails 5.2", "ActiveJob queues for non synchronous jobs. Works for open data requests, sending emails, etc.")
 }
 
-System_Ext(decidim_bulletin_board_system, "Decidim Bulletin Board", "Allows participants to cast end-to-end verifiable secret votes.")
 System_Ext(mail_system, "SMTP system (e-mail)", "Sends mails to users, like confirmations, reminders, notifications, etc.")
 System_Ext(etherpad_system, "Etherpad-Lite system", "Optional. Allows real-time text edition in Meetings.")
 System_Ext(geocoding_system, "Geocoding system", "Optional. An Open Street Maps provider, allows geographical localization of Proposals and Meetings..")
@@ -31,7 +30,6 @@ Rel(participant_user, web_app, "Uses")
 Rel(administration_user, web_app, "Uses")
 Rel_Back(participant_user, mail_system, "Sends e-mails to")
 Rel_Back(administration_user, mail_system, "Sends e-mails to")
-Rel_Back_Neighbor(decidim_bulletin_board_system, web_app, "Uses")
 Rel_Neighbor(worker, mail_system, "Sends e-mails", "SMTP")
 Rel(web_app, rel_db, "Uses")
 Rel(web_app, filesystem, "Uses")