decidim 0.30.1 → 0.31.0.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: da55189daf07ff8e4c7f22161de7eda167ca9bf263a1c4e5bfa93872c117dee1
-  data.tar.gz: 5700d25412756d9b7a50a5fb55f1814322657f52af0f6aa04f06464335a2234d
+  metadata.gz: e626a38640359192d2b88c81f738aaf4ec02b5361084ef3bf431ae74f784f317
+  data.tar.gz: 8fc55132e141625a45ca5dd645d6e9e8898aaf04e72e91cc473a9c03e98e6d9c
 SHA512:
-  metadata.gz: d980c6bac85cac3371978d4c98a0720efe0846d5bcbbc6be1618412eb38e0d9535be071871388e8d4712e4018ca46d05d1e8663c110ec509defc4dc96c558360
-  data.tar.gz: c50ff6e463d8a80e3d2963ea853cfa94e21cebd5c0d6a51a24d6b4576f6dec4980b46649d6fd4ca706ef52e5d3a51d4f51c005903fc4bbe97c60c37d85483b20
+  metadata.gz: 7b94c2f85ba2246ace8097fe3c8fb7b3fbde7561778b8777e531d4a74e8318b3e2f3a17d4f299aebc48faa66ed1451347ce5d73732f9d10f99302a3e94e54bc1
+  data.tar.gz: 59ff6b0ec857c76df2039e9eceda04af5c3718b7b1b76b702b97915e4ec6856a5e2367864e6eb294aa14cb280ec0e9937bd86cffd875da8f8479a644e48dea98

data/Rakefile

@@ -65,11 +65,7 @@ end
 desc "Pushes a new build for each gem and package."
 task release_all: [:ensure_git_remote, :fetch_git_tags, :update_versions, :fetch_git_tags, :check_uncommitted_changes, :check_locale_completeness] do
   commands = {}
-  Decidim::GemManager.all_dirs do |dir|
-    next if dir.include?("decidim-admin")
-    next if dir.include?("decidim-accountability")
-    commands[dir] = "rake release[#{Decidim::ReleaseManager.git_remote}]"
-  end
+  Decidim::GemManager.all_dirs { |dir| commands[dir] = "rake release[#{Decidim::ReleaseManager.git_remote}]" }
   Decidim::GemManager.package_dirs { |dir| commands[dir] = "npm publish --access public" }
 
   commands.each do |dir, command|
@@ -94,10 +90,10 @@ end
 
 desc "Makes sure there are no uncommitted changes."
 task :check_uncommitted_changes do
-  # unless system("git diff --exit-code --quiet")
-  #   puts "There are uncommitted changes, run `git diff` to see them."
-  #   abort "Please commit your changes before release!"
-  # end
+  unless system("git diff --exit-code --quiet")
+    puts "There are uncommitted changes, run `git diff` to see them."
+    abort "Please commit your changes before release!"
+  end
 end
 
 desc "Makes sure all official locales are complete and clean."

data/decidim-core/lib/decidim/{webpacker → shakapacker}/configuration.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Decidim
-  module Webpacker
+  module Shakapacker
     class Configuration
       attr_reader :additional_paths, :entrypoints, :stylesheet_imports
 
@@ -12,7 +12,7 @@ module Decidim
       end
 
       def configuration_file
-        # Before webpacker is installed, the original configuration file may not
+        # Before shakapacker is installed, the original configuration file may not
         # be available yet.
         return unless File.exist?(original_configuration_file_path)
         return configuration_file_path if configurations_loaded?
@@ -58,13 +58,13 @@ module Decidim
           if defined?(Rails)
             Rails.application.root
           else
-            # This is used when Rails is not available from the webpacker binstubs
+            # This is used when Rails is not available from the shakapacker binstubs
             File.expand_path(".", Dir.pwd)
           end
       end
 
       def configuration_file_path
-        @configuration_file_path ||= File.join(app_path, "tmp/webpacker_runtime.yml")
+        @configuration_file_path ||= File.join(app_path, "tmp/shakapacker_runtime.yml")
       end
 
       def original_configuration_file_path

data/decidim-core/lib/decidim/{webpacker → shakapacker}/runner.rb

@@ -1,15 +1,15 @@
 # frozen_string_literal: true
 
 module Decidim
-  module Webpacker
+  module Shakapacker
     module Runner
       def self.included(base)
         base.alias_method :original_initialize, :initialize
         base.send :private, :original_initialize
 
         base.define_method :initialize do |argv|
-          original_initialize(argv)
           decidim_initialize(argv)
+          original_initialize(argv)
         end
       end
 
@@ -22,7 +22,7 @@ module Decidim
         Decidim::Assets::Tailwind.write_runtime_configuration
 
         # Write the runtime configuration and override the configuration
-        @shakapacker_config = Decidim::Webpacker.configuration.configuration_file
+        ENV["SHAKAPACKER_CONFIG"] = Decidim::Shakapacker.configuration.configuration_file
       end
     end
   end

data/decidim-core/lib/decidim/shakapacker/shakapacker.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "shakapacker"
+require "shakapacker/runner"
+require "decidim/shakapacker"
+require "decidim/webpacker"
+
+Shakapacker::Runner.include(Decidim::Shakapacker::Runner)

data/decidim-core/lib/decidim/{webpacker → shakapacker}/shakapacker.yml

@@ -1,5 +1,5 @@
 # File written by Decidim generator
-# Note: You must restart bin/webpack-dev-server for changes to take effect
+# Note: You must restart bin/shakapacker-dev-server for changes to take effect
 
 default: &default
   source_path: app/packs
@@ -62,6 +62,8 @@ development:
       #  port: 8080
     # Should we use gzip compression?
     compress: true
+    # Disable live reloading for faster development experience
+    live_reload: false
     # Note that apps that do not check the host are vulnerable to DNS rebinding attacks
     allowed_hosts: "all"
     pretty: true

data/decidim-core/lib/decidim/{webpacker → shakapacker}/webpack/custom.js

@@ -44,7 +44,7 @@ module.exports = {
           filename: "media/documents/[hash][ext][query]"
         }
       },
-      // Overwrite webpacker files rule to amend the filename output
+      // Overwrite shakapacker files rule to amend the filename output
       // and include the name of the file, otherwise some SVGs
       // are not generated because the hash is the same between them
       {

data/decidim.gemspec

@@ -38,7 +38,7 @@ Gem::Specification.new do |s|
                         package-lock.json
                         packages/
                         babel.config.json
-                        decidim-core/lib/decidim/webpacker/
+                        decidim-core/lib/decidim/shakapacker/
                       ))
     end
   end

data/docs/antora.yml

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

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

@@ -2,9 +2,9 @@
 
 We try to let most of the things defined through Environment Variables, as https://12factor.net/config[12factor applications's config]. You will need to configure through your hosting provider (for example in Heroku), through a gem like `figaro` or through docker-compose `env_file`.
 
-This is an extensive list of all the Env variables supported for an application created with the default `decidim` generator (ie: `decidim my-application`). Custom applications may modify or customize the default decidim initializer (`config/initializers/decidim.rb`) in such a a way that this will have no effect.
+This is an extensive list of all the Env variables supported for an application created with the default `decidim` generator (ie: `decidim my-application`). Custom applications may implement a  decidim initializer (`config/initializers/decidim.rb`) in such a way that this will have no effect.
 
-Finally, take into account that there are some config variables not available as Env vars, this is because it is not enough to set them in order to make that particular feature to work, it requires the user to add some custom code (usually a service class that acts a wrapper for an external API). These are the case for initializers such as `sms_gateway_service`, `timestamp_service`, `pdf_signature_service` or `machine_translation_service`. For more information about these extra services check the xref:configure:initializer.adoc[Initializer documentation].
+Finally, take into account that there are some config variables not available to Environment. This is because it is not enough to set them in order to make that particular feature to work, it requires the user to add some custom code (like a local generator). For more information about these extra services check the xref:configure:initializer.adoc[Initializer documentation].
 
 The next tables show all the default Env Vars available when running a default Decidim application (note that customized Decidim apps might differ). The ones marked in *bold* are the minimal required to run a production server. The ones marked as _italic_ are only required for development.
 
@@ -425,6 +425,12 @@ Also some more refined configurations:
 |auto
 |No
 
+| DECIDIM_PAGE_BLOCKS
+| Sets the list of static pages' slugs that can include content blocks.
+By default is only enabled in the terms-of-service static page to allow a summary to be added and include sections with a two-pane view
+| terms-of-service
+| no
+
 |DECIDIM_ENABLE_HTML_HEADER_SNIPPETS
 |Set to `true` in order to allow administrators to define an arbitrary custom HTML code in the `<head></head>` section any Decidim page.
 
@@ -518,6 +524,11 @@ You may specify multiple ip in an array, separating by commas, such as `1.2.3.4,
 |
 |No
 
+|DECIDIM_SYSTEM_API_USERS_SECRET_LENGTH
+|The length of API secrets generated for API users.
+|32
+|No
+
 |DECIDIM_BASE_UPLOADS_PATH
 |A base path for the uploads. If set, make sure it ends in a slash.
 Uploads will be set to `<base_path>/uploads/`. This can be useful if you
@@ -603,6 +614,15 @@ Additional context: This has been revealed as an issue during a security audit o
 |false
 |No
 
+|DECIDIM_CONTENT_PROCESSORS
+|Exposes a configuration option: an array of symbols representing processors that will be automatically executed when a content is parsed or rendered.
+
+A content processor is a concept to refer to a set of two classes:
+- the content parser class
+- the content renderer class.
+| ""
+| No
+
 |DECIDIM_ADMIN_PASSWORD_STRONG
 |Enable strong password rules for admin users.
 |true
@@ -623,6 +643,26 @@ Additional context: This has been revealed as an issue during a security audit o
 |15
 |No
 
+| DECIDIM_DELETE_INACTIVE_USERS_AFTER_DAYS
+| Defines after how many days inactive users should be deleted.
+| 365
+| No
+
+| DECIDIM_MINIMUM_INACTIVITY_PERIOD_IN_DAYS
+| Minimum allowed inactivity period before a user can be considered inactive.
+| 30
+| No
+
+| DECIDIM_DELETE_INACTIVE_USERS_FIRST_WARNING_DAYS_BEFORE
+| Number of days before deletion when the first warning notification is sent.
+| 30
+| No
+
+| DECIDIM_DELETE_INACTIVE_USERS_LAST_WARNING_DAYS_BEFORE
+| Number of days before deletion when the last warning notification is sent.
+| 7
+| 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 aggressive cache configuration might cause some issues when submitting forms.
 |false
@@ -633,26 +673,57 @@ Additional context: This has been revealed as an issue during a security audit o
 |true
 |No
 
-|*DECIDIM_SPAM_DETECTION_BACKEND_USER*
-| The adapter type needed for user classifier. (for CI purposes, you can set "memory")
-| redis
+|*DECIDIM_ENABLE_MACHINE_TRANSLATION*
+| Whether the Decidim attempt to automatically translate missing translations.
+Read more about this at xref:services:machine_translation.adoc[Machine Translation] service page.
+| false
 | No
 
-|*DECIDIM_SPAM_DETECTION_BACKEND_USER_REDIS_URL*
-| The redis connection url used by the user classifier
-| redis://localhost:6379/3
+|*DECIDIM_MACHINE_TRANSLATION_SERVICE*
+| The name of the class to translate user content.
+Read more about this at xref:services:machine_translation.adoc[Machine Translation] service page.
+| nil
 | No
 
-|*DECIDIM_SPAM_DETECTION_BACKEND_RESOURCE*
-| The adapter type needed for resource classifier. (for CI purposes, you can set "memory")
-| redis
+
+|*DECIDIM_SMS_GATEWAY_SERVICE*
+| The name of the class to deliver SMS codes to users.
+Read more about this at xref:services:sms.adoc[SMS] service page.
+| nil
 | No
 
-|*DECIDIM_SPAM_DETECTION_BACKEND_RESOURCE_REDIS_URL*
-| The redis connection url used by the resource classifier
-| redis://localhost:6379/2
+|*DECIDIM_TIMESTAMP_SERVICE*
+| The name of the class used to generate a timestamp from a document.
+Read more about this at xref:services:timestamp.adoc[Timestamp] service page.
+| nil
+| No
+
+|*DECIDIM_PDF_SIGNATURE_SERVICE*
+| The name of the class used to process a pdf and add a signature to the document.
+Read more about this at xref:services:pdf.adoc[PDF signing] service page.
+| nil
+| No
+
+|*DECIDIM_USER_ROLES*
+| The list of roles a user can have, not considering the space-specific roles.
+| admin, user_manager
+| No
+
+|*DECIDIM_AMENDMENTS_VISIBILITY_OPTIONS*
+| The list of visibility options for amendments.
+| all, participants
 | No
 
+|*DECIDIM_DEFAULT_MAX_LAST_ACTIVITY_USERS*
+| The default max last activity users to be shown
+| 6
+| No
+
+|DECIDIM_OAUTH_ACCESS_TOKEN_EXPIRES_IN
+|OAuth access token expiration time in minutes.
+|120
+|No
+
 |===
 
 .Optional Env Vars fine tuning some Decidim modules (such the API or Proposal behaviors)
@@ -675,6 +746,26 @@ Additional context: This has been revealed as an issue during a security audit o
 |15
 |No
 
+|DECIDIM_API_JWT_SECRET
+|This secret is being used by the devise-jwt to sign the tokens being generated for the api users.
+|
+|Yes
+
+|DECIDIM_API_JWT_EXPIRES_IN
+|The expiration time of the JWT tokens in minutes, after which issued token will expire.
+|(value of DECIDIM_OAUTH_ACCESS_TOKEN_EXPIRES_IN)
+|No
+
+|DECIDIM_API_FORCE_API_AUTHENTICATION
+|Enable authentication for using api through setting Api configuration option. This is used to filter out unauthorized users from using api endpoint.
+|false
+|No
+
+| DECIDIM_API_DISCLOSE_SYSTEM_VERSION
+| This Environment variable instructs decidim whether to display or not the exact version of the application. By default, this is set to false to avoid explicit exposure of Decidim version.
+| false
+| No
+
 |PROPOSALS_PARTICIPATORY_SPACE_HIGHLIGHTED_PROPOSALS_LIMIT
 |Number of proposals to be shown in blocks with highlighted content across different participatory spaces.
 |4
@@ -690,30 +781,14 @@ Additional context: This has been revealed as an issue during a security audit o
 |2
 |No
 
-|MEETINGS_ENABLE_PROPOSAL_LINKING
-|If true, enables several relationships between meetings and proposals. By default is active if Proposals are active (which is true always at the moment).
-
-*We recommend not to tamper with this setting unless you know what are you doing*
-|auto
-|No
-
 |MEETINGS_EMBEDDABLE_SERVICES
 |A list (separated by spaces) of allowed services that can be embedded in a iframe when creating an online meeting.
 |www.youtube.com www.twitch.tv meet.jit.si
 |No
 
-|BUDGETS_ENABLE_PROPOSAL_LINKING
-|If true, enables several relationships between budgets and proposals. By default is active if Proposals are active (which is true always at the moment).
-
-*We recommend not to tamper with this setting unless you know what are you doing*
-|auto
-|No
-
-|ACCOUNTABILITY_ENABLE_PROPOSAL_LINKING
-|If true, enables several relationships between the accountability module and proposals. By default is active if Proposals are active (which is true always at the moment).
-
-*We recommend not to tamper with this setting unless you know what are you doing*
-|auto
+|MEETINGS_WAITING_LIST_ENABLED
+|If set to "false", disables the waiting list feature for meetings. Enabled by default.
+|true
 |No
 
 |INITIATIVES_CREATION_ENABLED
@@ -781,9 +856,79 @@ After this time the initiative will be moved to discarded state.
 |false
 |No
 
+|INITIATIVES_SIGNATURE_HANDLER_ENCRYPTION_SECRET
+|Secret used by the base class Decidim::Initiatives::SignatureHandler to encrypt the user personal data that will be stored in the initiatives votes.
+|personal user metadata
+|No
+
+|*DECIDIM_SPAM_REPORTING_USER*
+| This is the email address used by the spam engine to properly identify the user that will report users and content
+| decidim-reporting-user@example.org
+| No
+
+|*DECIDIM_SPAM_DETECTION_RESOURCE_SCORE_THRESHOLD*
+| This is the threshold used to report resources. If the score falls under this value, the resource will not be reported.
+| 0.75
+| No
+
+|*DECIDIM_SPAM_DETECTION_USER_SCORE_THRESHOLD*
+| This is the threshold used to report users. If the score falls under this value, the user will not be reported.
+| 0.75
+| No
+
+|*DECIDIM_SPAM_DETECTION_DELAY_IN_SECONDS*
+| You can configure the spam delay for the spam detection service. It is recommended not to set it to 0, as the request may not finished (ex: resources could not yet exist in Database)
+| 30
+| No
+
+|*DECIDIM_SPAM_DETECTION_BACKEND_USER*
+| The adapter type needed for user classifier. (for CI purposes, you can set "memory")
+| redis
+| No
+
+|*DECIDIM_SPAM_DETECTION_BACKEND_USER_REDIS_URL*
+| The redis connection url used by the user classifier
+| redis://localhost:6379/3
+| No
+
+|*DECIDIM_SPAM_DETECTION_BACKEND_RESOURCE*
+| The adapter type needed for resource classifier. (for CI purposes, you can set "memory")
+| redis
+| No
+
+|*DECIDIM_SPAM_DETECTION_BACKEND_RESOURCE_REDIS_URL*
+| The redis connection url used by the resource classifier
+| redis://localhost:6379/2
+| No
+
+|*DECIDIM_SPAM_DETECTION_RESOURCE_SERVICE*
+| Spam detection service class.
+| Decidim::Ai::SpamDetection::Service
+| No
+
+|*DECIDIM_SPAM_DETECTION_USER_SERVICE*
+| Spam detection service class.
+| Decidim::Ai::SpamDetection::Service
+| No
+
+|*DECIDIM_AI_LANGUAGE_FORMATTER*
+| Text cleanup service
+| Decidim::Ai::Language::Formatter
+| No
+
+|*DECIDIM_SPAM_HIDE_REPORTED_RESOURCES_AUTOMATICALLY*
+| When the engine is consistently marking spam content without errors, you can skip human intervention by enabling this functionality
+| false
+| No
+
+|*VERIFICATIONS_DOCUMENT_TYPES*
+| For the verification of the participants' data in Verifications, you can configure which type of documents a participant can have. By default these documents are `identification_number` and `passport`
+| identification_number,passport
+| No
+
 |===
 
-.Optional Env Vars for extra Rails configuration
+.Optional Env Vars for extra configuration
 [%autowidth.stretch]
 |===
 |Name |Value |Default value|Multitenant's System configurable
@@ -827,7 +972,11 @@ Note that this only applies to production environments.
 |5
 |No
 
+|SLOW_SEEDS
+|If seeding an environment that needs to have more data, please use `SLOW_SEEDS` environment variable to add it.
+|false
+|No
+
 |===
 
 Please take care that all these configurations would be the defaults but *some of these could also be changed on a Multitenant's System configuration* (for instance SMTP or OAUTH providers).
-

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

@@ -45,12 +45,11 @@ Then make use of the related xref:configure:environment_variables.adoc[Environme
 Just as a reminder, these files are important:
 
 * config/database.yml
-* config/secrets.yml
 
 Although most of these settings you can change them through xref:configure:environment_variables.adoc[Environment Variables].
 
 You also have more settings in:
 
 * xref:configure:initializer.adoc[Decidim initializer file].
-* System panel.
-
+* xref:configure:environment_variables.adoc[Environment variables].
+* xref:configure:system.adoc[System panel].

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

@@ -1,15 +1,23 @@
 = Initializer
 
-There are some settings that you will need to change in the `config/initializer/decidim.rb` file. We recommend that, whenever it is possible, you use xref:configure:environment_variables.adoc[Environment Variables], as just cleaner and easier to work with.
+Decidim relies heavily on the xref:configure:environment_variables.adoc[environment variables], and we strongly recommend to use them, however, when the xref:configure:environment_variables.adoc[environment variables] are not enough, you can use a plain Rails initializer. Starting with Decidim `0.31.0` we will not generate this file, but, if you really need it, you can create in your application a file named `config/initializer/decidim.rb`.
 
-If you need to add special logic or if you feel more comfortable working with Ruby code instead of Environment Variables, then you can of course do all the changes that you need directly in the initializer file. Take into account that this file could be published in a Version Control System (like `git`) so you should be careful with the secrets/API keys that you add here.
+If you need to add special logic or if you feel more comfortable working with Ruby code instead of xref:configure:environment_variables.adoc[Environment Variables], then you can do all the changes that you need directly in the initializer file. Take into account that this file could be published in a Version Control System (like `git`) so you should be careful with the secrets/API keys that you add here.
 
 Remember to restart your server when making changes in this file.
 
-This is where you can change the behaviour defined on the different components (most notably from `decidim-core`).
-
 After making changes to this file you will need to also restart your application server.
 
+== File format
+
+[source,ruby]
+....
+# config/initializer/decidim.rb
+Decidim.configure do |config|
+  # here you can add any key config from below.
+end
+....
+
 == Application name
 
 The name of the application.
@@ -107,7 +115,7 @@ Allows to make geographical mapping in some components, like Proposals or Meetin
 ....
   config.geocoder = {
     static_map_url: "https://image.maps.hereapi.com/mia/v3/base/mc/overlay",
-    here_api_key: Rails.application.secrets.geocoder[:here_api_key]
+    here_api_key: ENV["MAPS_API_KEY"]
   }
 ....
 
@@ -154,7 +162,7 @@ Mind that this depends on your environment, for instance you could also need to
 
 [source,ruby]
 ....
-  config.maximum_attachment_size = 10.megabytes
+  config.maximum_attachment_size = 10
 ....
 
 === User avatar file size
@@ -165,7 +173,7 @@ Mind that this depends on your environment, for instance you could also need to
 
 [source,ruby]
 ....
-  config.maximum_avatar_size = 10.megabytes
+  config.maximum_avatar_size = 10
 ....
 
 == Reports
@@ -281,11 +289,11 @@ class MySMSGatewayService
 end
 ....
 
-Then you will need to configure it in the Decidim initializer:
+Then you will need to configure it with the help of Environment Variables:
 
-[source,ruby]
+[source,bash]
 ....
-  config.sms_gateway_service = "MySMSGatewayService"
+export DECIDIM_SMS_GATEWAY_SERVICE="MySMSGatewayService"
 ....
 
 == Timestamp service configuration
@@ -313,11 +321,11 @@ class MyTimestampService
 end
 ....
 
-Then you will need to configure it in the Decidim initializer:
+Then you will need to configure it with the help of Environment Variables:
 
-[source,ruby]
+[source,bash]
 ....
-  config.timestamp_service = "MyTimestampService"
+export DECIDIM_TIMESTAMP_SERVICE="MyTimestampService"
 ....
 
 == PDF signature service
@@ -344,8 +352,13 @@ An example class would be something like:
       # Code to return the pdf signed
     end
   end
+....
+
+Then you will need to configure it with the help of Environment Variables:
 
-  config.pdf_signature_service = "MyPDFSignatureService"
+[source,bash]
+....
+export DECIDIM_PDF_SIGNATURE_SERVICE="PdfSignatureExample"
 ....
 
 ==  Etherpad configuration
@@ -357,9 +370,9 @@ xref:services:etherpad.adoc[Etherpad's Decidim docs] in order to set it up.
 [source,ruby]
 ....
   config.etherpad = {
-    server: Rails.application.secrets.etherpad[:server],
-    api_key: Rails.application.secrets.etherpad[:api_key],
-    api_version: Rails.application.secrets.etherpad[:api_version]
+    server: ENV["ETHERPAD_SERVER"],
+    api_key: ENV["ETHERPAD_API_KEY"],
+    api_version: Decidim::Env.new("ETHERPAD_API_VERSION", "1.2.1")
   }
 ....
 
@@ -367,29 +380,30 @@ xref:services:etherpad.adoc[Etherpad's Decidim docs] in order to set it up.
 
 To enable machine translations you need to enable the service and specify the class used for translation (this usually is the one contacting an external API from a 3d party service that actually translates the string).
 
-[source,ruby]
+[source,bash]
 ....
-  config.enable_machine_translations = false
-  config.machine_translation_service = "MyTranslationService"
+export DECIDIM_ENABLE_MACHINE_TRANSLATION="true"
+export DECIDIM_MACHINE_TRANSLATION_SERVICE="MyTranslationService"
 ....
-
 An example class would be something like:
 
 [source,ruby]
 ....
-  class MyTranslationService
-    attr_reader :text, :original_locale, :target_locale
+class MyTranslationService
+  attr_reader :text, :source_locale, :target_locale, :resource, :field_name
 
-    def initialize(text, original_locale, target_locale)
-      @text = text
-      @original_locale = original_locale
-      @target_locale = target_locale
-    end
+  def initialize(resource, field_name, text, target_locale, source_locale)
+    @resource = resource
+    @field_name = field_name
+    @text = text
+    @target_locale = target_locale
+    @source_locale = source_locale
+  end
 
-    def translate
-      Actual code to translate the text
-    end
+  def translate
+    # Actual code to translate the text
   end
+end
 ....
 
 See xref:develop:machine_translations.adoc[Machine Translations] for more information about how it works and how to set it up.

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

@@ -76,7 +76,7 @@ Enter each one of them in a new line. For instance, "example.com".
 |Required
 |You need to configure at least one language. Decidim is multilingual, meaning that you can have most of the admin
 contents with any number of languages. For seeing other languages you need to configure first the
-xref:configure:initializer.adoc[Decidim's initializer].
+xref:configure:environment_variables.adoc[Decidim's Environment Variables].
 
 |Force authentication
 |Optional
@@ -127,8 +127,8 @@ in multi tenant mode. To learn more, check this https://developer.mozilla.org/en
 ==== Allow participants to register and login
 
 Most of the installations use this setting. Means that everyone can register a participant account and login, without restrictions, only with an email account confirmation.
-You can disable that confirmation also if you want to through xref:configure:initializer.adoc[Decidim's initializer], although we do not recommend doing that,
-as it is a measure for stopping spam accounts.
+You can disable that confirmation also if you want to through xref:configure:environment_variables.adoc.adoc[Decidim's environment variables], although we do not recommend doing that,
+as it is a measure for stopping spam accounts. For additional details, read about `DECIDIM_UNCONFIRMED_ACCESS_FOR` environment variable.
 
 ==== Do not allow participants to register, but allow existing participants to login
 

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

@@ -12,8 +12,8 @@ For example, to add new filter to proposals index:
 ....
 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 is only enabled for evaluators of the space
+  if current_participatory_space.user_roles(:evaluator).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