From 951d76c59604ade2b12ae7749791f16b62f8195c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Tue, 25 Jul 2023 16:00:20 +0200 Subject: [PATCH 001/336] New translations index.adoc (Spanish) --- docs/es/modules/releases/pages/index.adoc | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/es/modules/releases/pages/index.adoc b/docs/es/modules/releases/pages/index.adoc index c9f9bc7423..b8433a43af 100644 --- a/docs/es/modules/releases/pages/index.adoc +++ b/docs/es/modules/releases/pages/index.adoc @@ -6,6 +6,8 @@ You can find all the releases (with minor and patches) at https://rubygems.org/gems/decidim/versions[RubyGems.org] and https://github.com/decidim/decidim/releases[GitHub]. +* https://decidim.org/blog/2022-09-30-new-version-0-27-0/[Version 0.27 (2022-09-30)] +* https://decidim.org/blog/2022-02-22-new-version-0-26-0/[Version 0.26 (2022-02-22)] * https://decidim.org/blog/2021-10-07-new-version-0-25-0/[Version 0.25 (2021-10-07)] ** xref:develop:guide_migrate_webpacker_module.adoc[Migrate to Webpacker a module] ** xref:develop:guide_migrate_webpacker_app.adoc[Migrate to Webpacker an instance app] From 274a2af664b83557b7f2638306568566ce7d30fa Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Tue, 25 Jul 2023 16:00:21 +0200 Subject: [PATCH 002/336] New translations index.adoc (Catalan) --- docs/ca/modules/releases/pages/index.adoc | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/ca/modules/releases/pages/index.adoc b/docs/ca/modules/releases/pages/index.adoc index c9f9bc7423..b8433a43af 100644 --- a/docs/ca/modules/releases/pages/index.adoc +++ b/docs/ca/modules/releases/pages/index.adoc @@ -6,6 +6,8 @@ You can find all the releases (with minor and patches) at https://rubygems.org/gems/decidim/versions[RubyGems.org] and https://github.com/decidim/decidim/releases[GitHub]. +* https://decidim.org/blog/2022-09-30-new-version-0-27-0/[Version 0.27 (2022-09-30)] +* https://decidim.org/blog/2022-02-22-new-version-0-26-0/[Version 0.26 (2022-02-22)] * https://decidim.org/blog/2021-10-07-new-version-0-25-0/[Version 0.25 (2021-10-07)] ** xref:develop:guide_migrate_webpacker_module.adoc[Migrate to Webpacker a module] ** xref:develop:guide_migrate_webpacker_app.adoc[Migrate to Webpacker an instance app] From d535dde760543247f6b333b7dfa7d8cdffad3d70 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Tue, 25 Jul 2023 16:00:22 +0200 Subject: [PATCH 003/336] New translations index.adoc (Portuguese, Brazilian) --- docs/pt/modules/releases/pages/index.adoc | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/pt/modules/releases/pages/index.adoc b/docs/pt/modules/releases/pages/index.adoc index c9f9bc7423..b8433a43af 100644 --- a/docs/pt/modules/releases/pages/index.adoc +++ b/docs/pt/modules/releases/pages/index.adoc @@ -6,6 +6,8 @@ You can find all the releases (with minor and patches) at https://rubygems.org/gems/decidim/versions[RubyGems.org] and https://github.com/decidim/decidim/releases[GitHub]. +* https://decidim.org/blog/2022-09-30-new-version-0-27-0/[Version 0.27 (2022-09-30)] +* https://decidim.org/blog/2022-02-22-new-version-0-26-0/[Version 0.26 (2022-02-22)] * https://decidim.org/blog/2021-10-07-new-version-0-25-0/[Version 0.25 (2021-10-07)] ** xref:develop:guide_migrate_webpacker_module.adoc[Migrate to Webpacker a module] ** xref:develop:guide_migrate_webpacker_app.adoc[Migrate to Webpacker an instance app] From d673bdbac503fe5f16bd692c1b361fc0f7ac364e Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:30 +0200 Subject: [PATCH 004/336] New translations nav.adoc (French) --- docs/fr/modules/ROOT/nav.adoc | 199 ++++++++++++++++++++++++++++++++++ 1 file changed, 199 insertions(+) create mode 100644 docs/fr/modules/ROOT/nav.adoc diff --git a/docs/fr/modules/ROOT/nav.adoc b/docs/fr/modules/ROOT/nav.adoc new file mode 100644 index 0000000000..76396bf14a --- /dev/null +++ b/docs/fr/modules/ROOT/nav.adoc @@ -0,0 +1,199 @@ +* xref:install:index.adoc[Getting started] +** xref:install:manual.adoc[Manual Installation] +** xref:install:checklist.adoc[Checklist] +** xref:install:update.adoc[Update] +* xref:configure:index.adoc[Configure] +** xref:configure:environment_variables.adoc[Environment Variables] +** xref:configure:initializer.adoc[Initializer] +*** xref:customize:authorizations.adoc[Authorizations] +*** xref:customize:code.adoc[Code] +*** xref:customize:gemfile.adoc[Gemfile] +*** xref:customize:images.adoc[Images] +*** xref:customize:javascript.adoc[Javascript] +*** xref:customize:menu.adoc[Menu] +*** xref:customize:oauth.adoc[OAuth] +*** xref:customize:styles.adoc[Styles] +*** xref:customize:texts.adoc[Texts] +*** xref:customize:users_registration_mode.adoc[User registration mode] +*** xref:customize:views.adoc[Views] +*** xref:services:activejob.adoc[Active Job] +*** xref:services:elections_bulletin_board.adoc[Elections Bulletin Board] +*** xref:services:etherpad.adoc[Etherpad] +*** xref:services:maps.adoc[Maps] +*** xref:services:smtp.adoc[SMTP] +*** xref:services:social_providers.adoc[Social Providers] +* Admin +** xref:admin:index.adoc[Introduction] +*** xref:admin:system.adoc[System panel] +*** xref:admin:dashboard.adoc[Dashboard] +** Settings +*** xref:admin:configuration.adoc[Configuration] +*** xref:admin:appearance.adoc[Appearance] +*** xref:admin:homepage.adoc[Homepage] +*** xref:admin:scopes.adoc[Scopes] +*** xref:admin:areas.adoc[Areas] +*** xref:admin:help_sections.adoc[Help sections] +** xref:admin:pages.adoc[Pages] +** xref:admin:participants.adoc[Participants] +*** xref:admin:participants/admins.adoc[Admins] +*** xref:admin:participants/groups.adoc[Groups] +*** xref:admin:participants/participants.adoc[Participants] +*** xref:admin:participants/impersonations.adoc[Impersonations] +**** xref:admin:participants/verifications_conflicts.adoc[Verifications conflicts] +*** xref:admin:participants/reported_users.adoc[Reported users] +*** xref:admin:participants/authorizations.adoc[Authorizations] +**** xref:admin:participants/authorizations/identity_documents.adoc[Identity documents] +**** xref:admin:participants/authorizations/code_postal_letter.adoc[Code by postal letter] +**** xref:admin:participants/authorizations/census.adoc[Organization's census] +** xref:admin:spaces.adoc[Spaces] +*** xref:admin:spaces/processes.adoc[Participatory Processes] +**** xref:admin:spaces/processes/phases.adoc[Phases] +**** xref:admin:spaces/processes/components.adoc[Components] +**** xref:admin:spaces/processes/categories.adoc[Categories] +**** xref:admin:spaces/processes/attachments.adoc[Attachments] +**** xref:admin:spaces/processes/admins.adoc[Process admins] +**** xref:admin:spaces/processes/private_participants.adoc[Private participants] +**** xref:admin:spaces/processes/moderations.adoc[Moderations] +**** xref:admin:spaces/processes/groups.adoc[Process Groups] +*** xref:admin:spaces/assemblies.adoc[Assemblies] +**** xref:admin:spaces/assemblies/components.adoc[Components] +**** xref:admin:spaces/assemblies/categories.adoc[Categories] +**** xref:admin:spaces/assemblies/attachments.adoc[Attachments] +**** xref:admin:spaces/assemblies/members.adoc[Members] +**** xref:admin:spaces/assemblies/admins.adoc[Assembly admins] +**** xref:admin:spaces/assemblies/private_participants.adoc[Private participants] +**** xref:admin:spaces/assemblies/moderations.adoc[Moderations] +*** xref:admin:spaces/initiatives.adoc[Initiatives] +*** xref:admin:spaces/conferences.adoc[Conferences] +**** xref:admin:spaces/conferences/components.adoc[Components] +**** xref:admin:spaces/conferences/categories.adoc[Categories] +**** xref:admin:spaces/conferences/attachments.adoc[Attachments] +**** xref:admin:spaces/conferences/media_links.adoc[Media Links] +**** xref:admin:spaces/conferences/partners.adoc[Partners] +**** xref:admin:spaces/conferences/speakers.adoc[Speakers] +**** xref:admin:spaces/conferences/registrations.adoc[Registrations] +***** xref:admin:spaces/conferences/registrations/types.adoc[Registration Types] +***** xref:admin:spaces/conferences/registrations/users.adoc[User Registrations] +***** xref:admin:spaces/conferences/registrations/invites.adoc[Invites] +***** xref:admin:spaces/conferences/registrations/certificates.adoc[Certificate of Attendance] +**** xref:admin:spaces/conferences/admins.adoc[Conference admins] +**** xref:admin:spaces/conferences/moderations.adoc[Moderations] +*** xref:admin:spaces/consultations.adoc[Consultations] +*** xref:admin:spaces/votings.adoc[Votings] +** xref:admin:components.adoc[Components] +*** xref:admin:components/blog.adoc[Blog] +*** xref:admin:components/budgets.adoc[Budgets] +*** xref:admin:components/debates.adoc[Debates] +*** xref:admin:components/elections.adoc[Elections] +*** xref:admin:components/meetings.adoc[Meetings] +**** xref:admin:components/meetings/registrations.adoc[Registrations] +**** xref:admin:components/meetings/agenda.adoc[Agenda] +**** xref:admin:components/meetings/polls.adoc[Polls] +**** xref:admin:components/meetings/close.adoc[Close] +*** xref:admin:components/pages.adoc[Pages] +*** xref:admin:components/proposals.adoc[Proposals] +**** xref:admin:components/proposals/amendments.adoc[Amendments] +**** xref:admin:components/proposals/answers.adoc[Answers] +**** xref:admin:components/proposals/collaborative_drafts.adoc[Collaborative drafts] +**** xref:admin:components/proposals/participatory_texts.adoc[Participatory texts] +*** xref:admin:components/surveys.adoc[Surveys] +** Features +*** xref:admin:features/badges.adoc[Badges] +*** xref:admin:features/comments.adoc[Comments] +*** xref:admin:features/conversations.adoc[Conversations] +*** xref:admin:features/embed.adoc[Embed] +*** xref:admin:features/endorsements.adoc[Endorsements] +*** xref:admin:features/fingerprint.adoc[Fingerprint] +*** xref:admin:features/follows.adoc[Follows] +*** xref:admin:features/metrics.adoc[Metrics] +*** xref:admin:features/my_account.adoc[My account] +**** xref:admin:features/my_account/account.adoc[Account] +**** xref:admin:features/my_account/notifications_settings.adoc[Notifications settings] +**** xref:admin:features/my_account/authorizations.adoc[Authorizations] +**** xref:admin:features/my_account/groups.adoc[Groups] +**** xref:admin:features/my_account/my_interests.adoc[My interests] +**** xref:admin:features/my_account/my_data.adoc[My data] +**** xref:admin:features/my_account/delete_my_account.adoc[Delete my account] +*** xref:admin:features/notifications.adoc[Notifications] +*** xref:admin:features/versions.adoc[Versions] +** xref:admin:newsletters.adoc[Newsletters] +** xref:admin:global_moderations.adoc[Global moderations] +** Deprecated +*** xref:admin:information-pages.adoc[Information pages] +* xref:contribute:index.adoc[Contribute] +** xref:contribute:governance.adoc[Governance] +** xref:contribute:translations.adoc[Translations] +** xref:contribute:documentation.adoc[Documentation] +* Develop +** xref:develop:guide.adoc[Guide] +*** xref:develop:guide_example_apps.adoc[1. Example Applications] +*** xref:develop:guide_development_app.adoc[2. Development App] +*** xref:develop:guide_commands.adoc[3. Commands] +*** xref:develop:guide_conventions.adoc[4. Conventions] +*** xref:develop:guide_architecture.adoc[5. Architecture] +** xref:develop:security.adoc[Security] +** Advanced +*** Concerns +**** xref:develop:authorable.adoc[Authorable] +**** xref:develop:embeddable.adoc[Embeddable] +**** xref:develop:endorsable.adoc[Endorsable] +**** xref:develop:followable.adoc[Followable] +**** xref:develop:reportable.adoc[Reportable] +**** xref:develop:traceable.adoc[Traceable] +**** xref:develop:machine_translations.adoc[TranslatableResource aka Machine Translations] +**** xref:develop:share_tokens.adoc[Shareable with Tokens] +*** xref:develop:api.adoc[API] +*** xref:develop:components.adoc[Components] +*** xref:develop:content_processors.adoc[Content Processors] +*** xref:develop:custom_seed_data.adoc[Custom Seed Data] +*** xref:develop:deploy.adoc[Deploy] +*** xref:develop:docker.adoc[Docker] +*** xref:develop:fixing_locales.adoc[Fixing locales] +*** xref:develop:guide_github_projects.adoc[GitHub Projects Workflow] +*** xref:develop:maps.adoc[Maps] +*** xref:develop:managing_translations_i18n.adoc[i18n] +*** xref:develop:metrics.adoc[Metrics] +*** xref:develop:modules.adoc[Modules] +*** xref:develop:notifications.adoc[Notifications] +*** xref:develop:open-data.adoc[Open Data] +*** xref:develop:permissions.adoc[Permissions] +*** xref:develop:profiling.adoc[Profiling] +*** xref:develop:releases.adoc[Releases] +*** xref:develop:templates.adoc[Templates] +*** xref:develop:testing.adoc[Testing] +*** xref:develop:guide_development_with_localhost_ssl.adoc[Testing SSL and Tenants in Development] +*** xref:develop:turbolinks.adoc[Turbolinks] +*** Views +**** xref:develop:content_blocks.adoc[Content Blocks] +**** xref:develop:data-picker.adoc[Data Picker] +**** xref:develop:newsletter_templates.adoc[Newsletter Templates] +**** xref:develop:view_hooks.adoc[View Hooks] +**** xref:develop:view_models_aka_cells.adoc[View Models (Cells)] +* Understand +** xref:understand:about.adoc[About] +** xref:understand:background.adoc[Background] +** xref:features:general-description.adoc[Features] +*** xref:features:participatory-spaces.adoc[Participatory spaces] +*** xref:features:components.adoc[Components] +*** xref:features:participants.adoc[Participants] +*** xref:features:general-features.adoc[General features] ++ +// ** xref:understand:governance.adoc[Project governance] + +// ** xref:understand:history.adoc[History of the project] + +// ** xref:understand:research.adoc[Research] + +** xref:understand:social-contract.adoc[Social Contract] +*** xref:understand:social-contract-ca.adoc[Català] +*** xref:understand:social-contract-es.adoc[Castellano] +** Publications +*** xref:publications:catalan.adoc[Catalan] +*** xref:publications:english.adoc[English] +*** xref:publications:french.adoc[French] +*** xref:publications:german.adoc[German] +*** xref:publications:italian.adoc[Italian] +*** xref:publications:spanish.adoc[Spanish] +** Whitepaper +*** xref:whitepaper:decidim-a-brief-overview.adoc[Decidim: a brief overview] +* xref:releases:index.adoc[Release Notes] \ No newline at end of file From 3b0a2a7ddc6dd4731b7c81ddc825e85e0e0ba67c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:31 +0200 Subject: [PATCH 005/336] New translations index.adoc (French) --- docs/fr/modules/ROOT/pages/index.adoc | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 docs/fr/modules/ROOT/pages/index.adoc diff --git a/docs/fr/modules/ROOT/pages/index.adoc b/docs/fr/modules/ROOT/pages/index.adoc new file mode 100644 index 0000000000..4e1fee14be --- /dev/null +++ b/docs/fr/modules/ROOT/pages/index.adoc @@ -0,0 +1,24 @@ += Welcome to Decidim Documentation + +This is the documentation site to Decidim, a participatory democracy platform created initially by Barcelona City Hall. + +Decidim is a framework that allows anybody to create and configure a website platform, to be used in the form of a political network for democratic participation. The platform allows any organization (local city council, association, university, NGO, neighbourhood or cooperative) to create mass processes for strategic planning, participatory budgeting, collaborative design for regulations, urban spaces and election processes. + +== New to Decidim? + +You’ve found the documentation for Decidim. Learn about the project at https://decidim.org[decidim.org]. + +[NOTE] +==== +This is the documentation for the `0.26` version. You can see this same documentation site for other versions: xref:v0.27@ROOT:index.adoc[v0.27] and xref:develop@ROOT:index.adoc[develop] +==== + +// * Read the xref:ROOT:getting-started.adoc[Getting Started guide] + +The documentation covers xref:install:index.adoc[installing], xref:configure:index.adoc[configuring], and xref:admin:index.adoc[running] your own Decidim site. + +If you want to make changes to the source code, we have documentation for xref:develop:guide.adoc[developers] too. + +If you are an organisation who wants to use Decidim, or a developer who is interested in collaborating on the software, please https://decidim.org/contact[get in touch]. + +Decidim is a community effort, as such if you find any errors on these guides please let us know at hola [at] decidim [dot] org. Every help is welcome. If you've a GitHub user then you can even propose changes to this website with the Edit link on every page. \ No newline at end of file From 04dd82fd5d75263a9dd2f156d1acd3180f9ea98f Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:33 +0200 Subject: [PATCH 006/336] New translations appearance.adoc (French) --- docs/fr/modules/admin/pages/appearance.adoc | 78 +++++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 docs/fr/modules/admin/pages/appearance.adoc diff --git a/docs/fr/modules/admin/pages/appearance.adoc b/docs/fr/modules/admin/pages/appearance.adoc new file mode 100644 index 0000000000..3b42c76416 --- /dev/null +++ b/docs/fr/modules/admin/pages/appearance.adoc @@ -0,0 +1,78 @@ += Appearance + +In this page you can configure the look and feel of your Decidim instance. + +Please mind that this would be incompatible with some of the changes that your implementers could change in your general installation. For instance if there were changes in the xref:customize:styles.adoc[Styles] this could not work. + +image::admin_appearance.png[Decidim Admin Appearance] + +--- + +NOTE: This is a legacy setting that will be removed in the next version. https://github.com/decidim/decidim/pull/6575[See PR]. + +* **Show statistics**: whether you want to show or not the statistics sections in the homepage. + +--- + +* **Description**: What's the description of this site. Used for metatags for Google and Twitter embeds. Also used by the "SubHero" ContentBlock in the Homepage. + +--- + +NOTE: These area legacy settings that will be removed in the next version. https://github.com/decidim/decidim/pull/6284[See PR]. + +* **Call To Action button path**: You can overwrite where the Call To Action button in the homepage links to. Use partial paths, not full URLs here. Accepts letters, numbers, dashes and slashes, and must start with a letter. The Call To Action button is shown in the homepage between the welcome text and the description. Example: https://meta.decidim.org/conferences/decidimfest2020/ +* **Call To Action button text**: You can overwrite the Call To Action button text in the homepage for each available language in your organization. If not set, the default value will be used. The Call To Action button is shown in the homepage between the welcome text and the description. + +--- + +NOTE: This is a legacy setting that will be removed in the next version. There's no PR yet. + +* **Highligted content banner** +** *Show the highlighted content banner* +** *Title* +** *Short description* +** *Action button title* +** *Action button subtitle* +** *Action button URL* +** *Image* + +--- + +* *Edit omnipresent banner* +** **Show omnipresent banner** +** **Title** +** **Short description** +** **URL** + +--- + +* **Edit layout appearance** + +This subsection defines the images for the layout that will be visible in almost all the pages. These are: + +** Icon +** Logo +** Official logo header +** Official logo footer +** Official organization URL + +// TODO: Add examples + +--- + +* **Organization colors**: What are the colors for your organization. Please notice that this could generate accessibility problems, for instance with people that doesn't have a good contrast notion. You can set +** Primary +** Secondary +** Success +** Warning +** Alert +** Highlight +** Highlight, alternative + +// TODO: Add examples + +--- + +* **Header snippets**: Use this field to add things to the HTML head. The most common use is to integrate third-party services that require some extra JavaScript or CSS. Also, you can use it to add extra meta tags to the HTML. Note that this will only be rendered in public pages, not in the admin section. + +// TODO: reference to HTML snippet setting \ No newline at end of file From 3f80c0ae820467503f5bcca2cf70e335ad3ea08f Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:34 +0200 Subject: [PATCH 007/336] New translations areas.adoc (French) --- docs/fr/modules/admin/pages/areas.adoc | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 docs/fr/modules/admin/pages/areas.adoc diff --git a/docs/fr/modules/admin/pages/areas.adoc b/docs/fr/modules/admin/pages/areas.adoc new file mode 100644 index 0000000000..b25b26c414 --- /dev/null +++ b/docs/fr/modules/admin/pages/areas.adoc @@ -0,0 +1,11 @@ += Areas + +include::partial$deprecated.adoc[] + +Areas are all the sectors that an Organization can have. + +They are pretty similar to xref:admin:scopes.adoc[scopes], meaning that they are a way of allowing a better navigation and filtering in the spaces and components. + +We don't recommend using them, as probably in the future they will be removed. + +You can read more information about the history of Areas in this https://github.com/decidim/decidim/issues/3540#issuecomment-427324532[GitHub comment]. \ No newline at end of file From f60630e7a82fdec7c43b5677e15f975e31603556 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:35 +0200 Subject: [PATCH 008/336] New translations components.adoc (French) --- docs/fr/modules/admin/pages/components.adoc | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 docs/fr/modules/admin/pages/components.adoc diff --git a/docs/fr/modules/admin/pages/components.adoc b/docs/fr/modules/admin/pages/components.adoc new file mode 100644 index 0000000000..602089c849 --- /dev/null +++ b/docs/fr/modules/admin/pages/components.adoc @@ -0,0 +1,5 @@ += Components + +Through components an administrator can enable and configure different participatory mechanisms. + +include::partial$components_list.adoc[] \ No newline at end of file From 9902d5b3d9752d34935174b4dbafce456356a021 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:36 +0200 Subject: [PATCH 009/336] New translations blog.adoc (French) --- .../modules/admin/pages/components/blog.adoc | 145 ++++++++++++++++++ 1 file changed, 145 insertions(+) create mode 100644 docs/fr/modules/admin/pages/components/blog.adoc diff --git a/docs/fr/modules/admin/pages/components/blog.adoc b/docs/fr/modules/admin/pages/components/blog.adoc new file mode 100644 index 0000000000..78febc841b --- /dev/null +++ b/docs/fr/modules/admin/pages/components/blog.adoc @@ -0,0 +1,145 @@ += Blog + +The Blog component allows people to read multiple posts ordered by date. + +Some examples of where this component was used: + +* https://meta.decidim.org/processes/roadmap/f/247/[News in Propose new functionalities for Decidim software] in https://meta.decidim.org[Metadecidim] + +image:components/blog/example01.png[Example of blog posts list] +image:components/blog/example02.png[Example of a blog post] + +To configure the Blog component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies" or "Conferences". +. Go to components +. Click on "Add component" button +. Click on "Blog" +. Fill the xref:_add_component[Add component] form + +== Add component + +image:components/blog/component.png[Add component form] + + +.Add component: Blog form +|=== +|Field |Type |Description + +|Name +|Required +|What is the title of this component. For instance, "Blogs" + +|Order position +|Optional +|Which order will it have in relation to the other blogs. Having a lower number means a higher priority. +For instance, if you have two blogs, "Blog a" with weight "10" and "Blog b" with weight "0", then "Blog b" will be first when ordering. +|=== + + +.Add component: Blog form - Global settings +|=== +|Field |Type |Description + +|Announcement +|Optional +|A general announcement that'll be visible on the general blogs landing page. + +|Comments enabled +|Optional +|Whether you want to have comments in the meetings. + +|Comments max length +|Optional +|What is the characters limit that participants will have when making comments. Leave 0 for default value. +|=== + +In the cases where the space that this component will be used has xref:admin:spaces/processes/phases.adoc[Phases], for instance, in +xref:admin:spaces/processes.adoc[Participatory Processes], then you can also define different behaviors per Step. + + +.Add component: Blogs form - Step settings +|=== +|Field |Type |Description + +|Announcement +|Optional +|A general announcement that'll be visible on the general blog landing page. + +|Comments blocked +|Optional +|Whether you want to enable comments creation for this phase. + +|Endorsements enabled +|Optional +|Whether you want to enable endorsements for this phase. + +|Endorsements blocked +|Optional +|Whether you want to disable adding new endorsements for this phase. +|=== + +== Permissions + +An administrator can choose which kind of xref:customize:authorizations.adoc[Authorizations] a participant need to have to make +certain actions in the blogs: + +* Comment +* Endorse + +== Manage posts + +image:components/blog/manage_posts.png[Manage posts table] + +=== New post form + +image:components/blog/new_post.png[New post form] + + +.New post form +|=== +|Field |Type |Description + +|Create post as +|Required +|Participant account or user group that will be the author of the post. + +|Title +|Required +|What is the title of this post. + +|Body +|Required +|What is the description of this post. +|=== + +==== Actions + + +.Actions +|=== +|Icon |Name |Definition + +|image:action_edit.png[Edit icon] +|Edit +|Edit form for this post. It's the same form as "New post". + +|image:action_folder.png[Folder icon] +|Folder +|For classifying Attachments. + +|image:action_attachments.png[Attachments icon] +|Attachments +|Documents that are related to the post. + +|image:action_permissions.png[Permissions icon] +|Permissions +|To handle the permissions of this post, depending on the verification a participant has. + +|image:action_delete.png[Delete icon] +|Delete +|To delete this post. +|=== \ No newline at end of file From 64546c0382ac239af75fa6a4975ee3e9e85e8b5d Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:39 +0200 Subject: [PATCH 010/336] New translations budgets.adoc (French) --- .../admin/pages/components/budgets.adoc | 357 ++++++++++++++++++ 1 file changed, 357 insertions(+) create mode 100644 docs/fr/modules/admin/pages/components/budgets.adoc diff --git a/docs/fr/modules/admin/pages/components/budgets.adoc b/docs/fr/modules/admin/pages/components/budgets.adoc new file mode 100644 index 0000000000..e2f4d81332 --- /dev/null +++ b/docs/fr/modules/admin/pages/components/budgets.adoc @@ -0,0 +1,357 @@ += Budgets + +:page-toclevels: 4 + +The Budgets component allows people to vote by selecting projects of their choosing. Depending on the needs and normative +of the organization, this could be configured so people have assigned a total budget (for instance, 100.000 EUR) and then +every project has assigned a value (for instance, 10.000 EUR). Then when people vote on projects, they have a progress bar +where they see how much remaining budget they have to allocate in this voting. + +From this starting point, there could be other configurations, such as: + +* A minimum percentage of budget to be allocated +* A minimum number of projects to be allocated +* Multiple budgets, one for each district or neighborhood + +Some examples of where this component was used: + +* https://www.decidim.barcelona/processes/PressupostosParticipatius[2020/2021 Participatory Budgeting Process in Decidim Barcelona]. +The city of Barcelona (Spain) has allocated a budget of 30.000.000 EUR so people can present, define, prioritize, vote +and choose which investment projects the city goverment should execute. +* https://ecrivons.angers.fr/processes/BP2021[2021 Participatory Budgeting Process in Angers]. The city of Angers (France) has allocated +a budget of 1.000.000 EUR so people from 11 years can propose maximum of 3 ideas and then vote for their 5 favorite projects. +* https://omastadi.hel.fi/[2021 Participatory Budgeting Process in Helsinki]. Helsinki has allocated 8.8 million euros to realising +residents’ wishes. The ideas are developed together into proposals that Helsinki residents can vote on. The proposals with the +most votes are realised by the City. + +image:components/budgets/example01.png[Budgets example voting] +image:components/budgets/example02.png[Budgets example error messagge when exceding the amount of budget] +image:components/budgets/example03.png[Budgets vote confirmation] +image:components/budgets/example04.png[Budgets after voting] + +To configure the Budgets component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies" or "Conferences". +. Go to components +. Click on "Add component" button +. Click on "Budgets" +. Fill the xref:_add_component[Add component] form + +== Add component + +image:components/budgets/component.png[Add component form] + + +.Add component: Budgets form +|=== +|Field |Type |Description + +|Name +|Required +|What is the title of this component. For instance, "Budgets" + +|Order position +|Optional +|Which order will it have in relation to the other budgets. Having a lower number means a higher priority. +For instance, if you have two budgets, "Budget a" with weight "10" and "Budget b" with weight "0", then "Budget b" will be first when ordering. +|=== + + +.Add component: Budgets form - Global settings +|=== +|Field |Type |Description + +|Scopes enabled +|Optional +|Check if you want to have Scopes filtering in this component. + +|Scope +|Optional +|Which xref:admin:scopes.adoc[Scope] does this component belongs to. + +|Global scope +|Optional +| + +|xref:_workflows[Workflow] +|Required +|How the participants can vote if there are multiple budget sets. You can define your own xref:_workflows[Workflow] or use one of the availables. + +|Projects per page +|Required +|How many projects are displayed per page. + +|Enable rule: Minimum budget percentage +|Optional, but incompatible with "Minimum number of projects to be voted on" and "Selected projects with minimum and maximum number of projects to be voted on" +|Allows to define a "Vote threshold percent", a percent of the total budget that participants must reach to be able to vote. + +|Enable rule: Minimum number of projects to be voted on +|Optional, but incompatible with "Minimum budget percentage" and "Selected projects with minimum and maximum number of projects to be voted on" +|Allows to define a "Minimum number of projects to vote", a number of projects that participants must reach to be able to vote. + +|Enable rule: Selected projects with minimum and maximum number of projects to be voted on +|Optional, but incompatible with "Minimum budget percentage" and "Minimum number of projects to be voted on" +|Allows to define a "Minimum amount of projects to be selected" and a "Maximum amount of projects to be selected", the number of projects +that participants will need to vote as a minimum and maximum. + +|Comments enabled +|Optional +|Whether you want to have comments in the meetings. + +|Comments max length +|Optional +|What is the characters limit that participants will have when making comments. Leave 0 for default value. + +|Actions permissions can be set for each project +|Optional +|Whether you want to be able to set permissions for every one of the projects. Most of the time you will want to leave this option disabled. + +|Announcement +|Optional +|A general announcement that'll be visible on the general budgets landing page. + +|Budgets landing page +|Optional +|What message will be shown in the Budgets landing page when there are multiple budgets. + +|More information modal +|Optional +|What message will be shown when clicking on the "More information" link. +|=== + +In the cases where the space that this component will be used has xref:admin:spaces/processes/phases.adoc[Phases], for instance, in +xref:admin:spaces/processes.adoc[Participatory Processes], then you can also define different behaviors per Step. + + +.Add component: Budgets form - Step settings +|=== +|Field |Type |Description + +|Comments blocked +|Optional +|Whether you want to enable comments for this phase. + +|Voting +|Required +|Choose one of the following options depending in the moment of the process: Voting disabled, Voting enabled or Voting finished. + +|Show votes +|Optional +|Wheter the votes will be shown. We strongly recommend that you only check this option after the voting is finished. + +|Announcement +|Optional +|A general announcement that'll be visible on the general budgets landing page. + +|Budgets landing page +|Optional +|What message will be shown in the Budgets landing page when there are multiple budgets. + +|More information modal +|Optional +|What message will be shown when clicking on the "More information" link. +|=== + +== Permissions + +Edit permissions + +* Vote +* Comment + +== Workflows + +One neat feature of the Budgets component is the ability to define your own workflows. + +This means that you can define multiple Budgets, for instance one for every Neighberhood or District that a City has, and +you can also define multiple rullings regarding how people can vote on those Budgets. By default you have these workflows: + +* Vote in one: allows participants to vote in any budget, but only in one. +* Vote in all: allows participants to vote in all budgets. +* Vote in a random component: allows participants to vote only in one budget, selected randomly. + +But this can be extended in your application by a developer, by making your own Workflows. For instance for the +https://www.decidim.barcelona/processes/PressupostosParticipatius[2020/2021 Participatory Budgeting Process in Decidim Barcelona], +the people could vote in two districts: the one where they lived and one of their choosing. This was defined in the +https://github.com/AjuntamentdeBarcelona/decidim-barcelona/blob/743be2a210e8745d2dc443166642b285aed2b356/lib/budgets_workflow_pam2021.rb[decidim-barcelona application itself]. + +You can read more about Worfklows in https://github.com/decidim/decidim/blob/1ab5cd8fdabef48f5be94ff9c30c6bb3bc9a2f8f/decidim-budgets/README.md#budget-workflows[decidim-budgets README.md]. + +NOTE: You only want to have a voting without much complications? Like a city-wide vote? Don't worry: if you define only one +Budget, then people will go there directly when click in the Budgets section. + +== Manage budgets + +image:components/budgets/manage_budgets.png[Manage budgets table] + +This window also lets you see the votes that the various projects have received. (Number of votes) and the total number of votes (*Finished votes* and *Pending votes*, that is, that a participant has started voting but has still not cast their vote). + +=== Export all + +Allows to export the projects for this budget in different formats. + +* Projects as CSV +* Projects as JSON +* Projects as Excel + +=== New budget form + +image:components/budgets/new_budget.png[New budget form] + + +.New budget form +|=== +|Field |Type |Description + +|Title +|Required +|What is the title of this budget. For instance, "District A" + +|Order position +|Optional +|Which order will it have in relation to the other budgets. Having a lower number means a higher priority. +For instance, if you have two budgets, "Budget a" with weight "10" and "Budget b" with weight "0", then "Budget b" will be first when ordering. + +|Description +|Optional +|What is the description of this budget. + +|Total budget +|Required +|What is the total amount of money that people will have for assigning. +|=== + +==== Actions + + +.Actions +|=== +|Icon |Name |Definition + +|image:action_preview.png[Preview icon] +|Preview +|To see how it's shown in the frontend to participants. + +|image:action_list.png[Manage projects icon] +|xref:_manage_projects[Manage projects] +|Allows you to manage the projects of a budget. + +|image:action_edit.png[Edit icon] +|Edit +|Edit form for a budget. It's the same form as "New budget". + +|image:action_delete.png[Delete icon] +|Delete +|To delete this budget. Only can be done when there aren't any projects. +|=== + +==== Manage projects + +===== Import proposals to projects + +Depending in the normative, you could want to have a first phase where participants +make proposals, and those proposals are selected (by voting or by technical review), +then you can import those proposals and convert them to projects. + +For this to work: + +. The following settings in the proposals component need to be enabled: +.. Proposal answering enabled +.. Enable costs on proposal answers +. A valuator or administrator need to Answer proposals: +.. Review the proposals +.. Accept or reject them according to your normative +.. Add costs to the proposals if were accepted +. An administrator can Import proposals to projects + +image:components/budgets/import_proposals.png[Import proposals to projects] + +===== Export all + +Allows to export the projects for this budget in different formats. + +* Projects as CSV +* Projects as JSON +* Projects as Excel + +===== New project form + +image:components/budgets/new_project.png[New project form for a Budget] + + +.New project form +|=== +|Field |Type |Description + +|Title +|Required +|The title for this project. + +|Description +|Required +|A description of what this project is about. + +|Budget amount +|Required +|What's the budget amount for this project. How much money will it cost to implement this project? + +|Category +|Optional +|Which Category has the project. Used for filtering in the budgets list. + +|Proposals +|Optional +|Choose related proposals for this project. Automatic assingned when importing proposals. + +|Add an image gallery +|Optional +|Add multiple images illustrating what this project is about, or where it will be implemented. +|=== + +===== Actions + + +.Actions +|=== +|Icon |Name |Definition + +|image:action_preview.png[Preview icon] +|Preview +|To see how it's shown in the frontend to participants. + +|image:action_edit.png[Edit icon] +|Edit +|Edit form for a project. It's the same form as "New project". + +|image:action_folder.png[Folders icon] +|Folders +|For classifying Attachments. + +|image:action_attachments.png[Attachments icon] +|Attachments +|Documents that are related to the project. + +|image:action_delete.png[Delete icon] +|Delete +|To delete this project. +|=== + +== Results + +After the voting step has finished, then an administrator need to: + +. Change the Voting configuration for the Budget component to "Voting finished" +. Go to the Budgets and view the results +. On the projects that according to the normative have been selected, she'll need to go to each project, edit it and +then check the "Selected for implementation". + +image:components/budgets/results_unselected.png[Unselected projects after voting] +image:components/budgets/results_select_project.png[Select a project for implementation] +image:components/budgets/results_selected.png[Selected projects after voting] +image:components/budgets/results_selected_frontend.png[Selected projects after voting in the frontend] + +We strongly recommend that after you have selected projects then you enable the Accountability +component so participants can see the grade of implementation. \ No newline at end of file From 44eef0303e5a6c14e1a5a2beaa61b95a640cb63e Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:40 +0200 Subject: [PATCH 011/336] New translations debates.adoc (French) --- .../admin/pages/components/debates.adoc | 230 ++++++++++++++++++ 1 file changed, 230 insertions(+) create mode 100644 docs/fr/modules/admin/pages/components/debates.adoc diff --git a/docs/fr/modules/admin/pages/components/debates.adoc b/docs/fr/modules/admin/pages/components/debates.adoc new file mode 100644 index 0000000000..6f62a9f8b5 --- /dev/null +++ b/docs/fr/modules/admin/pages/components/debates.adoc @@ -0,0 +1,230 @@ += Debate + +The Debate component allows people to have discussions, without voting nor prioritzation. It also allows to close them, +by adding conclusions or a summary of what the discussion was about. + +From this starting point, there could be other configurations, such as: + +* To allow debates creation by participants +* To have debates with a fixed started and ending date or open +* To show endorsements (public supports) or not + +Some examples of where this component was used: + +* https://meta.decidim.org/processes/roadmap/f/219/[Propose new functionalities for Decidim software in Metadecidim] + +image:components/debates/example01.png[Debates listing example] +image:components/debates/example02.png[Debate example] + +To configure the Debate component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies" or "Conferences". +. Go to components +. Click on "Add component" button +. Click on "Debate" +. Fill the xref:_add_component[Add component] form + +== Add component + +image:components/debates/component.png[Add component form] + + +.Add component: Debate form +|=== +|Field |Type |Description + +|Name +|Required +|What is the title of this component. For instance, "Debates" + +|Order position +|Optional +|Which order will it have in relation to the other debates. Having a lower number means a higher priority. +For instance, if you have two debates, "Debate a" with weight "10" and "Debate b" with weight "0", then "Debate b" will be first when ordering. +|=== + + +.Add component: Debate form - Global settings +|=== +|Field |Type |Description + +|Scopes enabled +|Optional +|Check if you want to have Scopes filtering in this component. + +|Scope +|Optional +|Which xref:admin:scopes.adoc[Scope] does this component belongs to. + +|Global scope +|Optional +| + +|Comments enabled +|Optional +|Whether you want to have comments in the meetings. + +|Comments max length +|Optional +|What is the characters limit that participants will have when making comments. Leave 0 for default value. + +|Announcement +|Optional +|A general announcement that'll be visible on the general debates landing page. +|=== + +In the cases where the space that this component will be used has xref:admin:spaces/processes/phases.adoc[Phases], for instance, in +xref:admin:spaces/processes.adoc[Participatory Processes], then you can also define different behaviors per Step. + + +.Add component: Debates form - Step settings +|=== +|Field |Type |Description + +|Endorsements enabled +|Optional +|Check if you want that participants show public support for these debates. + +|Endorsements blocked +|Optional +| + +|Debate creation by participants enabled +|Optional +|Check if you want to allow the creation of new debates by participants. + +|Comments blocked +|Optional +|Whether you want to enable comments for this phase. + +|Announcement +|Optional +|A general announcement that'll be visible on the general debate landing page. +|=== + +== Permissions + +An administrator can choose which kind of xref:customize:authorizations.adoc[Authorizations] a participant need to have to make +certain actions in the debates: + +* Create +* Endorse + +== Manage debates + +image:components/debates/manage_debates.png[Manage debates table] + +=== Export all + +Allows exporting the comments in the debates in different formats. + +* Comments as CSV +* Comments as JSON +* Comments as Excel + +=== New debate form + +image:components/debates/new_debate_backend.png[New debate backend form] + + +.New debate form +|=== +|Field |Type |Description + +|Title +|Required +|What is the title of this debate. For instance, "How can we improve this process?" + +|Description +|Required +|What is the description of this debate. + +|Instructions to participate +|Required +|Add a message for the participants. + +|Information updates +|Optional +|Add a message for the participants. + +|xref:_debate_types[Debate type] +|Required +|Choose between Finite and Open. Finite means that the debate has a starting and ending date and time, Open means that +there isn't any timeframe. + +|Starts at +|Required if the debate type is Finite +|Expected format: dd/mm/yyyy hh:ii + +|Ends at +|Required if the debate type is Finite +|Expected format: dd/mm/yyyy hh:ii + +|Category +|Optional +|Which category has the debate. Used for filtering in the debates list. +|=== + +==== Debate types + +It's possible to have two kinds of debates: + +. Finite: with a start and end date +. Open: without a start and end date + +This is shown publically in the debate list. + +image:components/debates/debates_list.png[Debates list] +image:components/debates/debate_finite.png[Finite debate] + +==== Actions + + +.Actions +|=== +|Icon |Name |Definition + +|image:action_edit.png[Edit icon] +|Edit +|Edit form for a debate. It's the same form as "New debate". + +|image:action_close.png[Close icon] +|Close +|Close form for a debate. For adding conclusions. + +|image:action_permissions.png[Permissions icon] +|Permissions +|To handle the permissions of this debate, depending on the verification a participant has. + +|image:action_delete.png[Delete icon] +|Delete +|To delete this debate. Only can be done when there aren't any projects. +|=== + +=== Close debate form + +A debate can be closed. This is useful for adding conclusions. After a debate was closed it can't be edited nor commented any more + +image:components/debates/close_debate_backend.png[Close debate backend form] + +Take in account that if the debate was created by a participant then only that +participant can close it. + +image:components/debates/close_debate_frontend.png[Close debate frontend form] + + +.Close debate form +|=== +|Field |Type |Description + +|Conclusions +|Required +|What is the conclusion for this debate. +|=== + +The conclusions are shown publicly with the close date and time. + +image:components/debates/debate_closed.png[Closed debate] \ No newline at end of file From 861c3a4599e9ffb7e285c681cf538b2605a68cb3 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:41 +0200 Subject: [PATCH 012/336] New translations elections.adoc (French) --- docs/fr/modules/admin/pages/components/elections.adoc | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 docs/fr/modules/admin/pages/components/elections.adoc diff --git a/docs/fr/modules/admin/pages/components/elections.adoc b/docs/fr/modules/admin/pages/components/elections.adoc new file mode 100644 index 0000000000..d8d661054c --- /dev/null +++ b/docs/fr/modules/admin/pages/components/elections.adoc @@ -0,0 +1,3 @@ += Elections + +include::admin:partial$development.adoc[] \ No newline at end of file From 147228cc9c5273b314bb0cf7a4418e5f77ab0ead Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:42 +0200 Subject: [PATCH 013/336] New translations meetings.adoc (French) --- .../admin/pages/components/meetings.adoc | 411 ++++++++++++++++++ 1 file changed, 411 insertions(+) create mode 100644 docs/fr/modules/admin/pages/components/meetings.adoc diff --git a/docs/fr/modules/admin/pages/components/meetings.adoc b/docs/fr/modules/admin/pages/components/meetings.adoc new file mode 100644 index 0000000000..96b29fa84e --- /dev/null +++ b/docs/fr/modules/admin/pages/components/meetings.adoc @@ -0,0 +1,411 @@ += Meetings + +Meetings are where people come together to discuss or inform about a given topic. All the meetings have a given location +(where the meeting will happen) and start and end date and time (when the meeting will happen). + +Some examples of where this component was used are: + +* https://www.decidim.barcelona/processes/PAM2020/f/3734/[Procés participatiu del Programa d'Actuació Municipal (PAM) 2020-2023] +in https://www.decidim.barcelona/[Decidim Barcelona] +* https://lejourdapres.parlement-ouvert.fr/processes/ateliers/f/14/[Les ateliers] in https://lejourdapres.parlement-ouvert.fr/[Le jour d'après] + +image:components/meetings/example01.png[Meetings list in Decidim Barcelona] +image:components/meetings/example02.png[Example meeting detail 01 in Decidim Barcelona] +image:components/meetings/example03.png[Example meeting detail 02 in Decidim Barcelona] +image:components/meetings/example04.png[Meetings list in Le jour d'après] + +== Types + +Regarding the *location*, depending on the configuration of the component, you can have: + +* In-person meetings: where you get together in a given location +* Online meetings: where you get together using an external service (for instance Jitsi Meet) + +Depending in the *author* (who's the person that's making the call): + +* Official meetings: meetings created by the organization (created by an administrator through the panel) +* Citizens meetings: meetings created by a User participant (a User or an UserGroup). + +== Add the component + +image:components/meetings/component.png[Add a meetings component] + +For adding the component, you need to: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Go to components +. Click on "Add component" button +. Click on "Meetings" +. Fill the xref:_add_component[Add component] form + +== Add component + +For configuring the meeting component you have these settings: + + +.Add component - Meetings form +|=== +|Field |Type |Description + +|Name +|Required +|What is the name of this component. + +|Order position +|Optional +|Which order will it have in relation with the other components. Having a lower number means a higher priority. For instance, +if you have two components, "Proposals" with weight "10" and "Meetiings" with weight "0", then "Meetings" will be first when ordering. +|=== + + +.Add component - Meetings form: Global settings +|=== +|Field |Type |Description + +|Scopes enabled +|Optional +|Check if you want to have Scopes filtering in this process. + +|Scope +|Optional +|Which scope will be used for this component. + +|Announcement +|Optional +|A general announcement that'll be visible in the general meetings list. + +|Default registration terms +|Optional +|What'll be the registration terms of service that the participant would need to accept when registering. + +|Comments enabled +|Optional +|Whether you want to have comments in the meetings. + +|Comments max length +|Optional +|What is the characters limit that participants will have when making comments. Leave 0 for default value. + +|Registration code enabled +|Optional +|Check if you want to give registration codes to participants. Learn more in xref:components/meetings/registrations.adoc[Registrations]. + +|Actions permissions can be set for each meeting +|Optional +|If you want more granular permissions inside of every one of the Meetings. + +|Enable pads creation +|Optional +|If you want an Etherpad embedded in your meetings. Must have the xref:services:etherpad.adoc[Etherpad] integration configurated. + +|Participants can create meetings +|Optional +|Allows participants to create new meetings. See xref:_citizens_meetings[Citizens meetings] + +|Maps enabled +|Optional +|Wheter you want to show a map in the meetings in the meeting detail. +|=== + + +.Add component - Meetings form: Step settings +|=== +|Field |Type |Description + +|Announcement +|Optional +|A general announcement that'll be visible in the general meetings list. + +|Comments enabled +|Optional +|Whether you want to have comments in the meetings. +|=== + +== Create a new meeting + +=== Citizens meetings + +Meetings can be created by participants if the setting is "Participants can create meetings" is checked. + +If a participant belongs to a xref:admin:participants/groups.adoc[user group], then she'll be able to create meetings as that group also. + +image:components/meetings/new_meeting_form_frontend01.png[Create a new meeting form (frontend)] +image:components/meetings/new_meeting_form_frontend02.png[Create a new meeting form (frontend)] + + +.Create meeting - Frontend form +|=== +|Field |Type |Description + +|Title +|Required +|What is the title for this meeting. + +|Description +|Required +|A description of what will be discussed in this meeting, like the topics. + +|Type +|Required +|Choose one option between "In person", "Online" or "Booth" + +|Address +|Required if meeting type is "In person" or "Booth" +|Address: used by Geocoder to find the location + +|Location +|Required +|Location: message directed to the users implying the spot to meet at + +|Location hints +|Optional +|Location hints: additional info. Example: the floor of the building + +|Online meeting URL +|Optional +|Which URL will the meeting be held. + +|Show embedded iframe for this URL +|Optional +|Whether or not embed the iframe for this videoconference URL. Only a few services allow embedding (i.e. YouTube, Twitch...) + +|Start Time +|Required +|Which day and time will the meeting start. Expected format: dd/mm/yyyy hh:ii + +|End Time +|Required +|Which day and time will the meeting start. Expected format: dd/mm/yyyy hh:ii + +|Category +|Optional +|Which Category has the meeting. Used for filtering in the meetings list. + +|Registration type +|Required +|Choose one option between "Registration disabled", "On this platform", or "On a different platform" + +|Available slots for this meeting +|Required if "Registration type" is "On this platform" +|How many slots are available for this meeting? Leave it to 0 if you have unlimited slots available + +|Registration terms +|Required if "Registration type" is "On this platform" +|What terms of services participants need to accept to register or join the meeting. Specific to "Citizens meetings" + +|Registration URL +|Required if "Registration type" is "On a different platform" +|Must be an URL. Link to go on the external service that you are using for registrations. + +|Create meeting as +|Required if the participant belongs to a group +|With which identity she wants to create this meeting: as her user or as a group that she's reprensenting? +|=== + +After creating the meeting, participants can also edit and xref:components/meetings/close.adoc[close] it. + +=== Official meetings + +image:components/meetings/new_meeting_form_backend.png[Create a new meeting form (backend)] + + +.Create meeting - Backend form +|=== +|Field |Type |Description + +|Title +|Required +|What is the title for this meeting. + +|Description +|Required +|A description of what will be discussed in this meeting, like the topics. + +|Type +|Required +|Choose one option between "In person", "Online" or "Booth" + +|Address +|Required if meeting type is "In person" or "Booth" +|Address: used by Geocoder to find the location + +|Location +|Required +|Location: message directed to the users implying the spot to meet at + +|Location hints +|Optional +|Location hints: additional info. Example: the floor of the building + +|Online meeting URL +|Optional +|Which URL will the meeting be held. + +|Show embedded iframe for this URL +|Optional +|Whether or not embed the iframe for this videoconference URL. Only a few services allow embedding (i.e. YouTube, Twitch...) + +|Start Time +|Required +|Which day and time will the meeting start. Expected format: dd/mm/yyyy hh:ii + +|End Time +|Required +|Which day and time will the meeting start. Expected format: dd/mm/yyyy hh:ii + +|Category +|Optional +|Which Category has the meeting. Used for filtering in the meetings list. + +|Registration type +|Required +|Choose one option between "Registration disabled", "On this platform", or "On a different platform" + +|Available slots for this meeting +|Required if "Registration type" is "On this platform" +|How many slots are available for this meeting? Leave it to 0 if you have unlimited slots available + +|Registration URL +|Required if "Registration type" is "On a different platform" +|Must be an URL. Link to go on the external service that you are using for registrations. + +|Private meeting +|Optional +|Check if the meeting shouldn't be visible for all the visitors. Specific to "Official meetings". + +|Transparent +|Optional +|Related to "Private meeting", check if the meeting should be visible for all the visitors but they shouldn't be able to +participate in. Specific to "Official meetings". Specific to "Official meetings". + +|Customize registration email +|Optional +|Wheter you want to add a message in the registration email. Specific to "Official meetings". + +|Registration email custom content +|Required if "Customize registration email" is checked +|The content of the customized email. This text will appear in the middle of the registration confirmation email. Just +after the registration code. Specific to "Official meetings". +|=== + +You can also define *Services* inside of a Meeting. These are metadata that allows to comunicate, for instance, if there's +a place for children, deaf assistance, translations, etc. You can have multiple services inside of a meeting. + + +.Create meeting - Services +|=== +|Field |Type |Description + +|Title +|Required +|Title of the service. + +|Description +|Optional +|Description of the service. +|=== + +== Actions + +=== Citizens meetings + + +.Actions - Citizens meetings +|=== +|Icon |Name |Definition + +|image:action_preview.png[Preview icon] +|Preview +|To see how it's shown in the frontend to participants. + +|image:action_permissions.png[Permissions icon] +|Permissions +|To handle the permissions of this meeting, depending on the verification a participant has. Allows an admin to configure +who can *Join* a meeting. +|=== + +=== Official meetings + + +.Actions - Official meetings +|=== +|Icon |Name |Definition + +|image:action_publish.png[Publish icon] +|Publish +|To show publicly the meeting. + +|image:action_publish.png[Unpublish icon] +|Unpublish +|To not show publicly the meeting. + +|image:action_preview.png[Preview icon] +|Preview +|To see how it's shown in the frontend to participants. + +|image:action_duplicate.png[Duplicate icon] +|Duplicate +|Allows an admin to duplicate a meeting. + +|image:action_registrations.png[Registrations icon] +|xref:admin:components/meetings/registrations.adoc[Registrations] +|Allows to define who can register for attending to the meeting. + +|image:action_edit.png[Edit icon] +|Edit +|Edit form for a Meeting. It's the same form as "Create a new meeting". + +|image:action_agenda.png[Agenda icon] +|xref:admin:components/meetings/agenda.adoc[Agenda] +|To add the topics that will be discussed in the meeting. + +|image:action_list.png[Poll icon] +|xref:admin:components/meetings/polls.adoc[Polls] +|To manage the polls for this online meeting. + +|image:action_close.png[Close icon] +|xref:admin:components/meetings/close.adoc[Close] +|Allows and admin to Close the meeting and add extra information. + +|image:action_folder.png[Folders icon] +|Folders +|For classifying Attachments. + +|image:action_attachments.png[Attachments icon] +|Attachments +|Documents that are related to the meeting. + +|image:action_permissions.png[Permissions icon] +|Permissions +|To handle the permissions of this meeting, depending on the verification a participant has. Allows an admin to configure +who can *Join* a meeting. + +|image:action_delete.png[Delete icon] +|Delete +|To delete this meeting. +|=== + +== Meetings features + +There are different kinds of features that can be enabled in meetings, such as: + +* xref:admin:components/meetings/registrations.adoc[Registrations]: for managing how particpant can register to attend the meeting. +* xref:admin:components/meetings/agenda.adoc[Agenda]: for seeing the topics that will be discussed in the meeting by minutes. +* xref:admin:components/meetings/polls.adoc[Polls]: for quick voting during an online meeting. +* xref:admin:components/meetings/close.adoc[Close]: for adding the final report on what was discussed in the meeting. + +== Online meetings + +Depending in the moment and configuration of the meeting, there could be different messages that will be shown to the participants. + +. If the "Online meeting URL" ins't set, there'll be a message that says "Link available soon" +image:components/meetings/online_meeting_available_soon.png[Online meeting available soon] +. If the "Online meeting URL" is set, and a few minutes before the meeting start, the mesage will say "The link to join +the meeting will be available a few minutes before it starts" +image:components/meetings/online_meeting_available_before.png[Online meeting available before it starts] +. If the "Online meeting URL" is set, and the start time of the meeting has arrived, then there'll be a message that says +that "the meeting is happening right now", with a link to join the meeting. +image:components/meetings/online_meeting_happening.png[Online meeting available before it starts] \ No newline at end of file From c1e3cae9c8cc51ea667141c9a95b91da9e8c988f Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:44 +0200 Subject: [PATCH 014/336] New translations agenda.adoc (French) --- .../pages/components/meetings/agenda.adoc | 91 +++++++++++++++++++ 1 file changed, 91 insertions(+) create mode 100644 docs/fr/modules/admin/pages/components/meetings/agenda.adoc diff --git a/docs/fr/modules/admin/pages/components/meetings/agenda.adoc b/docs/fr/modules/admin/pages/components/meetings/agenda.adoc new file mode 100644 index 0000000000..5ec6d771ab --- /dev/null +++ b/docs/fr/modules/admin/pages/components/meetings/agenda.adoc @@ -0,0 +1,91 @@ += Agenda + +The agenda feature allows an administrator to define the schedule for a meeting. It's possible to define agenda items and +sub-items, with every one of the topics that will be discussed in the meeting, along with a description and the duration +of every item and sub-item. + +image:components/meetings/agenda/agenda_frontend.png[Agenda in the frontend] + +== New agenda form + +To define an agenda for a meeting: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Click on "Meetings" +. Search the meeting that you want to add the agenda to +. Click on the "Agenda" button image:action_agenda.png[Agenda button] +. Fill the form + +image:components/meetings/agenda/new_agenda_form.png[New agenda form in the backend] + + +.New agenda form +|=== +|Field |Type |Description + +|Title +|Required +|Title for the agenda. For instance, "Schedule" + +|Visible +|Optional +|Check if you want to publish the agenda. + +|Agenda items +|Required +|List of agenda items. +|=== + +It's possible to create any number of Agenda items and sub-items. You can up or down the hierarchy of the agenda items. +It's also possible to remove and edit the agenda items. + + +.Agenda item form +|=== +|Field |Type |Description + +|Title +|Required +|Title for the agenda item + +|Duration +|Required +|How many minutes will the agenda item last. For instance, "15". + +|Description +|Optional +|Title for the agenda item + +|Agenda sub-items +|Optional +|List of agenda sub-items. +|=== + +The only limitation that agenda items and sub-items have is that they have to respect the duration of the parent. For instance, +if there's an Item that lasts 60 minutes, you can't create a sub-item that lasts 90 minutes. + +As an example, this agenda: + +image:components/meetings/agenda/agenda_frontend.png[Agenda in the frontend] + +Has the following configuration: + +* Title: "Schedule" +* Visible: true +* Agenda item #1: +** Title: Diagnosis +** Duration: 60 +* Agenda item #2: +** Title: Ideation +** Duration: 120 +** Agenda sub-item #2.1: +*** Title: Future thinking +*** Duration: 60 +*** Description: Imagining how we can solve the problem +** Agenda sub-item #2.2: +*** Title: Creating proposals +*** Duration: 60 +*** Description: In the platform \ No newline at end of file From 71cb9bac27a179298e00c5977cd9d2258b8c7507 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:45 +0200 Subject: [PATCH 015/336] New translations close.adoc (French) --- .../pages/components/meetings/close.adoc | 103 ++++++++++++++++++ 1 file changed, 103 insertions(+) create mode 100644 docs/fr/modules/admin/pages/components/meetings/close.adoc diff --git a/docs/fr/modules/admin/pages/components/meetings/close.adoc b/docs/fr/modules/admin/pages/components/meetings/close.adoc new file mode 100644 index 0000000000..f598ec1e90 --- /dev/null +++ b/docs/fr/modules/admin/pages/components/meetings/close.adoc @@ -0,0 +1,103 @@ += Close + +After a meeting has passed it's possible and recommened to close the meeting. This allows to adds the minutes, the notes +that gives a summary on what was discussed during the meeting, the agreements reached, decisions made, etc. + +This allows to bring transparency to the meeting and also serves as a record of the different meetings. + +It's also possible to add other kind of metadata to the meeting, such as what organizations has attended, how many attendees +and contributions were, and what proposals were discussed. + +image:components/meetings/close/frontend.png[Close report in the frontend] + +== Close meeting form + +=== Official meetings + +To close a meeting: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Click on "Meetings" +. Search the meeting that you want to close +. Click on the "Close" button image:action_close.png[Close button] +. Fill the form + +image:components/meetings/close/form_backend.png[Close meeting form in the backend] + + +.Close meeting form (backend) +|=== +|Field |Type |Description + +|Minutes +|Required +|Description of what happened in the meeting. + +|List of organizations that attended +|Optional +|Metadata that gets shown in the sidebar of the meeting. + +|Number of attendees +|Required +|Metadata that gets shown in the sidebar of the meeting. Must be a number. + +|Number of contributions +|Optional +|Metadata that gets shown in the sidebar of the meeting. Must be a number. + +|Proposals +|Optional +|Choose proposals from this space that were discussed in this meeting + +|Video URL +|Optional +|It's not used for anything. It will be removed in the future. + +|Audio URL +|Optional +|It's not used for anything. It will be removed in the future. + +|Is visible +|Optional +|Check if you want to publish the close report +|=== + +=== Citizens meetings + +Just like participants can create meetings, they can also close a meeting. They have fewer fields to fill. + +To close a a meeting: + +. Sign in as the participant that created the meeting +. Go to the meeting page +. Click on "Close". This will only be visible after the meeting has passed +. Fill the form + +image:components/meetings/close/form_frontend.png[Close meeting form in the frontend] + + +.Close meeting form (frontend) +|=== +|Field |Type |Description + +|Minutes +|Required +|Description of what happened in the meeting. + +|Number of attendees +|Required +|Metadata that gets shown in the sidebar of the meeting. Must be a number. + +|Proposals +|Optional +|Choose proposals from this space that were discussed in this meeting +|=== + +== Proposals + +If you relate a proposal to a meeting, the meeting also will be shown in the proposal. + +image:components/meetings/close/related_proposal.png[Related meeting in a proposal] \ No newline at end of file From 584a1763e4e6ca172825588f135034b8b6c730d3 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:47 +0200 Subject: [PATCH 016/336] New translations polls.adoc (French) --- .../pages/components/meetings/polls.adoc | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 docs/fr/modules/admin/pages/components/meetings/polls.adoc diff --git a/docs/fr/modules/admin/pages/components/meetings/polls.adoc b/docs/fr/modules/admin/pages/components/meetings/polls.adoc new file mode 100644 index 0000000000..99c7b70291 --- /dev/null +++ b/docs/fr/modules/admin/pages/components/meetings/polls.adoc @@ -0,0 +1,29 @@ += Polls + +CAUTION: this feature is still in active development and can't be used in production yet. + +Through the manage polls feature is possible to define a poll that will be displayed when an online meeting is ocurring. +This is useful to see quick feedback and make a decision inside the meeting without having to leave the meeting and use +other kind of tools (like surveys or proposals). + +With this feature an administrator can define questions and also manage when these questions and its results will be shown +to participants. + +== Enable polls for a meeting + +To enable polls for a meeting: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Click on "Meetings" +. Search the meeting that you want to define polls for +. Click on the "Manage polls" button image:action_list.png[Manage polls button] +. Fill the form + +The form is pretty much the Decidim form builder, with one caveat: you can only define Single and Multiple option questions. + +image:components/meetings/polls/backend.png[Backend for meeting polls] + +image:components/meetings/polls/backend_question.png[Definining a question in meeting polls] \ No newline at end of file From 350d7c51525c5e40ec1085c81c672e188ea69753 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:48 +0200 Subject: [PATCH 017/336] New translations registrations.adoc (French) --- .../components/meetings/registrations.adoc | 105 ++++++++++++++++++ 1 file changed, 105 insertions(+) create mode 100644 docs/fr/modules/admin/pages/components/meetings/registrations.adoc diff --git a/docs/fr/modules/admin/pages/components/meetings/registrations.adoc b/docs/fr/modules/admin/pages/components/meetings/registrations.adoc new file mode 100644 index 0000000000..71f3b3adb2 --- /dev/null +++ b/docs/fr/modules/admin/pages/components/meetings/registrations.adoc @@ -0,0 +1,105 @@ += Registrations + +Through registrations you can have capacity control of the attendance for a meeting. With this feature for instance you can +limit how many people could attend to the meeting, or you can know before the start of a meeting if you need to find a bigger +room to have the meeting. + +Enabling this feature will add a button so that participants can express their wish to go to the meeting. Depending in how +this feature is configured, then: + +. it's possible to define how many slots are available for controling the maximum capacity for this meeting +. a xref:_registration_form[custom registration form] for asking information to participants can be configured +. administrators can make xref:_invitations[invitations] to other participants or people that isn't registered in the platform +. it's possible to control attendance to the meeting through xref:_registration_code[registration codes] + +image:components/meetings/registrations/frontend_join_meeting.png[Join a meeting sidebar button] + +Once participants confirm joining a meeting they get asked if they're reprensenting a group and if they want to show publicly that they're attending. + +image:components/meetings/registrations/frontend_confirm.png[Join a meeting confirm modal] + +== Enable registrations for a meeting + +To enable registrations for a meeting: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Click on "Meetings" +. Search the meeting that you want to enable registrations for +. Click on the "Edit" button image:action_edit.png[Edit button] +. Change the "Registration type" field to "On this platform" +. Define how many slots are available in "Available slots for this meeting" +. Click on the "Update" button +. Click on the "Registrations" button image:action_registrations.png[Registrations button] +. Check the "Registrations enabled" checkbox +. Fill the form + +== Registrations settings form + +image:components/meetings/registrations/backend.png[Registrations settings in a meeting] + + +.Registrations settings form +|=== +|Field |Type |Description + +|Registrations enabled +|Required +|Check to enable the registration for this meeting. + +|Registration form enabled +|Optional +|Check if you want to enable the registration form + +|Available slots for this meeting +|Required +|How many slots are available. Leave it to 0 if you have unlimited slots available. + +|Reserved slots +|Required +|How many slots are already reserved. Leave it to 0 if you don't have reserved slots + +|Registration terms +|Required +|What terms of services participants need to accept to register or join the meeting. +|=== + +== Registration form + +This feature allows you to define a custom form like the xref:admin:components/surveys.adoc[Surveys] component to ask participants +for registration information. + +== Export all + +It's possible to export registrations in multiple formats: CSV, JSON and XLSX (Excel). + +The exported data will have these fields: + +* id: The registration id +* code: the xref:_registration_code[registration code] (if this feature is enabled) +* user/name: the name of the user +* user/email: the email of the user +* user/user_group: the group of the user if she has selected that's representing a group when registering + +== Invitations + +This feature allows you to invite attendes to a meeting. These could be already registered or non-existing participants +in the platform. + +image:components/meetings/registrations/invite_attendee.png[Invite attendee for registration in a meeting] + +== Registration code + +This feature allows you to check if the attendee is registered in the meeting. She needs to provide her code, that gets +entered in this form and it's checked against the database. + +image:components/meetings/registrations/backend_w_registration_code.png[Registration code form in a meeting] + +image:components/meetings/registrations/frontend_confirmed_w_code.png[Registration code in a meeting frontend] + +It can receive two kind of responses: + +* Registration code successfully validated. +* This registration code is invalid. \ No newline at end of file From 1bac4f86f3934655efd9c2e8461d8f002e2e2aaa Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:50 +0200 Subject: [PATCH 018/336] New translations pages.adoc (French) --- .../modules/admin/pages/components/pages.adoc | 85 +++++++++++++++++++ 1 file changed, 85 insertions(+) create mode 100644 docs/fr/modules/admin/pages/components/pages.adoc diff --git a/docs/fr/modules/admin/pages/components/pages.adoc b/docs/fr/modules/admin/pages/components/pages.adoc new file mode 100644 index 0000000000..6739927552 --- /dev/null +++ b/docs/fr/modules/admin/pages/components/pages.adoc @@ -0,0 +1,85 @@ += Page + +The Page component allows people to get information about a space. It's similar to the general xref:admin:pages.adoc[Pages] admin section, with +the main difference is that this component allows to define pages in a space, and the general Pages admin section allows to +define pages for all the platform (for instance, help pages, terms of services, or FAQs), that aren't associated to a space. + +From this starting point, there could be other configurations, such as: + +Some examples of where this component was used: + +* https://www.decidim.barcelona/processes/PressupostosParticipatius/f/4691/[More information page in 2020 Participatory Budgeting process in Decidim Barcelona] + +image:components/page/example01.png[More information page in 2020 Participatory Budgeting process in Decidim Barcelona - Frontend] +image:components/page/example02.png[More information page in 2020 Participatory Budgeting process in Decidim Barcelona - Backend] + +To configure the Page component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Go to components +. Click on "Add component" button +. Click on "Page" +. Fill the xref:_add_component[Add component] form + +== Add component + +image:components/page/component.png[Add component form] + + +.Add component: Page form +|=== +|Field |Type |Description + +|Name +|Required +|What is the title of this component. For instance, "More information". + +|Order position +|Optional +|Which order will it have in relation to the other pages. Having a lower number means a higher priority. +For instance, if you have two pages, "Page a" with weight "10" and "Page b" with weight "0", then "Page b" will be first when ordering. +|=== + + +.Add component: Page form - Global settings +|=== +|Field |Type |Description + +|Announcement +|Optional +|A general announcement that'll be visible on the general pages landing page. +|=== + +In the cases where the space that this component will be used has xref:admin:spaces/processes/phases.adoc[Phases], for instance, in +xref:admin:spaces/processes.adoc[Participatory Processes], then you can also define different behaviors per Step. + + +.Add component: Pages form - Step settings +|=== +|Field |Type |Description + +|Announcement +|Optional +|A general announcement that'll be visible on the general page landing page. +|=== + +== Permissions + +As this component doesn't allow to do anything, there are no permissions to set up. + +=== New page form + +image:components/page/new_page.png[New page form] + + +.New page form +|=== +|Field |Type |Description + +|Body +|Required +|What is the body for the page. +|=== \ No newline at end of file From 360d0a0f9cc994ddb3ce81fc6643650287423e75 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:51 +0200 Subject: [PATCH 019/336] New translations proposals.adoc (French) --- .../admin/pages/components/proposals.adoc | 445 ++++++++++++++++++ 1 file changed, 445 insertions(+) create mode 100644 docs/fr/modules/admin/pages/components/proposals.adoc diff --git a/docs/fr/modules/admin/pages/components/proposals.adoc b/docs/fr/modules/admin/pages/components/proposals.adoc new file mode 100644 index 0000000000..5d2b652324 --- /dev/null +++ b/docs/fr/modules/admin/pages/components/proposals.adoc @@ -0,0 +1,445 @@ += Proposals + +The Proposals component allows people to create, comment, endorse, and give support to proposals. + +From this starting point, there could be other configurations, such as: + +* how many proposals a participant can create +* how many supports as a maximum a participant can give to proposals +* how many supports as a minimum a participant must give to proposals so their supports are valid +* whether you want to enable that participants comment on proposals +* whether you want that proposals have images, attachments, WYSIWYG editor, geolocated address, scopes, etc. + +Some examples of where this component was used: + +* https://futureu.europa.eu/[Conference of the Future of Europe] +* https://meta.decidim.org/processes/roadmap/f/122/[Propose new functionalities for Decidim software] in https://meta.decidim.org/[Metadecidim] + +image:components/proposals/example01.png[Proposals list example in COFE] +image:components/proposals/example02.png[Proposals list example in Metadecidim] +image:components/proposals/example03.png[Proposal detail example in Metadecidim] + +To configure the Proposals component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Go to components +. Click on "Add component" button +. Click on "Proposals" +. Fill the xref:_add_component[Add component] form + +== Add component + +image:components/proposals/component.png[Add component form] + + +.Add component: Proposals form +|=== +|Field |Type |Description + +|Name +|Required +|What is the title of this component. For instance, "Proposals" + +|Order position +|Optional +|Which order will it have in relation to the other components. Having a lower number means a higher priority. +For instance, if you have two components, "Proposals" with weight "10" and "Meetings" with weight "0", then "Meetings" will be first when ordering. +|=== + + +.Add component: Proposals form - Global settings +|=== +|Field |Type |Description + +|Scopes enabled +|Optional +|Check if you want to have Scopes filtering in this component. + +|Scope +|Optional +|Which xref:admin:scopes.adoc[Scope] does this component belongs to. + +|Support limit per participant +|Optional +|Must be a number. How much supports a participant can give to proposals. + +|Minimum supports per user +|Optional +|Must be a number. How many supports does a participant needs to give to proposals so their supports are counted. If she doesn't +reach this number, her supports will not be taken in account. + +|Proposal limit per participant +|Optional +|Must be a number. How many proposals a participant can create. + +|Maximum proposal body length +|Optional +|Must be a number. How many characters a proposal body can have as maximum. + +|Proposal editing +|Required +|Choose one of these two options: "Allow editing of proposals within a specific timeframe" or "Allow editing proposals +for an infinite amount of time". In case it's within a specific timeframe, you must specify the time in "Proposals can be +edited by authors before this many minutes passes". Note that if you xref:components/proposals/answers.adoc[answer a proposal] +then it can't be edited anymore. + +|Proposals can be edited by authors before this many minutes passes +|Required if "Proposal editing" is "Allow editing of proposals within a specific timeframe" +|Must be a number. How many minutes after the creation of a proposal it can be edited by its author. + +|Threshold per proposal +|Optional +|Must be a number. How many supports a proposal needs to have to be considered as "validated". See <>. + +|Can accumulate supports beyond threshold +|Optional. Only applies if "Threshold per proposal" is configured. +|Whether the proposal can accumulate more supports than the threshold. + +|Proposal answering enabled +|Optional +|Whether administrators or valuators can answer proposals. + +|Official proposals enabled +|Optional +|Wheter administrators can create official proposals. + +|Comments enabled +|Optional +|Whether you want to have comments in the meetings. + +|Comments max length +|Optional +|What are the characters limit that participants will have when making comments. Leave 0 for the default value. + +|Geocoding enabled +|Optional +|Wheter participants can define a geocoding address for their proposals. Need to have xref:configure:geocoding[Geocoding] enabled. See <>. + +|Allow attachments +|Optional +|Check to allow participants to attach files to their proposals. + +|Allow card image +|Optional +|Check to show a card image when participants attach images to their proposals. See <>. + +|Actions permissions can be set for each proposal +|Optional +|Whether you want to be able to set permissions for every one of the proposals. Most of the time you will want to leave this option disabled. + +|Collaborative drafts enabled +|Optional +|Check to enable xref:components/proposals/collaborative_drafts.adoc[collaborative drafts] in proposals. + +|Participatory texts enabled +|Optional +|Check to enable xref:components/proposals/participatory_texts.adoc[participatory texts] in proposals. + +|Amendments enabled +|Optional +|Check to enable xref:components/proposals/amendments.adoc[amendments] in proposals. If active, configure Amendment features for each step. + +|Amendments Wizard help text +|Optional. Visible if the "Amendments enabled" option is checked. +|What's the help text visible when creating new amendments. + +|Announcement +|Optional +|A general announcement that'll be visible on the general proposals landing page. + +|New proposal body template +|Optional +|A pre-defined text that will be used when creating new proposals. Useful if you want to define a format that participants need to +follow when creating new proposals. + +|New proposal help text +|Optional +|What's the help text visible when creating new proposals. + +|Proposal wizard "Create" step help text +|Optional +|What's the help text visible when creating new proposals in the "Create" step. + +|Proposal wizard "Compare" step help text +|Optional +|What's the help text visible when creating new proposals in the "Compare" step. + +|Proposal wizard "Complete" step help text +|Optional +|What's the help text visible when creating new proposals in the "Complete" step. + +|Proposal wizard "Publish" step help text +|Optional +|What's the help text visible when creating new proposals in the "Publish" step. +|=== + +[#setting-threshold] +*Example of threshold setting* + +image::components/proposals/setting_threshold01.png[Example of threshold setting] + +image::components/proposals/setting_threshold02.png[Example of threshold setting] + +[#setting-card-image] +*Example of card image setting* + +image::components/proposals/setting_card_image.png[Example of card image setting] + +[#setting-geocoding] +*Example of geocoding setting* + +image::components/proposals/setting_geocoding.png[Example of geocoding setting] + +--- + +In the cases where the space that this component will be used has xref:admin:spaces/processes/phases.adoc[Phases], for instance, in +xref:admin:spaces/processes.adoc[Participatory Processes], then you can also define different behaviors per Step. + + +.Add component: Proposals form - Step settings +|=== +|Field |Type |Description + +|Announcement +|Optional +|A general announcement that'll be visible on the general proposal landing page. + +|Endorsements enabled +|Optional +|Check if you want that participants show public support for these proposals. + +|Endorsements blocked +|Optional +|Whether participants will be able to see the endorsments but don't make any. + +|Supports enabled +|Optional +|Whether participants will be able to support proposals in this step. + +|Supports blocked +|Optional +|Whether participants will be able to support proposals in this step. + +|Supports hidden +|Optional +|If supports are enabled, checking this will hide the number of supports. + +|Comments blocked +|Optional +|Whether you want to enable comments for this phase. + +|Proposal creation enabled +|Optional +|Whether you want to enable proposal creation by participants for this phase. See xref:_new_proposal_form[New proposal form] + +|Proposal answering enabled +|Optional +|Whether you want to enable xref:components/proposals/answers.adoc[proposal answering]. + +|Publish proposal answers immediately +|Optional +|Wheter you want that the answers of proposals are published at the same time that you're xref:components/proposals/answers.adoc[answering] them or you want to control when to publish the answers. + +|Enable costs on proposal answers +|Optional +|Wheter you want to add economical costs to proposal answers. Useful for importing to xref:components/budgets.adoc[budgets]. + +|Amendment creation enabled +|Optional. Visible if "Amendments enabled" option is checked. +|Participant can amend proposals. See xref:components/proposals/amendments.adoc[Amendments]. + +|Amendment reaction enabled +|Optional. Visible if "Amendments enabled" option is checked. +|Proposal's authors will be able to accept or reject Participant's emendations. + +|Amendment promotion enabled +|Optional. Visible if "Amendments enabled" option is checked. +|Emandation authors will be able to promote to Proposal the rejected emendation. + +|Amendments visibility +|Required. Visible if "Amendments enabled" option is checked. +|Choose one of "Amendments are visible to all" or "Amendments are visible only to their authors" + +|Announcement +|Optional +|A general announcement that'll be visible on the general proposals landing page. + +|Hashtags added to all proposals +|Optional +|Automatically add a hashtag to every proposal. See <>. + +|Hashtags suggested to participants for new proposals +|Optional +|Suggest hashtags to participants for new proposals. Participants can select more than one hashtag. See <>. +|=== + +[#setting-hashtags] +*Example of hashtags setting* + +image::components/proposals/setting_hashtag.png[Example of hashtag setting] + +== Permissions + +An administrator can choose which kind of xref:customize:authorizations.adoc[Authorizations] a participant need to have to make +certain actions in the proposals: + +* Endorse +* Support +* Create +* Withdraw +* Amend +* Comment +* Vote comment + +== Manage proposals + +image:components/proposals/manage_proposals.png[Manage proposals table] + +=== Export + +Allows exporting the proposals in different formats. + +* Proposals as CSV +* Proposals as JSON +* Proposals as Excel +* Comments as CSV +* Comments as JSON +* Comments as Excel + +=== Import + +* Import from another component +* Import from a file + +=== New proposal form + +==== Citizens proposals + +image:components/proposals/new_proposal_frontend.png[New proposal form] + +Proposals can be created by participants if the setting is "Proposal creation enabled" is checked for the active phase. + +If a participant belongs to a xref:admin:participants/groups.adoc[user group], then she'll be able to create proposals as that group also. + +This form depends a lot in which settings you've enabled in this component. It can be really short (with only a Title and +Body by default) or very long (Title, Body, Hashtags, Address, Scope, Category, Image and Attachment). + + +.New proposal form - default (by a participant) +|=== +|Field |Type |Description + +|Title +|Required +|What is the title of this proposal. For instance, "Bike lane in Main Street". Must have at least 15 characters as minimum +and 150 characters as maximum. Must start with a capital letter. + +|Body +|Optional +|What is the full description for this proposal. Must have at least 15 characters as minimum and 450 characters as maximum +by default but can be changed with the setting "Maximum proposal body length". +|=== + +To detect duplicated proposals before publishing them, the proposal creation has a wizard form with multiple steps. This also +allows participants to save proposals drafts (unpublished) in case they need to fill too many fields. + +image:components/proposals/new_proposal_frontend_compare.png[New proposal form (by a participant) - Compare] + +As an example of what the form could look depending in the settings enabled, here's a screenshot of the form for a proposal +with the following settings: "Hashtags added to all proposals", "Hashtags suggested to participants for new proposals", +"Geocoding enabled", "Allow attachments", "Allow card image" and "Scopes enabled". + +image:components/proposals/new_proposal_frontend_complete.png[New proposal form (by a participant) - Complete] + +After completing these fields the participant can see a preview of their proposal before publishing. They can also modify +the proposal before publishing it. + +image:components/proposals/new_proposal_frontend_publish.png[New proposal form (by a participant) - Publish] + +image:components/proposals/new_proposal_frontend_published.png[Published proposal made by a participant] + +==== Official proposals + +Administrators can create official proposals. There will be a filter to show only official proposals in the proposals navigation page. + +image:components/proposals/new_proposal_backend01.png[New proposal form - default (official proposals)] + + +.New proposal form - default (official proposals) +|=== +|Field |Type |Description + +|Title +|Required +|What is the title of this proposal. For instance, "Bike lane in Main Street". Must have at least 15 characters as minimum +and 150 characters as maximum. Must start with a capital letter. + +|Body +|Optional +|What is the full description of this proposal. Must have at least 15 characters as minimum and 450 characters as maximum +by default but can be changed with the setting "Maximum proposal body length". + +|This proposal comes from a meeting +|Optional +|Check if this proposal comes from a meeting. + +|Select a meeting +|Required if the "This proposal comes from a meeting" checkbox is checked +|Dropdown selector with all the meetings of this space. The author of the proposal will be the meeting. +|=== + +As an example of what the form could look like depending on the settings enabled, here's a screenshot of the form for a proposal +with the following settings: "Hashtags added to all proposals", "Hashtags suggested to participants for new proposals", +"Geocoding enabled", "Allow attachments", "Allow card image" and "Scopes enabled". + +image:components/proposals/new_proposal_backend02.png[New proposal form - with multiple settings (official proposals)] + +==== Actions + + +.Actions +|=== +|Icon |Name |Definition + +|image:action_edit.png[Edit icon] +|Edit +|Edit form for a proposal. It's the same form as "New proposal". Only visible when the proposal is an xref:_official_proposals["Official proposal"]. + +|image:action_answer.png[Answer proposal icon] +|xref:components/proposals/answers.adoc[Answer proposal] +|Allows you to answer a proposal. + +|image:action_permissions.png[Permissions icon] +|Permissions +| + +|image:action_preview.png[Preview icon] +|Preview +|To see how it's shown in the frontend to participants. +|=== + +== Origin filter + +When navigating in the proposals listing, you can filter the proposals by origin. + +image:components/proposals/origin_filter.png[Proposals origin filter] + +There are five origin options: + +* All: select all the origins +* xref:_official_proposals[Official]: proposals created by administrators +* xref:_citizens_proposals[Citizens]: proposals created by participants +* Groups: proposals created by participants that belong to a user group and choose that option when creating the proposal +* Meetings: proposals created by administrators that have checked this option when creating the proposal + +== Proposal types and mechanisms + +There are different kind of proposals mechanisms that can be enabled in proposals, such as: + +* xref:admin:components/proposals/amendments.adoc[Amendments] +* xref:admin:components/proposals/answers.adoc[Answers] +* xref:admin:components/proposals/collaborative_drafts.adoc[Collaborative drafts] +* xref:admin:components/proposals/participatory_texts.adoc[Participatory texts] \ No newline at end of file From a8a52d862cd3e3b6746bcae6fb397f0054790655 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:52 +0200 Subject: [PATCH 020/336] New translations amendments.adoc (French) --- .../components/proposals/amendments.adoc | 94 +++++++++++++++++++ 1 file changed, 94 insertions(+) create mode 100644 docs/fr/modules/admin/pages/components/proposals/amendments.adoc diff --git a/docs/fr/modules/admin/pages/components/proposals/amendments.adoc b/docs/fr/modules/admin/pages/components/proposals/amendments.adoc new file mode 100644 index 0000000000..be89e58eb5 --- /dev/null +++ b/docs/fr/modules/admin/pages/components/proposals/amendments.adoc @@ -0,0 +1,94 @@ += Amendments + +With the amendment feature, participants can propose changes to an already published proposal. + +It's useful to propose improvements or corrections, specially useful when redacting laws or normatives with xref:components/proposals/participatory_texts.adoc[Participatory Texts]. + +It has similarities with xref:components/proposals/collaborative_drafts.adoc[Collaborative Drafts], but the main difference +is that with amendments there is no need to trust the other authors intentions, as every change is reviewed and must be +approved by the author of the original proposal. + +image:components/proposals/amendments/amendment.png[Amendment of a proposal] + +To configure "Amendments" in proposals component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Go to components +. Click on "Add component" button +. Click on "Proposals" +. Check the "Amendments enabled" setting +. Review and configure the following related settings: "Amendments Wizard help text" in global component settings and "Amendment creation enabled", "Amendment reaction enabled", "Amendment promotion enabled", and "Amendments visibility" in the step component settings. +. Save the component + +== How it works + +. A participant (Alice) has created a proposal +. Another participant (Bob) has seen the proposal and wants to make some changes +image:components/proposals/amendments/proposal_to_amend.png[] +. Bob click on the "Amend proposal" button +. Bob makes the changes in the "Create amendment draft" form +image:components/proposals/amendments/create_amendment_draft.png[] +. Bob checks if there is any similar amendment +. Bob edits the amendment draft +image:components/proposals/amendments/edit_amendment_draft.png[] +. Bob publishes the amendment draft +image:components/proposals/amendments/publish_amendment_draft.png[] +. Anyone can see the amendment draft +image:components/proposals/amendments/proposal_amendmed.png[] +image:components/proposals/amendments/amendment_list.png[] +image:components/proposals/amendments/amendment_view_side_by_side.png[] +. It's also possible to filter the amended proposals +image:components/proposals/amendments/amendment_list_filter.png[] +. Alice receives a notification that Bob has proposed an amendment to her original proposal +image:components/proposals/amendments/proposal_amendmed_notification.png[] +. Alice can see the amendment proposal +image:components/proposals/amendments/proposal_amendmed_to_review.png[] +. Alice can review the amendment proposal +image:components/proposals/amendments/proposal_amendmed_review.png[] +. Alice can approve the amendment proposal +image:components/proposals/amendments/proposal_amendmed_accepted.png[] +. Anyone can see the final proposal +image:components/proposals/amendments/proposal_amendmed_final.png[] +image:components/proposals/amendments/proposal_amendmed_amendment_list.png[] +. Anyone can see the versions history of the proposal +image:components/proposals/amendments/proposal_amendmed_versions.png[] + +== Relevant component settings + + +.Proposals component form - Settings related to amendments +|=== +|Field |Type |Description + +|Amendments enabled +|Global +|Check to enable xref:components/proposals/amendments.adoc[amendments] in proposals. Other settings visible when enabling one. + +|Amendments Wizard help text +|Global +|What's the help text visible when creating new amendments. + +|Amendment creation enabled +|Step +|Participant can amend proposals. See xref:components/proposals/amendments.adoc[Amendments]. + +|Amendment reaction enabled +|Step +|Proposal's authors will be able to accept or reject Participant's emendations. + +|Amendment promotion enabled +|Step +|Emandation authors will be able to promote to Proposal the rejected emendation. + +|Amendments visibility +|Step +|Choose one of "Amendments are visible to all" or "Amendments are visible only to their authors" +|=== + +== Promotion + +If a proposal is rejected and the "Amendment promotion enabled" is enabled, then the author that have made the rejected +amendment will be able to promote to a new proposal the rejected emendation. \ No newline at end of file From bd9588540f9922630be1c3b4a508155be02ff5f5 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:54 +0200 Subject: [PATCH 021/336] New translations answers.adoc (French) --- .../pages/components/proposals/answers.adoc | 113 ++++++++++++++++++ 1 file changed, 113 insertions(+) create mode 100644 docs/fr/modules/admin/pages/components/proposals/answers.adoc diff --git a/docs/fr/modules/admin/pages/components/proposals/answers.adoc b/docs/fr/modules/admin/pages/components/proposals/answers.adoc new file mode 100644 index 0000000000..8e1d8238b1 --- /dev/null +++ b/docs/fr/modules/admin/pages/components/proposals/answers.adoc @@ -0,0 +1,113 @@ += Answers + +Proposals answers allow an administrator or valuator to review a proposal and give it an official response. + +image:components/proposals/proposal_answer_state_accepted.png[Proposal answer state: Accepted] + +For answering a proposal: + +. Sign in as admin or valuator +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Click in the "Proposals" component +. Search the proposal you want to answer +. Click in the "Proposal answer" button image:action_answer.png[Answer proposal icon] +. Fill the form + +Alternatively, you could also: + +. Sign in as admin or valuator +. Navigate to the proposal you want to answer +. Click in the proposal answer button in the header image:components/proposals/answer_button_header.png[Answer proposal button] +. Fill the form + +== Answer page + +The answer page has three sections: + +=== Metadata + +It has general information about the proposal, like the link, who is the author, the proposal body, how many supports, endorsements, comments, and so on. + +=== Private notes + +Allows an administrator or valuator to leave notes that will not be visible to the public. + +=== Answer for proposal + +Allows an administrator to answer a proposal. + +image:components/proposals/proposal_answer.png[Proposal answer form] + + +.Answer for proposal form +|=== +|Field |Type |Description + +|Internal state +|Required +|Choose one of the following: Accepted, Rejected, or Evaluating + +|Answer +|Optional +|An explanation on why the proposal was accepted, rejected, or evaluated + +|Cost +|Required if "Enable costs on proposal answers" is enabled in the proposals component settings and if it's accepted +|A number that indicates the cost of the proposal + +|Cost report +|Required if "Enable costs on proposal answers" is enabled in the proposals component settings and if it's accepted +|An explanation of the cost of the proposal + +|Execution period +|Required if "Enable costs on proposal answers" is enabled in the proposals component settings and if it's accepted +|How much time the proposal will take to be executed +|=== + +== States + +If the proposals component setting "Publish proposal answers immediately" is checked, then the response of the proposal will be visible to the public immediately. + +The state is visible on the proposal page and card. + +image:components/proposals/proposal_answer_state_accepted_card.png[Proposal card answer state: Accepted] + +=== Evaluating + +image:components/proposals/proposal_answer_state_evaluating.png[Proposal answer state: Evaluating] + +=== Accepted + +After proposals have been accepted, they can be imported to the xref:components/budgets.adoc[budgets] component. + +image:components/proposals/proposal_answer_state_accepted.png[Proposal answer state: Accepted] + +=== Rejected + +image:components/proposals/proposal_answer_state_rejected.png[Proposal answer state: Rejected] + +== Publication + +You can control when the answers will be published by using the "Publish proposal answers immediately" checkbox. + +For enabling automatic publication, you'll need to check it. + +On the other hand, if you want to control when to publish the answer a proposal or multiple proposals, you'll need to follow these steps: + +. Sign in as admin or valuator +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Click in the "Proposals" component +. Search the proposal you want to answer +. Click in the left checkbox of the proposal that you want to publish +. Click on the "Actions" button +. Click on the "Publish answers" option +image:components/proposals/proposal_answer_publish.png[Proposal answer publication: action] +. Click on "Publish" button +image:components/proposals/proposal_answer_publish_button.png[Proposal answer publication: publish button] + +NOTE: If you have unchecked the "Publish proposal answers immediately", answered the proposals and then checked the option again, the answers will not be +published automatically. You'll still need to publish the answers manually with the "Actions" button. \ No newline at end of file From d0d0144c6f9b1f2d15da25a01539637e1014413b Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:55 +0200 Subject: [PATCH 022/336] New translations collaborative_drafts.adoc (French) --- .../proposals/collaborative_drafts.adoc | 70 +++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 docs/fr/modules/admin/pages/components/proposals/collaborative_drafts.adoc diff --git a/docs/fr/modules/admin/pages/components/proposals/collaborative_drafts.adoc b/docs/fr/modules/admin/pages/components/proposals/collaborative_drafts.adoc new file mode 100644 index 0000000000..9c26ef25e2 --- /dev/null +++ b/docs/fr/modules/admin/pages/components/proposals/collaborative_drafts.adoc @@ -0,0 +1,70 @@ += Collaborative draft + +With the collaborative draft feature participants can make a proposal with multiple authors. + +It's useful to propose improvements or corrections. + +It has similarities with xref:components/proposals/amendments.adoc[Amendments] but the main difference is that with collaborative +drafts there is a need to trust other authors, as they can make any change to the original proposal without approval by the +original author, although the original author can decide if she promotes the collaborative draft as a proposal. + +image:components/proposals/collaborative_drafts/collaborative_draft_request_access.png[Collaborative draft with request access button] + +To configure "Collaborative Drafts" in Proposals component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Go to components +. Click on "Add component" button +. Click on "Proposals" +. Check the "Collaborative drafts enabled" setting +. Save the component + +== How it works + +. A participant (Alice) wants to create a collaborative draft. For that, she goes to the proposals list page. +. Alice clicks in the "Access collaborative drafts" button +image:components/proposals/collaborative_drafts/proposals_list01.png[] +. Alice clicks in "New collaborative draft" button +image:components/proposals/collaborative_drafts/list_empty.png[] +. Alice fills the form and submits it +image:components/proposals/collaborative_drafts/create_form.png[] +. Once the collaborative draft is created, Alice can: edit, withdraw or publish the collaborative draft and approve or +reject collaboration requests +image:components/proposals/collaborative_drafts/collaborative_draft.png[] +. Another participant (Bob) has seen the collaborative draft and wants to make some changes +image:components/proposals/collaborative_drafts/collaborative_draft_request_access.png[] +. Bob clicks in the "Request access" button +image:components/proposals/collaborative_drafts/access_requested.png[] +. Alice receives the notification +image:components/proposals/collaborative_drafts/notification.png[] +. Alice goes to the collaborative draft. There she can accept or reject the collaboration request +image:components/proposals/collaborative_drafts/author_sidebar.png[] +. Alice approves the collaboration request. Once a request is approved it can't be rejected +. Now the collaborative draft has multiple authors +image:components/proposals/collaborative_drafts/multiple_authors.png[] +. Bob can edit the collaborative draft by clicking in the "Edit collaborative draft" button +image:components/proposals/collaborative_drafts/edit_collaborative_draft.png[] +image:components/proposals/collaborative_drafts/edit_form.png[] +. Once the collabrative draft is edited, then it's possible to see the old versions and its changes +image:components/proposals/collaborative_drafts/collaborative_draft_edited.png[] +image:components/proposals/collaborative_drafts/collaborative_draft_edited_versions.png[] +image:components/proposals/collaborative_drafts/collaborative_draft_edited_versions_show_v2_01.png[] +image:components/proposals/collaborative_drafts/collaborative_draft_edited_versions_show_v2_02.png[] +. Once Alice is satisfied with the collaborative draft, she can publish it by click in the "Publish" button +image:components/proposals/collaborative_drafts/publish_modal.png[] +. When it's published it becomes a proposal +image:components/proposals/collaborative_drafts/proposal.png[] +image:components/proposals/collaborative_drafts/proposals_list02.png[] +. And the collaborative draft is still visible although it can't be edited anymore +image:components/proposals/collaborative_drafts/collaborative_draft_published.png[] + +== Important aspects + +- A collaborative draft can has any number of authors. +- Only the original author can approve or reject the collaboration requests. +- Only the original author can publish the collaborative draft. +- Only the original author can withdraw the collaborative draft. +- Once a collaboration request is approved, it can't be rejected. \ No newline at end of file From a87e68278d4fafc391bcc9a2c34d52ee81697b71 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:57 +0200 Subject: [PATCH 023/336] New translations participatory_texts.adoc (French) --- .../proposals/participatory_texts.adoc | 88 +++++++++++++++++++ 1 file changed, 88 insertions(+) create mode 100644 docs/fr/modules/admin/pages/components/proposals/participatory_texts.adoc diff --git a/docs/fr/modules/admin/pages/components/proposals/participatory_texts.adoc b/docs/fr/modules/admin/pages/components/proposals/participatory_texts.adoc new file mode 100644 index 0000000000..c5573a6e6d --- /dev/null +++ b/docs/fr/modules/admin/pages/components/proposals/participatory_texts.adoc @@ -0,0 +1,88 @@ += Participatory texts + +This feature allows you to navigate the proposals as text. It's useful for discussing normatives, plans, or other kinds of texts. + +Every paragraph is split into a proposal, so it's possible to discuss it in a more granular way. + +Some examples of where this feature was used are: + +* https://concertation.greenpeace.fr/processes/vision-greenpeace/f/8/[Vision Greenpeace] in https://concertation.greenpeace.fr/[Greenpeace France Concertation] +* https://www.decidim.barcelona/processes/PAM2020/f/3771/[Procés participatiu del Programa d'Actuació Municipal (PAM) 2020-2023] in https://www.decidim.barcelona/[Decidim Barcelona] + +image:components/proposals/participatory_texts/example01.png[Vision Greenpeace] + +image:components/proposals/participatory_texts/example02.png[PAM 2020-2023 in Decidim Barcelona] + +To configure the "Participatory texts" in proposals component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Go to components +. Click on "Add component" button +. Click on "Proposals" +. Check the "Participatory texts enabled" setting +. Save the component +. Click in the "Participatory texts" button in the empty proposals component +image:components/proposals/participatory_texts/manage_proposals.png[Manage proposals] +. Click in the "Import document" button in the empty Preview participatory text panel +image:components/proposals/participatory_texts/preview_participatory_text_empty.png[Preview empty participatory text] +. Fill the xref:_add_document_form[Add document form] +image:components/proposals/participatory_texts/add_document_form.png[Add document form] +. xref:_preview_the_document[Preview the document] and make corrections +image:components/proposals/participatory_texts/preview_participatory_text.png[Preview participatory text] +. Click on publish the document +image:components/proposals/participatory_texts/imported_document_proposals.png[Imported document proposals] +. Publish the proposal component + +Notice that this feature could break existing proposals, so if there is any proposal it will not work. You'll see the +following message in the components settings: + +==== +Cannot interact with this setting if there are existing proposals. Please, create a new `Proposals component` if you want +to enable this feature or discard all imported proposals in the `Participatory Texts` menu if you want to disable it. +==== + +== Add document form + +Although it's possible to work with both Markdown (.MD) and ODT (.ODT) files, we recommend working with Markdown as it's +easier to see the formatting. + +link:{attachmentsdir}/participatory_text.md[Download the example participatory text]. + +image:components/proposals/participatory_texts/add_document_form.png[Add document form] + + +.Add document form +|=== +|Field |Type |Description + +|Title +|Required +|What's the title of the document? + +|Description +|Optional +|Description for the document + +|Document +|Required +|File. Add a document lesser than 2MB, each section until 3 levels deep will be parsed into proposals. Supported formats are: Markdown, ODT +|=== + +== Preview the document + +After the document is initially imported you have three options: + +. Discard +. Save draft +. Publish document + +== Frontend + +Once the document is imported and the proposals component published, you'll be able to navigate the document: + +image:components/proposals/participatory_texts/frontend.png[Frontend] +image:components/proposals/participatory_texts/frontend_hover.png[Frontend hover in proposal] +image:components/proposals/participatory_texts/frontend_proposal.png[Frontend proposal detail] \ No newline at end of file From ffab20002db8afb8cbd5485cf78a427ccad61c89 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:58 +0200 Subject: [PATCH 024/336] New translations skeleton.adoc (French) --- .../admin/pages/components/skeleton.adoc | 167 ++++++++++++++++++ 1 file changed, 167 insertions(+) create mode 100644 docs/fr/modules/admin/pages/components/skeleton.adoc diff --git a/docs/fr/modules/admin/pages/components/skeleton.adoc b/docs/fr/modules/admin/pages/components/skeleton.adoc new file mode 100644 index 0000000000..a0bbfcdb51 --- /dev/null +++ b/docs/fr/modules/admin/pages/components/skeleton.adoc @@ -0,0 +1,167 @@ += Skeleton + +The Skeleton component allows people to XXX + +From this starting point, there could be other configurations, such as: + +* + +Some examples of where this component was used: + +* + +image:components/skeleton/example01.png[] +image:components/skeleton/example02.png[] +image:components/skeleton/example03.png[] +image:components/skeleton/example04.png[] + +To configure the Skeleton component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies" or "Conferences". +. Go to components +. Click on "Add component" button +. Click on "Skeleton" +. Fill the xref:_add_component[Add component] form + +== Add component + +image:components/skeleton/component.png[Add component form] + + +.Add component: Skeleton form +|=== +|Field |Type |Description + +|Name +|Required +|What is the title of this component. For instance, "Skeletons" + +|Order position +|Optional +|Which order will it have in relation to the other skeletons. Having a lower number means a higher priority. +For instance, if you have two skeletons, "Skeleton a" with weight "10" and "Skeleton b" with weight "0", then "Skeleton b" will be first when ordering. +|=== + + +.Add component: Skeleton form - Global settings +|=== +|Field |Type |Description + +|Scopes enabled +|Optional +|Check if you want to have Scopes filtering in this component. + +|Scope +|Optional +|Which xref:admin:scopes.adoc[Scope] does this component belongs to. + +|Global scope +|Optional +| + +|Comments enabled +|Optional +|Whether you want to have comments in the meetings. + +|Comments max length +|Optional +|What is the characters limit that participants will have when making comments. Leave 0 for default value. + +|Actions permissions can be set for each skeleton +|Optional +|Whether you want to be able to set permissions for every one of the skeletons. Most of the time you will want to leave this option disabled. + +|Announcement +|Optional +|A general announcement that'll be visible on the general skeletons landing page. +|=== + +In the cases where the space that this component will be used has xref:admin:spaces/processes/phases.adoc[Phases], for instance, in +xref:admin:spaces/processes.adoc[Participatory Processes], then you can also define different behaviors per Step. + + +.Add component: Skeletons form - Step settings +|=== +|Field |Type |Description + +|Comments blocked +|Optional +|Whether you want to enable comments for this phase. + +|Announcement +|Optional +|A general announcement that'll be visible on the general skeleton landing page. +|=== + +== Permissions + +An administrator can choose which kind of xref:customize:authorizations.adoc[Authorizations] a participant need to have to make +certain actions in the skeletons: + +* Create +* Endorse + +== Manage skeletons + +image:components/skeleton/manage_skeletons.png[Manage skeletons table] + +=== Export all + +Allows exporting the skeletons in different formats. + +* Skeletons as CSV +* Skeletons as JSON +* Skeletons as Excel +* Comments as CSV +* Comments as JSON +* Comments as Excel + +=== New skeleton form + +image:components/skeleton/new_skeleton.png[New skeleton form] + + +.New skeleton form +|=== +|Field |Type |Description + +|Title +|Required +|What is the title of this skeleton. For instance, "District A" + +|Order position +|Optional +|Which order will it have in relation to the other skeletons. Having a lower number means a higher priority. +For instance, if you have two skeletons, "Skeleton a" with weight "10" and "Skeleton b" with weight "0", then "Skeleton b" will be first when ordering. + +|Description +|Optional +|What is the description of this skeleton. +|=== + +==== Actions + + +.Actions +|=== +|Icon |Name |Definition + +|image:action_preview.png[Preview icon] +|Preview +|To see how it's shown in the frontend to participants. + +|image:action_list.png[Manage projects icon] +|xref:_manage_projects[Manage projects] +|Allows you to manage the projects of a skeleton. + +|image:action_edit.png[Edit icon] +|Edit +|Edit form for a skeleton. It's the same form as "New skeleton". + +|image:action_delete.png[Delete icon] +|Delete +|To delete this skeleton. Only can be done when there aren't any projects. +|=== \ No newline at end of file From 0f85c26b439a903e95216aab6961b2d78cd1e29d Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:53:59 +0200 Subject: [PATCH 025/336] New translations surveys.adoc (French) --- .../admin/pages/components/surveys.adoc | 256 ++++++++++++++++++ 1 file changed, 256 insertions(+) create mode 100644 docs/fr/modules/admin/pages/components/surveys.adoc diff --git a/docs/fr/modules/admin/pages/components/surveys.adoc b/docs/fr/modules/admin/pages/components/surveys.adoc new file mode 100644 index 0000000000..2b4fc6689a --- /dev/null +++ b/docs/fr/modules/admin/pages/components/surveys.adoc @@ -0,0 +1,256 @@ += Survey + +The Survey component allows people to answer questionnaires. This is useful when an organization wants to receive private +feedback, although it's possible to publish the answers manually as well. It allows defining a set of questions with multiple kinds of answers. + +From this starting point, there could be other configurations, such as: + +* if the answering is limited to a time period +* what answer types should have the questions, like short (one line), long (multiple lines), single or multiple options, +sorting through a list, etc. +* if there's an answer validation like how many characters as maximum should have an answer +* if there's a maximum number of options to select in multiple options questions + +Some examples of where this component was used: + +* https://consultation.quebec.ca/processes/donneesquebec/f/82/[Data Quebec: participate in its improvement! (Données Québec : participez à son amélioration!) in Québec consultations] +* https://meta.decidim.org/conferences/decidimfest2020/f/1403/?locale=en[DecidimFest2020 Assessment Survey] + +image:components/surveys/example01.png[Example of a survey] + +To configure the Survey component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies" or "Conferences". +. Go to components +. Click on "Add component" button +. Click on "Survey" +. Fill the xref:_add_component[Add component] form + +Once a survey is already answered by some users it's not possible to modify its questions, as that would affect the integrity +of the answers. If it's needed to modify the questions, then it's needed to create a new survey and unpublish the original one. + +== Add component + +image:components/surveys/component.png[Add component form] + + +.Add component: Survey form +|=== +|Field |Type |Description + +|Name +|Required +|What is the title of this component. For instance, "Surveys" + +|Order position +|Optional +|Which order will it have in relation to the other surveys. Having a lower number means a higher priority. +For instance, if you have two surveys, "Survey a" with weight "10" and "Survey b" with weight "0", then "Survey b" will be first when ordering. +|=== + + +.Add component: Survey form - Global settings +|=== +|Field |Type |Description + +|Scopes enabled +|Optional +|Check if you want to have Scopes filtering in this component. + +|Scope +|Optional +|Which xref:admin:scopes.adoc[Scope] does this component belongs to. + +|Answers accepted from +|Optional +|Start date when you want to receive answers. Leave blank for no specific date. Expected format: dd/mm/yyyy hh:ii + +|Answers accepted until +|End date when you want to stop receiving answers. Leave blank for no specific date. Expected format: dd/mm/yyyy hh:ii +|Announcement + +|Optional +|A general announcement that'll be visible on the general surveys landing page. +|Delete answers when publishing the survey +|=== + +In the cases where the space that this component will be used has xref:admin:spaces/processes/phases.adoc[Phases], for instance, in +xref:admin:spaces/processes.adoc[Participatory Processes], then you can also define different behaviors per Step. + + +.Add component: Surveys form - Step settings +|=== +|Field |Type |Description + +|Allow answers +|Optional +|Check if you want to receive answers in this survey. + +|Allow unregistered users to answer the survey +|Optional +|If active, no login will be required in order to answer the survey. This may lead to poor or unreliable data and it will +be more vulnerable to automated attacks. Use with caution! Mind that this option only allows an answer by browser session, +but participants can use the Private navigation option and make multiple answers with the same device. + +|Announcement +|Optional +|A general announcement that'll be visible on the general survey landing page. +|=== + +== Permissions + +An administrator can choose which kind of xref:customize:authorizations.adoc[Authorizations] a participant need to have to make +certain actions in the surveys: + +* Answer + +== New survey form + +When you create a new survey you'll need to fill the form with the following fields: + +image:components/surveys/edit_form.png[Edit survey form] + +NOTE: Do you have repetitive surveys? For instance the same feedback form for every process? You can have a survey that +gets copied and is used as a blueprint for so you don't have to manually configure the same survey everytime. Learn more +about xref:_templates[Templates]. + + +.New survey form +|=== +|Field |Type |Description + +|Title +|Required +|What is the title of this survey. For instance, "Feedback" + +|Description +|Optional +|What is the description of this survey. + +|Terms of service +|Required +|Legal conditions that the participants must agree to in order to answer the survey. +|=== + +In the bottom of this form there's a button that allows you to "Add question". + +image:components/surveys/add_question_button.png[] + +You can add multiple questions per survey, and reorder or delete them. It's possible to also add separators between questions. + +Every question has to have a statement and a type as a minimum. + +image:components/surveys/question_form.png[] + + +.Add question form +|=== +|Field |Type |Description + +|Statement +|Required +|The question itself. For instance, "What is your age category?" + +|Description +|Optional +|Explanation of the question being made. + +|Mandatory +|Optional +|Check if this question is required to respond to submit the answer. + +|Character limit +|Optional +|How many characters has as a maxim the answer to this question. Leave to 0 if no limit. Compatible with Short and Long answer question types. + +|Type +|Required +|One of the following: Short answer, Long answer, Single option, Multiple option, Sorting, Files, Matrix (Single option) +or Matrix (Multiple option). See xref:_question_types[Question types] for more information. +|=== + +Depending in the question type, it's possible to add validations to the answers, like if the question is mandatory (participants +would need to provide an answer in order to submit the form) or if the answer is limited to a certain number of characters as maximum in +short and long answers. + +image:components/surveys/question_form_limits_backend.png[] + +image:components/surveys/question_form_limits_frontend.png[] + +== Question types + +A survey can have multiple questions with different types, such as: + +- Short answer +- Long answer +- Single option +- Multiple option +- Sorting +- Files +- Matrix (Single option) +- Matrix (Multiple option) + + +.Question types (click to view image in detail) +|=== +|Type |Frontend |Backend |Description + +|Short answer +|image:components/surveys/type_short_answer_frontend.png[Short answer type - frontend,link=../_images/components/surveys/type_short_answer_frontend.png] +|image:components/surveys/type_short_answer_backend.png[Short answer type - backend,link=../_images/components/surveys/type_short_answer_backend.png] +|Compatible with "Character limit" validation + +|Long answer +|image:components/surveys/type_long_answer_frontend.png[Long answer type - frontend,link=../_images/components/surveys/type_long_answer_frontend.png] +|image:components/surveys/type_long_answer_backend.png[Long answer type - backend,link=../_images/components/surveys/type_long_answer_backend.png] +|Compatible with "Character limit" validation + +|Single option +|image:components/surveys/type_single_option_frontend.png[Single option type - frontend,link=../_images/components/surveys/type_single_option_frontend.png] +|image:components/surveys/type_single_option_backend.png[Single option type - backend,link=../_images/components/surveys/type_single_option_backend.png] +|Participants will have to choose a single option, with radio buttons. At least 2 options always. It's possible to define a "Free text" option, so participants can submit their own answer. + +|Multiple option +|image:components/surveys/type_multiple_option_frontend.png[Multiple option type - frontend,link=../_images/components/surveys/type_multiple_option_frontend.png] +|image:components/surveys/type_multiple_option_backend.png[Multiple option type - backend,link=../_images/components/surveys/type_multiple_option_backend.png] +|Participants will have to choose multiple options, with checkboxes. At least 2 options always. It's possible to add a validation, with the maximum number of choices. It's possible to define a "Free text" option, so participants can submit their own answer. + +|Sorting +|image:components/surveys/type_sorting_frontend.png[Sorting type - frontend,link=../_images/components/surveys/type_sorting_frontend.png] +|image:components/surveys/type_sorting_backend.png[Sorting type - backend,link=../_images/components/surveys/type_sorting_backend.png] +|At least 2 options always. Participants will click in order of preference to sort. + +|Files +|image:components/surveys/type_files_frontend.png[Files type - frontend,link=../_images/components/surveys/type_files_frontend.png] +|image:components/surveys/type_files_backend.png[Files type - backend,link=../_images/components/surveys/type_files_backend.png] +|Participants will be able to upload files. + +|Matrix (Single option) +|image:components/surveys/type_matrix_single_option_frontend.png[Matrix (Single option) type - frontend,link=../_images/components/surveys/type_matrix_single_option_frontend.png] +|image:components/surveys/type_matrix_single_option_backend.png[Matrix (Single option) type - backend,link=../_images/components/surveys/type_matrix_single_option_backend.png] +|Participants will have to choose between rows and columns of single options, with radio buttons. + +|Matrix (Multiple option) +|image:components/surveys/type_matrix_multiple_option_frontend.png[Matrix (Multiple option) type - frontend,link=../_images/components/surveys/type_matrix_multiple_option_frontend.png] +|image:components/surveys/type_matrix_multiple_option_backend.png[Matrix (Multiple option) type - backend,link=../_images/components/surveys/type_matrix_multiple_option_backend.png] +|Participants will have to choose between rows and columns of multiple options, with checkboxes. +|=== + +== Templates + +For the cases where administrators need to define multiple surveys that are mostly the same but used in different contexts, +it's possible to define a template. When there's one defined for a survey, then it'll ask to select the Template and create +the survey based on this one or in the other hand if there's no need to use a template, then it's possible to Skip the template +selection. + +image:components/surveys/edit_questionnaire.png[Choose template form] + +== Export answers + +It's possible to export the survey participant answers to different formats: CSV, JSON, XLSX (Excel) or PDF. + +Note that the platform doesn't handle the answers processing nor presenting results or summary to the users, that need to be +done externally. \ No newline at end of file From a8718a3eafdbe5e5e0658dd701181c1e3123bb0b Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:01 +0200 Subject: [PATCH 026/336] New translations configuration.adoc (French) --- .../fr/modules/admin/pages/configuration.adoc | 53 +++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 docs/fr/modules/admin/pages/configuration.adoc diff --git a/docs/fr/modules/admin/pages/configuration.adoc b/docs/fr/modules/admin/pages/configuration.adoc new file mode 100644 index 0000000000..eae6e6a6e3 --- /dev/null +++ b/docs/fr/modules/admin/pages/configuration.adoc @@ -0,0 +1,53 @@ += Configuration + +In this page you can configure general settings from Decidim. + +image::admin_configuration.png[Decidim Admin Configuration] + +These are: + +* **Name**. Required. The name that the platform has. Visible at title, emails, etc. +* **Social**. Social handlers for different social networks. Visible at the footer in every page. This are: +** Twitter +** Facebook +** Instagram +** YouTube +** GitHub + +image::settings_configuration_social.png[Social networks configuration in Decidim] + +* **Default locale**. Required. +* **Time Zone**. Required. In which Time Zone is your organization. Used by things like calendars in Meetings. +* **Reference prefix**. Required. +* **Enable badges**. Whether you want or not that your participants have badges as a gamification mechanism, for instance for creating proposals or making comments. +* **Enable groups**. Whether you want or not that your participants have the possibility to create xref:participants/groups.adoc[User Groups]. Useful for example for associations or other collectives. +* **Enable rich text editor for participants**. Whether you want or not that your participants have the possibility to have a https://en.wikipedia.org/wiki/WYSIWYG[What You See Is What You Get (WYSIWYG) editor]. In some text areas, participants will be able to insert some HTML tags by using the rich text editor. +* **Send welcome notification**. Whether you want or not that your participants receive a notification when their first created their account. If enabled you can customize this notification. +** **Customize welcome notification**. +** **Welcome notification subject**. +** **Welcome notification body**. + +.Welcome notification +==== +Hi {\{name}}, thanks for joining {\{organization}} and welcome! + +If you want to get a quick idea of what you can do here, have a look at the Help section. +Once you have read it you will get your first badge. Here's a list of all the badges you can get as you participate in {\{organization}} + +Last but not least, join other people, share with them the experience of being engaged and participating in {\{organization}}. Make proposals, comments, debate, think about how to contribute to the common good, provide arguments to convince, listen and read to be convinced, express your ideas in a concrete and direct way, respond with patience and decision, defend your ideas and keep an open mind to collaborate and join other people's ideas. +==== + +image::settings_configuration_welcome.png[Welcome notification configuration in Decidim] + +* **Admin terms of use body**. Which message an Administrator user will see when accessing for the first time to the Administration panel. + +.Admin terms of use +==== +ADMIN TERMS OF USE + +We trust you have received the usual lecture from the local System Administrator. It usually boils down to these three things: + +* Respect the privacy of others. +* Think before you click. +* With great power comes great responsibility. +==== \ No newline at end of file From c430a0ce071c98ae0c8ddafa5c80922d544874fd Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:03 +0200 Subject: [PATCH 027/336] New translations dashboard.adoc (French) --- docs/fr/modules/admin/pages/dashboard.adoc | 23 ++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 docs/fr/modules/admin/pages/dashboard.adoc diff --git a/docs/fr/modules/admin/pages/dashboard.adoc b/docs/fr/modules/admin/pages/dashboard.adoc new file mode 100644 index 0000000000..bf2fc64564 --- /dev/null +++ b/docs/fr/modules/admin/pages/dashboard.adoc @@ -0,0 +1,23 @@ += Dashboard + +For your first time accessing to a Decidim plaform as Admin, you'll receive an invitation email so you can finish setting up your account with your nickname, name and password. + +Once you've finished and you're logged-in, you'll be able to access the Admin panel, starting with the Dashboard page. For this you'll need to click on your username, and click on "Admin dashboard". + +image::admin_dashboard_menu.png[Decidim Admin Dashboard in user menu] + +Here, you'll have a summary of the last activity of the platform. + +image::admin_dashboard.png[Decidim Admin Dashboard] + +You'll have three blocks: + +1. Activity: participants and admins that had logged in in last month, last week and last day. +1. Metrics: the graphics for the evolution of multiple things inside of Decidim: +* Participants +* Proposals +* Comments +* Meetings +* Accepted proposals +* Results +1. Admin log: last actions made by Administrator users in the platform. \ No newline at end of file From 6b11064fa465851144bd6ee6db0aa7976fb35bd7 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:04 +0200 Subject: [PATCH 028/336] New translations badges.adoc (French) --- .../modules/admin/pages/features/badges.adoc | 76 +++++++++++++++++++ 1 file changed, 76 insertions(+) create mode 100644 docs/fr/modules/admin/pages/features/badges.adoc diff --git a/docs/fr/modules/admin/pages/features/badges.adoc b/docs/fr/modules/admin/pages/features/badges.adoc new file mode 100644 index 0000000000..6cf9a138d3 --- /dev/null +++ b/docs/fr/modules/admin/pages/features/badges.adoc @@ -0,0 +1,76 @@ += Badges + +Badges are recognitions to participant actions and progress in the platform. As participants start discovering, participating +and interacting in the platform, they will earn different badges. Here is the list of badges and some ways participants can earn them. + +It's a https://en.wikipedia.org/wiki/Gamification[gamification] mechanism to improve the engagement of the participants in a ludic way. + +The badges a participant has are visible in her account. There's also a general explanation page with a short description of every badge. + +image:features/badges/example01.png[Example of badges in profile] + +When a participant earns a badge she receives a notification. + +image:features/badges/notification.png[Example of badges notification] + +Badges have multiple levels, depending in the number of times she has made the action. For instance, for Proposals badge +she'll receive the first level badge when arriving at 1 follower, the second level at 15 followers, the third level at 30 followers, +the fourth level at 60 and the fifth level at 100. + + +.Badges +|=== +|Image |Title |Description |How it's earned |Levels + +|image:features/badges/accepted_proposals_badge.png[Accepted proposals badge] +|Accepted proposals +|Granted when particiapnts actively participate with new proposals and these are accepted. +|The participant needs to choose the participation space of her interest with submission for proposals enabled and try to +make proposals that can be carried out. This way they are more likely to be accepted. +|1, 5, 15, 30, 50 + +|image:features/badges/attended_meetings_badge.png[Attended meetings badge] +|Attended meetings +|Granted when participants attend several face-to-face meetings. +|The participant needs to register for the meetings she want to attend +|1, 3, 5, 10, 30 + +|image:features/badges/debates_badge.png[Debates badge] +|Debates +|Granted when participants actively participate in the different debates by leaving comments. +|The participant needs to take part in debates. +|1, 5, 10, 30, 50 + +|image:features/badges/followers_badge.png[Followers badge] +|Followers +|Granted when participant reach a certain number of followers. The platform is a social and political network, so +participants ned to weave their web to communicate with other people in the platform. +|The participant needs to be be active and follow other people. That will surely make other people follow her. +|1, 15, 30, 60, 100 + +|image:features/badges/published_initiatives_badge.png[Published initiatives badge] +|Published initiatives +|Granted when a participant launch new initiatives, partnering with others to carry them out. +|The participant needs to go to the participation space of Intiatives and follow the steps to create a new initiative. +|1, 5, 15, 30, 50 + +|image:features/badges/invitations_badge.png[invitations badge] +|Invitations +|Granted when participants invite some people and they have become participants. +|The participant needs to use the “invite friends” link on her user page to invite her friends. She can customize the +message she's sending. She’ll level up by sending invitations and getting them registered. Note that this feature is disabled +and this badge is not available, so it'll be removed in the future. +|1, 5, 10, 30, 50 + +|image:features/badges/proposal_supports_badge.png[Proposal supports badge] +|Proposal supports +|Granted when participants support other people's proposals. +|The participant needs to browse and spend some time reading other people's proposals and give support to the proposals she like or find interesting. +|5, 15, 50, 100, 500 + +|image:features/badges/proposals_badge.png[Proposals badge] +|Proposals +|Granted when participants actively participate with new proposals. +|The participant needs to choose the participation space of her interest with submission for proposals enabled and create a new proposal. +|1, 5, 10, 30, 60 +|=== \ No newline at end of file From ba813e3f7a78449f103310bf5cc341d8dc0bc8ba Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:05 +0200 Subject: [PATCH 029/336] New translations comments.adoc (French) --- .../admin/pages/features/comments.adoc | 64 +++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 docs/fr/modules/admin/pages/features/comments.adoc diff --git a/docs/fr/modules/admin/pages/features/comments.adoc b/docs/fr/modules/admin/pages/features/comments.adoc new file mode 100644 index 0000000000..43bd35408c --- /dev/null +++ b/docs/fr/modules/admin/pages/features/comments.adoc @@ -0,0 +1,64 @@ += Comments + +Comments are public messages left to the rest of the community. It allows participants to share information or opinions +about a proposal, debate, meeting, initiative, etc. + +image:features/comments/example01.png[Comments example] + +== Create a comment + +. Sign in as a participant +. Go to the content that you want to leave a comment +. Go to the bottom of the page +. Fill the "Add comment" form + +Depending on the component settings, this feature can be disabled. + +image:features/comments/form.png[Comments form] + +=== Form + +It's possible to: + +. mention a participant or user group (like @admin). They'll receive a notification +. add a hashtag (like #Example). This will link to the general search +. make a quote of a comment (like > this is a quote) +. if an URL is entered, then it'll be linked automatically +image:features/comments/rich_text_write.png[Comments with rich text (write)] +image:features/comments/rich_text_read.png[Comments with rich text (read)] +image:features/comments/hashtag_search.png[Hashtags in comments] +. if HTML is added, it'll be escaped and not shown +image:features/comments/xss_write.png[XSS in comments (write)] +image:features/comments/xss_read.png[XSS in comments (read)] +. add emojis to comments +image:features/comments/emoji_selector.png[Emoji selector in comments] + +== Sort + +Comments can be sorted by "Best rated", "Recent", "Older" or "More discussed". + +image:features/comments/order_by.png[Order comments] + +== Actions + +After a comment is created, the author can "Reply", "Report", "Get link", "Edit" and "Delete". Other participants can "Reply", "Report" and "Get link". Some of these actions are visible in the three dots menu: + +image:features/comments/actions.png[Comments actions] + +=== Reply + +It's possible to reply to comments until the 4th anidation level. + +image:features/comments/anidation_levels.png[Anidation levels for comments] + +=== Delete + +Once a comment is deleted is not longer visible. + +image:features/comments/deleted_comment.png[Deleted comment] + +=== Edit + +Once a comment is edited then it's shown that was edited. It doesn't have a version history of the changes made. + +image:features/comments/edited_comment.png[Edited comment] \ No newline at end of file From 740079910cb9eaadb2fd6b6cef6fd82b39a9ab44 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:06 +0200 Subject: [PATCH 030/336] New translations conversations.adoc (French) --- .../admin/pages/features/conversations.adoc | 57 +++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 docs/fr/modules/admin/pages/features/conversations.adoc diff --git a/docs/fr/modules/admin/pages/features/conversations.adoc b/docs/fr/modules/admin/pages/features/conversations.adoc new file mode 100644 index 0000000000..4165c50e1d --- /dev/null +++ b/docs/fr/modules/admin/pages/features/conversations.adoc @@ -0,0 +1,57 @@ += Conversations + +With conversations, participants can have private messaging with each other. Only the participants who are in the +conversation can see each others messages. + +A conversation can be started with any participant or group registered on the platform. + +image:features/conversations/conversation.png[Example of a conversation] + +To start a conversations: + +. Sign in as participant +. Go to the participant profile that you want to start a conversation with +image:features/conversations/profile.png[Participant profile] +. Click on the contact icon image:icon_envelope.png[Envelope icon] +. Fill the form +image:features/conversations/start_a_conversation_form.png[Start a conversation form] + +Alternatively, you could also: + +. Sign in as participant +. Click on the conversation icon in the header image:icon_envelope_off.png[Conversations icon] +. Click on the "Start conversation" button +. Search the participant or group that you want to start a conversation with +. Fill the form + +If there are new messages in a conversation, then the participant will see the icon with a color image:icon_envelope_on.png[Conversation icon with color] + +image:features/conversations/conversations.png[Conversations list] + +== Multiple participants in a conversation + +It's possible to have multiple participants in a conversation. + +For this, you need to: + +. Sign in as participant +. Click on the conversation icon in the header image:icon_envelope_off.png[Conversations icon] +. Click on the "Start conversation" button +. Search the participants or groups that you want to start a conversation with +. Fill the form + +image:features/conversations/new_conversation_modal.png[New conversation modal] + +== Group converations + +Just like with participants, is possible to have converstaions with groups. + +image:features/conversations/group_conversations.png[Group conversations list] +image:features/conversations/conversations_group_counter.png[Conversations group counter] + +== Notes + +Some things to consider about conversations: + +* It's not possible to delete a conversation. +* It's not possible to edit a message in a conversation. \ No newline at end of file From 4a70951db22ec6f5def6317e9b80ed4fcae2ff1a Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:07 +0200 Subject: [PATCH 031/336] New translations embed.adoc (French) --- .../modules/admin/pages/features/embed.adoc | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 docs/fr/modules/admin/pages/features/embed.adoc diff --git a/docs/fr/modules/admin/pages/features/embed.adoc b/docs/fr/modules/admin/pages/features/embed.adoc new file mode 100644 index 0000000000..c35bf2bca7 --- /dev/null +++ b/docs/fr/modules/admin/pages/features/embed.adoc @@ -0,0 +1,23 @@ += Embed + +Sometimes you want to embed some content to an external page. For this you can use the `Embed` feature. + +image:features/embed/example.png[A proposal card embeded in another page] + +== How to embed + +. Navigate to the content you want to embed. +. Click on the `Embed` link in the sidebar. image:features/embed/link.png[] +image:features/embed/sidebar.png[] +. Copy the code from the modal. +image:features/embed/modal.png[] +. Paste that code in the external page where you want to embed it. The CMS or platform that you're using needs to supports +changing HTML code. + +An example of this code is: + +[source,html] +---- + + +---- \ No newline at end of file From 55e1ae45b6a4c22b4dbb198abb21b81f5426fb0d Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:09 +0200 Subject: [PATCH 032/336] New translations endorsements.adoc (French) --- .../admin/pages/features/endorsements.adoc | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 docs/fr/modules/admin/pages/features/endorsements.adoc diff --git a/docs/fr/modules/admin/pages/features/endorsements.adoc b/docs/fr/modules/admin/pages/features/endorsements.adoc new file mode 100644 index 0000000000..b407e0ca97 --- /dev/null +++ b/docs/fr/modules/admin/pages/features/endorsements.adoc @@ -0,0 +1,17 @@ += Endorsements + +Through endorsements, participants can publicly show that they want to support a particular content, for instance, a proposal. + +image:features/endorsements/list.png[List of endorsements] + +This is done through the button in the sidebar. Administrators can enable or disable them by step in a given participatory process, and they can also define permissions with authorizations. + +image:features/endorsements/sidebar.png[Endorsement button in sidebar] + +When a participant belongs to a verified group she can also endorse like that group by selecting the identity. + +image:features/endorsements/modal.png[Select identity modal] + +By default the endorsements list is collapsed. To see it fully visitors need too click in the "(see more)" link. + +image:features/endorsements/full_list.png[Full list of endorsements] \ No newline at end of file From 0ad3b1a13f09e4cbf9d06138315f88792db92186 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:10 +0200 Subject: [PATCH 033/336] New translations fingerprint.adoc (French) --- .../admin/pages/features/fingerprint.adoc | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 docs/fr/modules/admin/pages/features/fingerprint.adoc diff --git a/docs/fr/modules/admin/pages/features/fingerprint.adoc b/docs/fr/modules/admin/pages/features/fingerprint.adoc new file mode 100644 index 0000000000..0a4c43d309 --- /dev/null +++ b/docs/fr/modules/admin/pages/features/fingerprint.adoc @@ -0,0 +1,29 @@ += Fingerprint + +Although the platform should show the xref:admin:features/versions.adoc[Versions] for almost all of the contents, it'd be +still possible to manipulate the content by directly editing the database. + +As mitigation for this risk, the platform shows a fingerprint for some important fields, for instance, a proposal body and title. + +image:features/fingerprint/modal.png[Check fingerprint modal] + +Its goal is to provide a way to give an informal "receipt" to a participant to they can detect tampering. A fingerprint is +a hashed representation of the content. It's useful to ensure the content hasn't been tampered with, as a single modification +would result in a totally different value. It's calculated using a SHA256 hashing algorithm. In order to replicate it +yourself, you can use a http://www.md5calc.com/sha256[MD5 calculator online] and copy-paste the source data. + +== Check fingerprint + +. Go to the content that you want to check the fingerprint +. Click in the "Check fingerprint" link in the sidebar +image:features/fingerprint/sidebar.png[Check fingerprint link in sidebar] +. Follow the modal instructions + +image:features/fingerprint/md5calc.png[MD5calc.com screenshot] + +It's possible to check the fingerprint with other tools, such as the sha256sum command line tool. + +[source,bash] +---- +echo -n '{"body":{"en":"

**Is your feature request related to a problem? Please describe.**

It would be useful to set a character limit on questionnaire answers to provide guidance for users regarding how long their answers should be.


**Describe the solution you\'d like**

To have a number input field next to each question in the admin, labeled \\"Character limit\\", by default set to zero (no limit), which determines the maximum characters the user answers to those questions can have.


**Describe alternatives you\'ve considered**

Another possibility could be to define this globally for the questionnaire, setting the character limit for each type of question.


**Additional context**

-


**Could this issue impact on users private data?**

No


**Funded by**

Fundació Bosch i Guimpera

"},"title":{"en":"Maximum characters for questionnaire text answers"}}' | sha256sum +---- \ No newline at end of file From 23519e649080f6ec0f87be7b704fbe72e984ef91 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:11 +0200 Subject: [PATCH 034/336] New translations follows.adoc (French) --- .../modules/admin/pages/features/follows.adoc | 27 +++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 docs/fr/modules/admin/pages/features/follows.adoc diff --git a/docs/fr/modules/admin/pages/features/follows.adoc b/docs/fr/modules/admin/pages/features/follows.adoc new file mode 100644 index 0000000000..405b49e053 --- /dev/null +++ b/docs/fr/modules/admin/pages/features/follows.adoc @@ -0,0 +1,27 @@ += Follows + +Most of the contents in Decidim allows to be followed. This means that you'll receive xref:features/notifications.adoc[notifications] +of the activity being made by the thing you're following. + +You can control these notifications in the xref:features/my_account/notifications_settings.adoc[settings of your account]. + +The activity of the things that you're following is visible in your profile timeline. + +For following a thing: + +. Navigate to whatever you want to follow. +. Click in the "Follow" button. +image:button_follow.png[Follow button] +. You'll see the "Follow" button disappear and the "Stop following" button appear. + +To unfollow a thing: + +. Navigate to whatever you want to unfollow. +. Click in the "Stop following" button. +image:button_stop_following.png[Stop following button] +. You'll see the "Stop following" button disappear and the "Follow" button appear. + +Administrators by default follow all the new spaces that are created in the Decidim platform. + +A participant can also follow another participants. This is public and it's visible in the profile sections +follows and followers. \ No newline at end of file From a35c46a974031ad19ea8077a226164f7355f67f9 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:12 +0200 Subject: [PATCH 035/336] New translations metrics.adoc (French) --- docs/fr/modules/admin/pages/features/metrics.adoc | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 docs/fr/modules/admin/pages/features/metrics.adoc diff --git a/docs/fr/modules/admin/pages/features/metrics.adoc b/docs/fr/modules/admin/pages/features/metrics.adoc new file mode 100644 index 0000000000..0e98422d88 --- /dev/null +++ b/docs/fr/modules/admin/pages/features/metrics.adoc @@ -0,0 +1,15 @@ += Metrics + +NOTE: Looking for how to enable this feature technically? Go to xref:develop:metrics.adoc[Metrics in Developers guide] + +With Metrics participants can see the evolution in time of some resources, such as Proposals, Supports, Endorsements, Followers, Participants, Accepted propsoals, Comments, etc. You can see a real world example of this in https://meta.decidim.org/processes/roadmap/all-metrics[Metadecidim Roadmap process]. + +For this to work it needs to be first xref:develop:metrics.adoc[configured technically] and also enabled by the setting in the participatory space (`Show metrics` checkbox). + +Then this section will be visible in the space landing page. + +image:features/metrics/example.png[Example of metrics] + +By clicking in "Show all metrics", visitors can see other metrics and download this data in CSV format. + +image:features/metrics/page.png[Metrics page] \ No newline at end of file From 7124e5c3667e4bc97962b3f356c1e28c5e19ccca Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:14 +0200 Subject: [PATCH 036/336] New translations my_account.adoc (French) --- .../admin/pages/features/my_account.adoc | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 docs/fr/modules/admin/pages/features/my_account.adoc diff --git a/docs/fr/modules/admin/pages/features/my_account.adoc b/docs/fr/modules/admin/pages/features/my_account.adoc new file mode 100644 index 0000000000..41b67d0b4b --- /dev/null +++ b/docs/fr/modules/admin/pages/features/my_account.adoc @@ -0,0 +1,19 @@ += My account + +My account is all the pages where a participant can change her personal data that is displayed in My public profile page, change her notifications settings, see which groups she belongs, etc. + +To go to this section: + +. Sign in as a participant +. Click in the name of the participant in the header +. Click in "My account" + +The actions that she can do are: + +* xref:admin:features/my_account/account.adoc[Account] +* xref:admin:features/my_account/notifications_settings.adoc[Notifications settings] +* xref:admin:features/my_account/authorizations.adoc[Authorizations] +* xref:admin:features/my_account/groups.adoc[Groups] +* xref:admin:features/my_account/my_interests.adoc[My interests] +* xref:admin:features/my_account/my_data.adoc[My data] +* xref:admin:features/my_account/delete_my_account.adoc[Delete my account] \ No newline at end of file From ac71bbaa3082fa0712e5f225fb53144a4d487491 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:15 +0200 Subject: [PATCH 037/336] New translations account.adoc (French) --- .../pages/features/my_account/account.adoc | 47 +++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 docs/fr/modules/admin/pages/features/my_account/account.adoc diff --git a/docs/fr/modules/admin/pages/features/my_account/account.adoc b/docs/fr/modules/admin/pages/features/my_account/account.adoc new file mode 100644 index 0000000000..f1352a9738 --- /dev/null +++ b/docs/fr/modules/admin/pages/features/my_account/account.adoc @@ -0,0 +1,47 @@ += Account + +In this section is possible to make modifications that will be visible in the participants public profile and also modify the email address or the language that the platform will use with the user. + +. Sign in as a participant +. Click in the name of the participant in the header +. Click in "My account" + +image:features/my_account/account.png[My account form] + + +.Participant settings - My account form +|=== +|Field |Type |Description + +|Avatar +|Optional +|Avatar or picture for the participant. Guidance for image: Preferrably a landscape image that does not have any text. +The service crops the image. Maximum file size: 5MB + +|Your name +|Required +|The name of the participant. + +|Nickname +|Required +|The nickname of the participant. + +|Your email +|Required +|The email of the participant, where she'll receive notifications, password recovery, etc. If it's changed it needs to be +confirmed. + +|Personal URL +|Optional +|Metadata that is displayed in the participant's profile. + +|About +|Optional +|Metadata that is displayed in the participant's profile. + +|Locale +|Required +|Choose the language you want to use to browse and receive notifications in Decidim +|=== + +From this page is possible to also modify the participant's password. \ No newline at end of file From 52064c68878055efa6c627388b0830855596bb6c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:17 +0200 Subject: [PATCH 038/336] New translations authorizations.adoc (French) --- .../features/my_account/authorizations.adoc | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 docs/fr/modules/admin/pages/features/my_account/authorizations.adoc diff --git a/docs/fr/modules/admin/pages/features/my_account/authorizations.adoc b/docs/fr/modules/admin/pages/features/my_account/authorizations.adoc new file mode 100644 index 0000000000..3838e35959 --- /dev/null +++ b/docs/fr/modules/admin/pages/features/my_account/authorizations.adoc @@ -0,0 +1,23 @@ += Authorizations + +In this section participants will be able to review their Authorizations and see some metadata, like when it was granted +or the status of the authorization. + +It depends on how it's configured for the organization, as depending in the context (like normative or laws) it could work +in different ways. For more information about Authorizations see xref:admin:participants/authorizations.adoc[authorizations +in admin manual] and xref:customize:authorizations.adoc[authorizations in customize guide]. + +image:features/my_account/authorizations.png[Authorizations] + +To go to this section: + +. Sign in as a participant +. Click in the name of the participant in the header +. Click in "My account" +. Click in "Authorizations" in the sidebar + +For any given authorization, you can see the following information: + +* If it's not finished, when the authorization process started +* If it has finished and has been granted, the date when it was granted +* If the authorization provides it, some metadata, such as the scope of the authorization \ No newline at end of file From 3eaf9e637a05bbbb2fce280ae17d0b723d40a08c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:18 +0200 Subject: [PATCH 039/336] New translations delete_my_account.adoc (French) --- .../my_account/delete_my_account.adoc | 21 +++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 docs/fr/modules/admin/pages/features/my_account/delete_my_account.adoc diff --git a/docs/fr/modules/admin/pages/features/my_account/delete_my_account.adoc b/docs/fr/modules/admin/pages/features/my_account/delete_my_account.adoc new file mode 100644 index 0000000000..8ba403a53e --- /dev/null +++ b/docs/fr/modules/admin/pages/features/my_account/delete_my_account.adoc @@ -0,0 +1,21 @@ += Delete my account + +In this section participants will be able to delete their own accounts. This means that they will be unable to access the system anymore. This action is irreversible. All the contributions will be anonymized. + +image:features/my_account/delete_my_account.png[Delete my account form] + +To delete the account: + +. Sign in as a participant +. Click in the name of the participant in the header +. Click in "My account" +. Click in "Delete my account" in the sidebar +. Optionally, she can provide a reason for the deletion +. Click in "Delete my account" +. Click in "Yes, I want to delete my account" + +image:features/my_account/delete_my_account_confirm.png[Confirm account deletion] + +After the account has been deleted, the contributions (such as comments, proposals, etc), will be still visible but all the authorship information will be anonymized, belonging to an special kind of author called "Participant deleted": + +image:features/my_account/delete_my_account_deleted.png[Deleted participant contribution] \ No newline at end of file From 005856b7359a99ea43336516c6d78841fc2f723a Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:19 +0200 Subject: [PATCH 040/336] New translations groups.adoc (French) --- .../pages/features/my_account/groups.adoc | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 docs/fr/modules/admin/pages/features/my_account/groups.adoc diff --git a/docs/fr/modules/admin/pages/features/my_account/groups.adoc b/docs/fr/modules/admin/pages/features/my_account/groups.adoc new file mode 100644 index 0000000000..cad6c2d784 --- /dev/null +++ b/docs/fr/modules/admin/pages/features/my_account/groups.adoc @@ -0,0 +1,18 @@ += Groups + +In this section participants can see which Groups they belong to. + +NOTE: Want to create a new group? Go to the My public profile page. + +image:features/my_account/groups.png[Groups] + +To go to this section: + +. Sign in as a participant +. Click in the name of the participant in the header +. Click in "My account" +. Click in "Groups" in the sidebar + +Here you can see in which date the group was created and which status does it have (`pending` or `verified`). + +Read more about xref:admin:participants/groups.adoc[Groups in admin manual]. \ No newline at end of file From 354a83484eac78945a8c944ecf0381150d0123a7 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:20 +0200 Subject: [PATCH 041/336] New translations my_data.adoc (French) --- .../pages/features/my_account/my_data.adoc | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 docs/fr/modules/admin/pages/features/my_account/my_data.adoc diff --git a/docs/fr/modules/admin/pages/features/my_account/my_data.adoc b/docs/fr/modules/admin/pages/features/my_account/my_data.adoc new file mode 100644 index 0000000000..657fe4af9b --- /dev/null +++ b/docs/fr/modules/admin/pages/features/my_account/my_data.adoc @@ -0,0 +1,29 @@ += My data + +In this section participants can request a file with all the data that they've provided to the platform. + +image:features/my_account/my_data.png[My data] + +To request the data: + +. Sign in as a participant +. Click in the name of the participant in the header +. Click in "My account" +. Click in "My data" in the sidebar +. Click in "Request data" +. Wait a couple of minutes so the files are generated. It could depend in how many proposals, comments, etc you've made +. Go to your email account and find the received email +. Click in "Download" +. Open it with a support zip software +. Enter the password that you've received in the email +. Unzip or extract the contents + +image:features/my_account/my_data_email.png[My data] + +== Zip applications + +For opening the zip file, the software that you use need to support encryption with the AES-256 algorithm. Depending on your operating system you have multiple alternatives. + +* Windows: https://www.7-zip.org/[7-Zip] +* Mac: https://www.keka.io[Keka] +* GNU/Linux: File Roller (available through your package manager) or https://peazip.github.io/[PeaZip] \ No newline at end of file From fe4578fbf895fe138f2432b8a33655add1f074dc Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:21 +0200 Subject: [PATCH 042/336] New translations my_interests.adoc (French) --- .../pages/features/my_account/my_interests.adoc | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 docs/fr/modules/admin/pages/features/my_account/my_interests.adoc diff --git a/docs/fr/modules/admin/pages/features/my_account/my_interests.adoc b/docs/fr/modules/admin/pages/features/my_account/my_interests.adoc new file mode 100644 index 0000000000..df77a4d79b --- /dev/null +++ b/docs/fr/modules/admin/pages/features/my_account/my_interests.adoc @@ -0,0 +1,15 @@ += My interests + +In this section participants can choose which interests they have to receive more information about. + +By default what they see here is a list of all the xref:admin:scopes.adoc[Scopes] of the organization. Those selections +can be used by administrators when segmenting for the xref:admin:newsletters.adoc[Newsletters]. + +image:features/my_account/my_interests.png[My interests] + +To go to this section: + +. Sign in as a participant +. Click in the name of the participant in the header +. Click in "My account" +. Click in "My interests" in the sidebar \ No newline at end of file From 83e560723eb495147c281e258172b8cd1e95e9ea Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:22 +0200 Subject: [PATCH 043/336] New translations notifications_settings.adoc (French) --- .../my_account/notifications_settings.adoc | 26 +++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 docs/fr/modules/admin/pages/features/my_account/notifications_settings.adoc diff --git a/docs/fr/modules/admin/pages/features/my_account/notifications_settings.adoc b/docs/fr/modules/admin/pages/features/my_account/notifications_settings.adoc new file mode 100644 index 0000000000..ff949d0ad4 --- /dev/null +++ b/docs/fr/modules/admin/pages/features/my_account/notifications_settings.adoc @@ -0,0 +1,26 @@ += Notifications + +In this section participants can choose which kind of notifications they'll receive. For instance, depending in the activity of the installation and spaces, most people would want to disable the "Everything I follow" + +image:features/my_account/notifications_settings.png[Notifications settings] + +To go to this section: + +. Sign in as a participant +. Click in the name of the participant in the header +. Click in "My account" +. Click in "Notifications settings" in the sidebar + +The options available are: + +* I want to get notifications about +** My own activity, like when someone comments in my proposal or mentions me +** Everything I follow +* Send notifications by email +** I want to receive an email every time I receive a notification +* Newsletters +** I want to receive newsletters +* Receive direct messages from anyone +** Allow anyone to send me a direct message, even if I don't follow them +* Administrators +** I want to receive an email every time something is reported for moderation \ No newline at end of file From 39514a5fced1634b1577ffb6fe91666859ead62b Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:24 +0200 Subject: [PATCH 044/336] New translations notifications.adoc (French) --- .../admin/pages/features/notifications.adoc | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 docs/fr/modules/admin/pages/features/notifications.adoc diff --git a/docs/fr/modules/admin/pages/features/notifications.adoc b/docs/fr/modules/admin/pages/features/notifications.adoc new file mode 100644 index 0000000000..18006f9c47 --- /dev/null +++ b/docs/fr/modules/admin/pages/features/notifications.adoc @@ -0,0 +1,16 @@ += Notifications + +Most of the actions in the platform generate notifications so particpants can know when there are new things to watch. + +This is accessible from the `Notifications` menu item (image:icon_bell.png[Notification icon]) in the header, after a participant has logged in. + +To see the notifications: + +. Sign in as participant +. Click in the notifications icon in the header + +If there are notifications, then the participant will see the icon with a color image:icon_bell_on.png[Notification icon with color] + +image:features/notifications/notifications.png[Example of notifications page when there are notifications] + +image:features/notifications/no_notifications_yet.png[Example of notifications page when there aren't notifications] \ No newline at end of file From d65a6e7a8dfbfc33630e50a7b238470f7bd1e626 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:25 +0200 Subject: [PATCH 045/336] New translations versions.adoc (French) --- .../admin/pages/features/versions.adoc | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 docs/fr/modules/admin/pages/features/versions.adoc diff --git a/docs/fr/modules/admin/pages/features/versions.adoc b/docs/fr/modules/admin/pages/features/versions.adoc new file mode 100644 index 0000000000..63b7ca2f13 --- /dev/null +++ b/docs/fr/modules/admin/pages/features/versions.adoc @@ -0,0 +1,24 @@ += Versions + +The versions feature allows a visitor to see the evolution of the different versions of resources that can be edited, +like proposals or results. + +With versions it's possible to see who made the change, when the change has been made and exactly what has changed. + +image:features/versions/side_by_side_escaped.png[Versions in resources] + +== See the versions + +. Go to the content that you want to see the version of. +. Click in the "see other versions" link in the sidebar +image:features/versions/sidebar.png[See other versions link in sidebar] +. Click in the past version that you want to see +image:features/versions/list.png[List of versions] +. From there you can change the visualiation of the version differences +image:features/versions/unified_unescaped.png[Unified unescaped view] + +It's possible to view the diffs of the versions in in two formats: side by side or unified. In case that the contents are +in HTML then it's also possible to see the diff unescaped and escaped, and see the full HTML code. + +image:features/versions/side_by_side_unescaped.png[Side by side unescaped view] +image:features/versions/unified_escaped.png[Unified escaped view] \ No newline at end of file From bd97f944107709c563db8e72d42e575e78c8345c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:26 +0200 Subject: [PATCH 046/336] New translations global_moderations.adoc (French) --- .../admin/pages/global_moderations.adoc | 121 ++++++++++++++++++ 1 file changed, 121 insertions(+) create mode 100644 docs/fr/modules/admin/pages/global_moderations.adoc diff --git a/docs/fr/modules/admin/pages/global_moderations.adoc b/docs/fr/modules/admin/pages/global_moderations.adoc new file mode 100644 index 0000000000..bb3d553310 --- /dev/null +++ b/docs/fr/modules/admin/pages/global_moderations.adoc @@ -0,0 +1,121 @@ += Global moderations + +The *Global moderations* function allows you to moderate different kind of contents and +ensure that the dialog in your platform is democratic and constructive. Making +use of this function, administrators, collaborators and moderators of a space can +hide the contents/contributions that have been reported, where the complaint is +deemed appropriate, or delete the complaint. + +NOTE: Looking for how to report users? See xref:participants/reported_users.adoc[Reported users]. + +For instance, in the case of https://www.decidim.barcelona/[Decidim Barcelona], +the https://www.decidim.barcelona/pages/terms-and-conditions[Terms of Service] says: + +> It is not allowed to add any illegal or unauthorized content to the site, such +> as information with the following features: +> +> * be it false or misleading; +> * to infringe any law of the City Council or any third party, such as copyright, +> trademarks or other intellectual and industrial property rights or related rights; +> * attacking the privacy of a third party, such as publishing personal details +> of participants, such as name, address, phone number, email, photos or any other +> personal information; +> * containing viruses, Trojans, robots or other programs that may harm the website +> or the City Hall systems, or the website or system of any third party, or which +> intend to circumvent the technical measures designed for the proper functioning +> of the platform; +> * to send spam to users or overload the system; +> * which has the character of message chain, pyramidal game or random game; +> * for commercial purposes, such as publishing job offers or ads; +> * that it is not in keeping with public decency; consequently, content must not +> incite hatred, discriminate, threaten, provoke, have no sexual, violent, coarse or +> offensive meaning or character; +> * to infringe the law or applicable regulation; +> * to campaign by promoting mass voting for other proposals not related to the +> process and the framework for discussion, and +> * to create multiple users by pretending to be different people (astroturfing). + +Anyone can propose a moderation in Decidim, through the "Flag" icon in the participant +profile. After a participant has clicked in this action then she needs to provide a +reason why she's making this report: + +* Contains clickbait, advertising, scams or script bots. +* Contains racism, sexism, slurs, personal attacks, death threats, suicide requests or any form of hate speech. +* Contains illegal activity, suicide threats, personal information, or something else you think doesn't belong on [This organization]. + +Participants can also add extra information regarding their report. + +image:moderation_modal.png[Give reason for moderation modal] + +After a participant has reported a content, it'll be shown in two sections of the +administration panel: + +* Global moderations panel +* Participatory space moderation panel + +To go to the Global moderations panel, you need to: + +. Sign in as administrator +. Go to administration panel +. Click in Global moderations in the sidebar + +There you'll find first all the unprocessed reports if there's any: + +image:global_moderations_list_unhidden.png[Show all the moderated content list] + +It's also possible to filter by the type of content that was moderated and the +state of the reported content (if it was hidden or not). + +* *Id*: unique identificator of the reported content. +* *Type*: which kind of content it was reported, for instance a *Proposal* or a *Comment*. +* *Participatory Space*: which space this content belongs to. +* *Count*: Number of times it has been reported by different users. +* *Reported content URL*: link for seeing the content reported and see the context of the complaint. +* *Reports*: why it has been reported. If the participant that made the report has given extra +information it's possible to see it by hovering it. +* *Creation date*: when it was originally reported. +* *Actions*: you can *Expand*, *Unreport* or *Hide*. + +== Actions (when the report wasn't accepted yet) + +|=== +|Icon |Name |Definition + +|image:action_expand.png[Expand icon] +|Expand +|To see the full metadata of the reported content. + +|image:action_hide.png[Hide icon] +|Hide +|Allows an admin or moderator to hide this content (accepting the report). + +|image:action_unreport.png[Unreport icon] +|Unreport +|Allows an admin or moderator to keep showing this content (rejecting the report). +|=== + +== Actions (after the content is hidden) + +|=== +|Icon |Name |Definition + +|image:action_expand.png[Expand icon] +|Expand +|To see the full metadata of the reported content. + +|image:action_unhide.png[Unhide icon] +|Unhide +|Allows an admin or moderator to unhide this content (showing it publicly again). +|=== + +If the report was "Unreported" and it was a mistake, meaning that for instance the +content was spam but it was a mistake not accepting the report, then you'll need +to find that again in the public view and report it yourself so you can moderate it. + +== Expand + +To see all the metadata of a report, you can see it Expanded. + +image:global_moderations_report01.png[Expanded moderation 01] + +image:global_moderations_report02.png[Expanded moderation 02] \ No newline at end of file From aed3ad30d950953c8b78614c18ab757f153b5736 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:28 +0200 Subject: [PATCH 047/336] New translations help_sections.adoc (French) --- .../fr/modules/admin/pages/help_sections.adoc | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 docs/fr/modules/admin/pages/help_sections.adoc diff --git a/docs/fr/modules/admin/pages/help_sections.adoc b/docs/fr/modules/admin/pages/help_sections.adoc new file mode 100644 index 0000000000..7e942f55d7 --- /dev/null +++ b/docs/fr/modules/admin/pages/help_sections.adoc @@ -0,0 +1,23 @@ += Help sections + +The first time a visitor goes to any Space page she'll see an information box about what's this Space about. + +This is how the information box is shown to participants and visitors: + +image:help_sections_frontend.png[Help sections: frontend] + +They can hide this box by clicking in the close button [X]. This gets remembered by the application. They can open this box again by clicking in [Help: ?]. + +image:help_sections_frontend_hide.png[Help sections: hide] + +As this is something that depends on your given installation, an administrator can customize these *Help sections*, adapting them to your needs. + +image:help_sections_backend.png[Help sections: backend] + +== Disable + +You can disable these information boxes by leaving the contents all empty for every language: + +image:help_sections_disable_backend.png[Disable help section in admin] + +image:help_sections_disable_frontend.png[Disabled help section] \ No newline at end of file From d7aa80b1382cc5cc344e340266e6a4daa58d7f90 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:29 +0200 Subject: [PATCH 048/336] New translations homepage.adoc (French) --- docs/fr/modules/admin/pages/homepage.adoc | 101 ++++++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 docs/fr/modules/admin/pages/homepage.adoc diff --git a/docs/fr/modules/admin/pages/homepage.adoc b/docs/fr/modules/admin/pages/homepage.adoc new file mode 100644 index 0000000000..b5811167d9 --- /dev/null +++ b/docs/fr/modules/admin/pages/homepage.adoc @@ -0,0 +1,101 @@ += Homepage + +include::partial$under-construction.adoc[] + +You can control how it's the Homepage of your organization. To do so you have the Settings -> Homepage section through the Administration panel: + +image::admin_homepage.png[Decidim Admin Homepage] + +--- + +== How this works + +This means that every section in the Homepage is called **content block**. + +For instance, this is the *How to participate* content block: + +image::homepage_how_to_participate.png[How to participate example] + +For managing these contents you need to Drag and Drop the contents between the two columns, on the left are the Active and in the Right are the Inactive content blocks. + +As an example, here you can see how your page will look with only the *Hero image* content block: + +// TODO: add screenshot + +At the admin this is handled with: + +// TODO: add screenshot + +In your installation you could have other content blocks, as this depends on which modules you have active. Please contact your system administrator if you see something different here, like a missing content block. + +== Content blocks + +These are the different content blocks enabled with the official Decidim modules: + +=== Hero image + +image::homepage_hero_image_back.png[Hero image in Homepage backend content block] + +image::homepage_hero_image_front.png[Hero image in Homepage frontend content block] + +=== Sub hero banner + +Displays the description text of the instance. See xref:admin:appearance.adoc[Appearance]. + +image::homepage_sub_hero_banner.png[Sub hero banner in Homepage content block] + +=== Footer sub hero banner + +// TODO: I think this should be changed with an HTML text and probably removed + +image::homepage_footer_sub_hero_banner.png[Hero image in Homepage content block] + +=== How to participate + +// TODO: I think this should be changed with an HTML text and probably removed + +image::homepage_how_to_participate.png[How to participate in Homepage content block] + +=== Upcoming meetings + +image::homepage_upcoming_meetings.png[Upcoming meetings in Homepage content block] + +=== Last activity + +image::homepage_last_activity.png[Last activity in Homepage content block] + +=== HTML block + +image::homepage_html_block.png[HTML block in Homepage content block] + +=== Highlighted processes + +image::homepage_highlighted_processes.png[Highlighted processes in Homepage content block] + +=== Highlighted assemblies + +image::homepage_highlighted_assemblies.png[Highlighted assemblies in Homepage content block] + +=== Highlighted initiatives + +image::homepage_highlighted_initiatives.png[Highlighted initiatives in Homepage content block] + +=== Highlighted consultations + +image::homepage_highlighted_consultations.png[Highlighted consultations in Homepage content block] + +=== Highlighted conferences + +image::homepage_highlighted_conferences.png[Highlighted conferences in Homepage content block] + +=== Highlighted content banner + +image::homepage_highlighted_content_banner.png[Highlighted content banner in Homepage content block] + +=== Organization statistics + +image::homepage_organization_statistics.png[Organizations statistics in Homepage content block] + +=== Organization metrics + +image::homepage_organization_metrics.png[Organzation metrics in Homepage content block] \ No newline at end of file From 7bb0fe8b69568abb7a92027e9b30c732ace21437 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:30 +0200 Subject: [PATCH 049/336] New translations index.adoc (French) --- docs/fr/modules/admin/pages/index.adoc | 27 ++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 docs/fr/modules/admin/pages/index.adoc diff --git a/docs/fr/modules/admin/pages/index.adoc b/docs/fr/modules/admin/pages/index.adoc new file mode 100644 index 0000000000..4c3b2a0763 --- /dev/null +++ b/docs/fr/modules/admin/pages/index.adoc @@ -0,0 +1,27 @@ += Introduction + +Deploying Decidim means taking account of all the activities that play a part in the configuration of the platform and the deployment of the participatory processes. Acquiring knowledge in administering Decidim enables control over fundamental matters such as: + +* configuring a participatory process +* activating a consultation and receiving votes +* moderating the platform +* managing associated legal texts (as the privacy policy) +* managing authorization from the administrators +* monitoring and verifying organizations + +None of these aspects are strictly technical but they do involve a series of political decisions over how we want Decidim to be, what messages and contents it has to contain, what the moderation policy for comments and debates has to be and, above all, how a specific participatory platform has to be, and what functions it has to have active. This is why it is essential to understand the socio-technical implications of the Decidim platform’s administration and management when it comes to deploying the platform. + +To understand how Decidim works, we need to distinguish between xref:spaces.adoc[*spaces*] and xref:components.adoc[*components*]. The participatory spaces are the channels that citizens can participate through when public decisions are being taken. These are participatory processes, initiatives, consultations and assemblies. +Whereas participatory components are mechanisms that enable interaction between users of the platform and the various participatory spaces. These include meetings, pages, proposals and surveys. + +image:introduction.png[Spaces and components] + +Therefore, a participatory space as a participatory process, in the various stages, can incorporate several components such as face-to-face meetings, proposals, surveys and results and the monitoring of these. + +image:introduction_process.png[Components in a participatory process] + +So, participatory spaces are configured by defining (and configuring) the components they are going to have. It is important to bear in mind that these participatory components and the various functions are repeated in the various spaces, offering many opportunities when it comes to configuring the various spaces. This simplifies learning as once a space has been configured, it is then easier to configure another. + +This section provides a full description of how to configure the Decidim platform for any kind of organization and how to configure, manage and administer the various participatory processes. A description has been given in tutorial format, to help with understanding administration tasks, following Decidim’s literal fields and enclosing screenshots to facilitate their interpretation. + +Managing (administering) the Decidim platform is relatively simple and intuitive and no specific IT knowledge is required. The administrators of a Decidim platform, in other words, those with the necessary authorization for managing the platform, can configure the platform in a general way (images, information pages, etc.,) and manage the various participatory processes (configuring, editing, analysing and concluding). \ No newline at end of file From 3e6c03f003384313536d0b0c1c1515b3287480d7 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:32 +0200 Subject: [PATCH 050/336] New translations information-pages.adoc (French) --- .../admin/pages/information-pages.adoc | 153 ++++++++++++++++++ 1 file changed, 153 insertions(+) create mode 100644 docs/fr/modules/admin/pages/information-pages.adoc diff --git a/docs/fr/modules/admin/pages/information-pages.adoc b/docs/fr/modules/admin/pages/information-pages.adoc new file mode 100644 index 0000000000..b92b94229d --- /dev/null +++ b/docs/fr/modules/admin/pages/information-pages.adoc @@ -0,0 +1,153 @@ += Information pages + +include::partial$legacy.adoc[] + +Here we offer you three informative pages that you can use as a template or re-use replacing the text highlighted in yellow with the correct text. You can find the same documents in spanish or catalan in their respective Administering Decidim document. + +== Information/FAQs + +[[t.6a4146f0a2c8ecae39afa2642bcb7f700ef842af]][[t.0]] + +[width="100%", cols="100%"] +|=== +|_FAQS (EN)_ + +a|If you’d like to take part in participatory processes and have your say, register! Note that to use some of the functions of certain processes (such as voting and prioritising) you will have to verify that you are registered with #Name of the Municipality/ Organization#, by following a very simple step. + +*What is #Name of the Municipality/ Organization?#* + +A platform for building a more participatory #Name of the Municipality/ Organization#, with a shared vision and for delving deeper into local participatory democracy. + +#Platformname# is a participatory platform based on open code. Citizens can see how it is built and can reuse or improve it. https://www.google.com/url?q=https://github.com/AjuntamentdeBarcelona/decidim.barcelona&sa=D&ust=1526042251888000[Check out the code here on GitHub]. + +*How can I participate in Platformname?* + +Get informed + +* Consult the active participatory processes. +* Browse through the proposals made by other citizens +* Access the face-to-face meetings' data and documents and the discussions and debates held there. +* Search contents of interest to you, by district, subject matter and tags. + +Take part + +* Make new proposals. +* Offer arguments in favour or against, or your general thoughts. +* Share the proposals on social media. + +a|Follow the existing proposals + +* Follow the existing proposals: those started on the platform and those generated by face-to-face meetings. +* After the face-to-face meetings have taken place, you can follow the progress of the discussions and debates as well as the contributions generated. +* Tick a proposal of interest to you and follow its entire progress, from the comments made by others to the final documents. + +*What are...?* + +*Participatory processes* + +*#Platformname#* activities that involve citizens and which are carried out in several stages: information, diagnosis, contributions, decisions, results and evaluation of the proposals. + +*Assemblies* + +Permanent participatory channels and bodies. + +*Face-to-face meetings:* + +Meetings and work sessions for contributing to active participatory processes. + +*Surveys* + +Questionnaire for providing information and sharing your opinion. + +*Discussions and debates* + +Digital spaces for getting informed and deciding on the proposals in the processes that have this function enabled. + +*Proposals* + +Contributions you can make as a user. In some cases you will be able to receive votes from other users. Some of them will have a decision-taking function and others a merely consultative function. Each process will have its own characteristic rules. + +*Comments* + +Contributions you can make as a user in response to a proposal or discussion and debate. + +*My residency verification doesn't work.* + +Check the following possibilities: + +* Have you entered your national ID number or document without spaces between the digits, including the final letter? +* Are you sure you are a registered resident in the municipality of #Name of the Municipality/ Organization#? (The municipality is geographically smaller than the Barcelona Metropolitan Area and the Province of Barcelona) +* There may be a problem with your data in the residency register. Consult your nearest CITIZEN HELP AND INFORMATION OFFICE and confirm that your registration information is correct. + +If all the above steps do not solve the problem, email us at #Email# or come to the face-to-face discussions and debates for each process. + +*I am not a registered resident in #Name of the Municipality/ Organization#; why can't I vote for the proposals?* + +Only registered residents in #Name of the Municipality/ Organization# are allowed to vote in processes where proposals can be voted on. When it comes to questions that affect decisions to be taken that are specific to the city, it is the city’s residents who need to take part in such decision-taking. + +It is true that there are people not registered #Name of the Municipality/ Organization# residents who may still be affected by these decisions, but the Register is the broadest available census that we have in #Name of the Municipality/ Organization#: it allows us to reach the maximum number of people while also guaranteeing that the participatory process is secure. On the other hand, not all the processes launched from the platform require their participants to be registered residents in the city. + +*I am not a registered #Name of the Municipality/ Organization# resident. Can I participate?* + +Yes, you can take part even when you are not a registered resident. You can take part in several enabled processes, in face-to-face discussions and debates, and you can launch a proposal, without having to be a registered resident. It is only in some processes that voting for proposals is limited to registered residents, just as only registered residents can vote at municipal elections. + +*Why do I have to verify my account?* + +You need a user account to use the platform. You can do more or fewer things depending on the degree of verification: + +* If you register with the website through an email address without providing any further information (so the verification process is not carried out), you will be able to comment on and debate proposals. +* If after registering, you have carried out the basic verification, i.e. you have verified your residence through the platform (more info at "How do I create and verify my account?"), you can vote for proposals in processes that are feasible (in certain processes). +* You can always take part in person and at any of the face-to-face meetings there are for each participatory process. Contributions that are made face to face will be collected, published and accessible to the platform. + +*Do I need a mobile phone or access to internet to take part?* + +No. You can carry out any action relating to the proposals - whether for creating, supporting, voting for or getting informed about them - face to face at any of the discussions and debates that are held. You can also create a completely verified user account if you wish to use the platform. + +*How do I create and verify my account?* + +The first step is to create an account. Create the account and fill in the information you are asked for. You are required to tick the box stating that you accept our user terms and conditions. On creating a new account, an email will be sent to the address you have specified, and you will have to click on the link it contains (the "Confirm my account" link) to complete the creation of the account. + +Once your basic account has been created and you have logged in using your email and password, the system will give you the option of carrying out a basic verification. To do this, click on the "My account" link on the top right and then click on the "Verify my account" button. + +Some processes, where necessary, will also require you to enter your residency data, to verify you are a registered resident in #Name of the Municipality/ Organization# (it is important to enter the document number along with the letter and your date of birth, and tick the box stating you accept access to the Municipal Register). If your data is correct, your account will allow you to support the proposals. + +*I've forgotten my password and my account doesn't work. What can I do?* + +You can request a new password, which will be sent to your email address. If the above solution does not work, you can email us at #Email#, and we will solve the problem associated with your account. Processes that include face-to-face meetings are open to you to attend and take part in, without the need for you to register with the platform. + +*How can I change my email address, my user name, my password, unsubscribe or activate/deactivate the notifications that are sent to email address?* + +Click on the "Enter" link, enter your email address and password, and click on the "Enter" button. Once you have done so, click on the "My account" link, where you will find all the options, allowing you to change your email address or user name, unsubscribe, or activate/deactivate notifications. Once you have made the appropriate changes, make sure you click on the "Save changes" button. + +*I am unable to create my account correctly.* + +Review the section "My residency verification doesn't work", in case the problem lies in this step; generally speaking, this is the most frequent problem. If this does not solve your problem, review the section "How to create and verify my account", to ensure that your are following the steps correctly. If the problem persists, email us at #Email#, and you will be given assistance. +|=== + +[[h.mkf6otb3mhlh]] +== Terms and conditions of use + +[[t.0c2d2bc083254e4010a82a1ac81ebd7f18f135ee]][[t.1]] + +[width="100%", cols="100%"] +|=== +|_Terms and conditions of use (EN)_ + +a|Legal aspects and conditions of use for the #Platformname# participatory platform at #Name of the Municipality/ Organization# City Council. + +(the ones that the legal services recommend you. You can use the https://www.google.com/url?q=https://decidim.barcelona/pages/terms-and-conditions&sa=D&ust=1526042251902000[Decidim.Barcelona terms and conditions of use] as a model). +|=== + +[[h.3oy7u29]] +== How the platform works + +[[t.44b67a895959076674b8c3aa044e22bbd448f440]][[t.2]] + +[width="100%", cols="100%"] +|=== +|_Accessibility (EN)_ + +a|This refers to the webpage's design and contents, which have to be accessible (without any visual or technological obstacles and for the largest number of users possible), and to standard regulations (WAI, Web Accessibility Initiative). + +Decidim.Barcelona example https://www.google.com/url?q=https://www.decidim.barcelona/pages/accessibility&sa=D&ust=1526042251903000[Accessibility]. +|=== \ No newline at end of file From cfb7fc98df8fdff0d8aaa024be4309a741975c57 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:33 +0200 Subject: [PATCH 051/336] New translations initiatives_initializer.adoc (French) --- .../admin/pages/initiatives_initializer.adoc | 174 ++++++++++++++++++ 1 file changed, 174 insertions(+) create mode 100644 docs/fr/modules/admin/pages/initiatives_initializer.adoc diff --git a/docs/fr/modules/admin/pages/initiatives_initializer.adoc b/docs/fr/modules/admin/pages/initiatives_initializer.adoc new file mode 100644 index 0000000000..80f663fc2c --- /dev/null +++ b/docs/fr/modules/admin/pages/initiatives_initializer.adoc @@ -0,0 +1,174 @@ += Initiatives Initializer + +For using the initiatives module, you'll want to review the configurations that are in the initializer. See the xref:configure:initializer.adoc[general Initializer configuration] for more information regarding this file. + +You'll need to change in the `config/initializer/decidim.rb` file. You could also create an ad-hoc file for these configurations, like `config/initializer/initiatives.rb`. + +After making changes to this file you'll need to also restart your application server. + +== Creation enabled + +Setting that defines whether creation is allowed to any validated user or not. Defaults to true. + +[source,ruby] +.... + config_accessor :creation_enabled do + true + end +.... + +== Similarity threshold + +Setting that defines the similarity minimum value to consider two +initiatives similar. Defaults to 0.25. + +[source,ruby] +.... + config_accessor :similarity_threshold do + 0.25 + end +.... + +== Similarity limit + +Setting that defines how many similar initiatives will be shown. +Defaults to 5. + +[source,ruby] +.... + config_accessor :similarity_limit do + 5 + end +.... + +== Minimum committee members + +Minimum number of committee members required to pass the initiative to +technical validation phase. Only applies to initiatives created by +individuals. + +[source,ruby] +.... + config_accessor :minimum_committee_members do + 2 + end +.... + +== Default signature time period length + +Number of days available to collect supports after an initiative has been +published. + +[source,ruby] +.... + config_accessor :default_signature_time_period_length do + 120 + end +.... + +== Default components + +Components enabled for a new initiative + +[source,ruby] +.... + config_accessor :default_components do + [:pages, :meetings] + end +.... + +== First notification percentage + +Notifies when the given percentage of supports is reached for an +initiative. + +[source,ruby] +.... + config_accessor :first_notification_percentage do + 33 + end +.... + +== Second notification percentage + +Notifies when the given percentage of supports is reached for an +initiative. + +[source,ruby] +.... + config_accessor :second_notification_percentage do + 66 + end +.... + +== Stats cache expiration time + +Sets the expiration time for the statistic data. + +[source,ruby] +.... + config_accessor :stats_cache_expiration_time do + 5.minutes + end +.... + +== Max time in validating state + +Maximum amount of time in validating state. +After this time the initiative will be moved to +discarded state. + +[source,ruby] +.... + config_accessor :max_time_in_validating_state do + 60.days + end +.... + +== Print enabled + +Print functionality enabled. Allows the user to get +a printed version of the initiative from the administration +panel. + +[source,ruby] +.... + config_accessor :print_enabled do + true + end +.... + +== Timestamp service + +Set a service to generate a timestamp on each vote. The +attribute is the name of a class whose instances are +initialized with a string containing the data to be +timestamped and respond to a timestamp method. + +[source,ruby] +.... + config_accessor :timestamp_service +.... + +== PDF signature service + +Set a service to add a signature to pdf of signatures. +The attribute is the name of a class whose instances are +initialized with the document to be signed and respond to a +signed_pdf method with the signature added. + +[source,ruby] +.... + config_accessor :pdf_signature_service +.... + +== Do no require authorization + +This flag allows creating authorizations to unauthorized users. + +[source,ruby] +.... + config_accessor :do_not_require_authorization do + false + end +.... \ No newline at end of file From 431b10dfe0d18e2a7cfef91d6d7e22e5e2ec6d2a Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:35 +0200 Subject: [PATCH 052/336] New translations newsletters.adoc (French) --- docs/fr/modules/admin/pages/newsletters.adoc | 164 +++++++++++++++++++ 1 file changed, 164 insertions(+) create mode 100644 docs/fr/modules/admin/pages/newsletters.adoc diff --git a/docs/fr/modules/admin/pages/newsletters.adoc b/docs/fr/modules/admin/pages/newsletters.adoc new file mode 100644 index 0000000000..7c3c069551 --- /dev/null +++ b/docs/fr/modules/admin/pages/newsletters.adoc @@ -0,0 +1,164 @@ += Newsletters + +Newsletters are emails sent to the organization's participants with the news. They are +sent to participants that have checked the "Receive an occasional newsletter +with relevant information" when the participant signed up or after in their account. + +image::newsletter_contact_permission.png[Contact permission in participant registration] + +image::newsletter_participant_notifications_settings.png[Contact permission in participant account] + +Some examples of when you can and should sent a newsletter are: + +* When a new process could be interesting for all the citizens in a city, +for instance a Participatory Budgeting process. +* When there are the results published for a given process. +* When an assembly has a important point for discussion. +* When there's a new voting planned. +* When there's a new conference published + +To create a new newsletter, as an administrator you need to: + +. Go to newsletter menu +. Click in the button "New newsletter" +. Select the template that you want to use +. Fill the form with the newsletter contents +. Preview the newsletter +. Select recipients to deliver +. Deliver the newsletter + +== 1. Go to newsletter menu + +It's on the main sidebar of the admin panel. + +image::newsletter_menu.png[Newsletter admin menu] + +== 2. Click in the button "New newsletter" + +In this page you'll have a list of all the sent newsletters, along with the status +(if it was sent already or not) and how many participants have received it. + +image::newsletter_list.png[Newsletter list] + +In the secondary sidebar or in the top of the list you have the button for "New +newsletter". + +== 3. Select template of new newsletter + +Depending on what you want to sent, if it's just a quick update or if it's something +a little more elaborated (with an image and a button), then you can choose for +which kind of template you want to use: + +* Basic (only text) +* Text, image and Call to Action button + +image::newsletter_templates.png[Newsletter new templates selection] + +== 2. Fill the form with the newsletter contents + +Depending in which template you've choosen, you have two different forms for +filling: + +=== Basic (only text) newsletter form + +image::newsletter_new_basic.png[Newsletter new template basic form] + +image::newsletter_new_basic_example.png[Newsletter new template basic form filled] + +[NOTE] +==== +You can use "%\{name}" anywhere in the body or subject and it will be +replaced by the recipient's name. +==== + + +.New Newsletter "basic (only text)" form +|=== +|Field |Type |Description + +|Subject +|Required +|Subject of the email. + +|Body +| +|Body of the email. +|=== + +=== Text, image and Call to Action button newsletter form + +image::newsletter_new_cta01.png[Newsletter new template text, image and CTA form 1] + +image::newsletter_new_cta02.png[Newsletter new template text, image and CTA form 2] + + +.New Newsletter "Image, text and Call To Action button" form +|=== +|Field |Type |Description + +|Subject +|Required +|Subject of the email. + +|Introduction +| +|Body of the email. + +|Call To Action button text +| +|What will the button say. For instance, it could be "Participate" + +|Call To Action button URL +| +|Where will the button link to. For instance, it could be the complete URL of a participatory process. + +|Body +| +|Body of the email. + +|Main image +| +|Guidance for image: Preferrably a landscape image that does not have any text. The service crops the image. Allowed file extensions: jpg jpeg gif png bmp ico +|=== + +== 3. Preview the newsletter + +After you've filled the contents of the newsletter, you can preview it. Until you've +sent it you can go back and edit it anytime you want. + +image::newsletter_preview_basic_example.png[Newsletter new template basic form preview] + +== 4. Select recipients to deliver + +If you want to only communicate about a given space, one useful way of doing this +is through the "Select recipients to deliver". Here you can choose between: + +* Sending the newsletter to all confirmed users +* Sending the newsletter to all confirmed users that have participated in any of +the selected participatory spaces in the list +* Sending the newsletter to all confirmed users that have followed any of +the selected participatory spaces in the list +* Sending the newsletter to all the participants that have selected an scope in +their "My interests" settings in their account. + +It's important to note that even if a participant has confirmed its account and +is following the space, the system will not send her a newsletter email if she +haven't activated the "I want to receive newsletters". + +image::newsletter_select_recipients.png[Newsletter select recipients] + +If you select the "Sent do participants" or "Send to followers" of a given space, +then you can choose which spaces are relevant: + +image::newsletter_select_recipients_spaces.png[Newsletter select recipients spaces] + +== 5. Deliver the newsletter + +Finally if you click in the "Deliver newsletter" button, the newsletter will be +sent to all the selected recipients. + +[NOTE] +==== +Once a newsletter was sent it can't be undone nor edited. If you have multiple +languages active, be careful with reviewing all the languages well before sending. +==== \ No newline at end of file From 68f7534420b32e25e2af54028e053fbb9a562c1e Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:36 +0200 Subject: [PATCH 053/336] New translations pages.adoc (French) --- docs/fr/modules/admin/pages/pages.adoc | 125 +++++++++++++++++++++++++ 1 file changed, 125 insertions(+) create mode 100644 docs/fr/modules/admin/pages/pages.adoc diff --git a/docs/fr/modules/admin/pages/pages.adoc b/docs/fr/modules/admin/pages/pages.adoc new file mode 100644 index 0000000000..70e77220cd --- /dev/null +++ b/docs/fr/modules/admin/pages/pages.adoc @@ -0,0 +1,125 @@ += Pages + +You can configure static Pages, which contains general information to the participants of the platform. + +As an example, some of these pages could refer to: + +* What's this platform? Who's the organization? +* How can I participate here? +* How can I create and verify my account? +* What are the terms of conditions and the legal information about this platform? + +These pages will be available to all the participants through the **Help** top menu section and also at the footer sections. You can define **Topics** to categorize all of these pages. + +As the platform enables the Participants to sign up (register) and save some of their personal data, it's important that there's an especial page, called **Terms and Conditions**. This is where you need to put your legal terms, for instance which entity has control of this data, how much time does this data will be saved, etc. This should be (ideally) written and (at least) reviewed by a lawyer. + +== Create a new page + +For creating a new page, you need to: + +. Sign in as admin +. Click in Pages in the sidebar menu +. Click in "Create page" + +image::pages_backend_form.png[Backend: new page form] + + +.New page form +|=== +|Field |Type |Description + +|Title +|Required +|Title of this page. For instance: "How to participate?" + +|URL Slug +|Required +|String that will be used on the URL. Use partial paths, not full URLs here. Accepts letters, numbers, dashes and slashes, and must start with a letter. For instance if the slug is "hello-world" and your domain is "https://example.org", your page will be at "https://example.org/hello-world" + +|Content +|Required +|All the text of the page. + +|Topic +|Optional +|In which Topic it'll be in. + +|Weight +|Optional +|Which order will it have in relation with the other pages. Having a lower number means a higher priority. For instance, if you have two pages, "Page a" with weight "10" and "Page b" with weight "0", then "Page b" will be first when ordering. + +|Show in the footer +|Optional +|Wether you want to show this page in the general footer (available in every page). +|=== + +image::pages_frontend_footer.png[Frontend: example of a page in the footer] + +== Create a new topic + +For creating a new topic, you need to: + +. Sign in as admin +. Click in Pages in the sidebar menu +. Click in "Create topic" + +image::pages_backend_topic_form.png[Backend: new topic form] + + +.New topic form +|=== +|Field |Type |Description + +|Title +|Required +|Title of this topic. For instance: "Help" + +|Description +|Optional +|What's this topic is about. + +|Weight +|Optional +|Which order will it have in relation with the other topics. Having a lower number means a higher priority. For instance, if you have two topics, "Topic a" with weight "10" and "Topic b" with weight "0", then "Topic b" will be first when ordering. + +|Show in the footer +|Optional +|Wether you want to show this topic in the general footer (available in every page). +|=== + +== Special "Terms and Conditions" page + +This is where you need to put your legal terms, for instance which entity has control of this data, how much time does this data will be saved, etc. This should be (ideally) written and (at least) reviewed by a lawyer. + +It's generated by default in a new installation. It can't be deleted, and it has a few special details related with its legal nature: + +. It's shown in the text area sign up form +. If there are meaningful changes, it has a field that can allow an admin when it's necessary that the participants accept the "Terms and Conditions" again, in the next sign in. + +image::pages_backend_tos_change.png[Backend: ToS change] + +image::pages_frontend_tos_change.png[Frontend: ToS change] + +If a participant rejects to accept the terms, then she has three options: + +. To review this again later. It signs her out automatically. +. To download their personal data +. To delete her account + +image::pages_frontend_tos_reject.png[Frontend: ToS reject] + +== Examples + +=== Pages + +image::pages_frontend_show.png[Frontend: show a page] + +image::pages_backend_edit.png[Backend: edit a page] + +image::pages_backend_list.png[Backend: list pages] + +=== Topics + +image::pages_frontend_list_topics.png[Frontend: list topics of pages] + +image::pages_backend_list_topics.png[Backend: list topics of pages] \ No newline at end of file From 167326d826a80c4473617b1273ab1d75a7196a81 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:38 +0200 Subject: [PATCH 054/336] New translations participants.adoc (French) --- docs/fr/modules/admin/pages/participants.adoc | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 docs/fr/modules/admin/pages/participants.adoc diff --git a/docs/fr/modules/admin/pages/participants.adoc b/docs/fr/modules/admin/pages/participants.adoc new file mode 100644 index 0000000000..a7efde5673 --- /dev/null +++ b/docs/fr/modules/admin/pages/participants.adoc @@ -0,0 +1,29 @@ += Participants + +Sometimes as an administrator you'll need to make certain tasks with participants, among them: + +* To give permissions to other administrators so they can manage platform's content +* To verify user groups (organizations or collectives) +* To verify participants +* To recognize that a participant has a special status in the platform, with Officializations +* To authenticate that a person has the right to vote, with Authorizations +* To contact a participant + +You can access this section on the main sidebar of the admin panel. + +image:participants_menu.png[Participants menu] + +Once you're in you can see all the different kind of participants and actions that you can do: + +image:participants_sidebar_menu.png[Participants sidebar menu] + +* xref:admin:participants/admins.adoc[Admins] +* xref:admin:participants/groups.adoc[Groups] +* xref:admin:participants/participants.adoc[Participants] +* xref:admin:participants/impersonations.adoc[Impersonations] +** xref:admin:participants/verifications_conflicts.adoc[Verifications conflicts] +* xref:admin:participants/reported_users.adoc[Reported users] +* xref:admin:participants/authorizations.adoc[Authorizations] +** xref:admin:participants/authorizations/identity_documents.adoc[Identity documents] +** xref:admin:participants/authorizations/code_postal_letter.adoc[Code by postal letter] +** xref:admin:participants/authorizations/census.adoc[Organization's census] \ No newline at end of file From ec2b91cf2b9ebe0b041e0d9e9125d876cd38b0b5 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:39 +0200 Subject: [PATCH 055/336] New translations admins.adoc (French) --- .../admin/pages/participants/admins.adoc | 21 +++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 docs/fr/modules/admin/pages/participants/admins.adoc diff --git a/docs/fr/modules/admin/pages/participants/admins.adoc b/docs/fr/modules/admin/pages/participants/admins.adoc new file mode 100644 index 0000000000..f88bcff92b --- /dev/null +++ b/docs/fr/modules/admin/pages/participants/admins.adoc @@ -0,0 +1,21 @@ += Admins + +In the administrator listing page you can see all the administrators of the platform: + +image:admins.png[Admins list] + +Here you can: + +* invite new administrators +* revoke administrators permissions +* see when was the last time an administrator logged in + +For inviting a new administrator, you need to go to the button "New user" and fill +the form with the admin username, email and which role will she have: + +* Admin: to give full access to the platform +* Participant manager: to give permission to only do xref:admin:participants/impersonations.adoc[Impersonations] + +image:admins_invite.png[Invite participant as administrator form] + +You can invite an already registered or a non registered participant. \ No newline at end of file From cd60d9ba842fa331d99edc60900b4489dfd28b81 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:40 +0200 Subject: [PATCH 056/336] New translations authorizations.adoc (French) --- .../pages/participants/authorizations.adoc | 40 +++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 docs/fr/modules/admin/pages/participants/authorizations.adoc diff --git a/docs/fr/modules/admin/pages/participants/authorizations.adoc b/docs/fr/modules/admin/pages/participants/authorizations.adoc new file mode 100644 index 0000000000..3937fffc92 --- /dev/null +++ b/docs/fr/modules/admin/pages/participants/authorizations.adoc @@ -0,0 +1,40 @@ += Authorizations + +This section allows you to manage participants' authorizations. It depends on which Authorizations you have configured and +enabled by your developers. To understand more what are authorizations and how to configure them, please refer to the +xref:customize:authorizations.adoc[Authorizations section in the Customize Guide]. + +With authorizations an administrator can define different permissions so participants can make some actions in a component. +For instance you can configure that only participants who have verified herselves by their identity documents can vote on +proposals in a participatory process. + +A participant can see which authorizations does she have available in her account settings. + +image:authorizations_account.png[Authorizations in participants account] + +== Authorizations revocation + +A default Decidim installation will not have verified participants. + +image:authorizations_admin_default.png[Authorizations in a default installation] + +In the moment that there are some participants verified, an administrator can revoke all the authorizations, as the attributes +that give permissions to those participants could be changed in time and the platform didn't receive these changes in the +participants statuses. For instance, an identity document of a participant could be expired, or if a participant have been +authorized by the "code by postal letter", that participant could move in the meantime. + +image:authorizations_admin_revocation.png[Authorizations revocation] + +It's possible to revoke all the authorizations with "Revoke all", or to only revoke authorizations before a given date. +Another possiblity is to revoke only the xref:admin:participants/impersonations.adoc[impersonated participants]. + +== Verification methods + +Some of the available authorizations by default are: + +* xref:admin:participants/authorizations/identity_documents.adoc[Identity documents] +* xref:admin:participants/authorizations/code_postal_letter.adoc[Code by postal letter] +* xref:admin:participants/authorizations/census.adoc[Organization's census] + +If any of these authorizations are not useful for your needs, talk with your implementer to see other alternatives. Learn +more about xref:customize:authorizations.adoc[Authorizations in the Customize Guide section]. \ No newline at end of file From b8aabde854de10dbf4a61405e63020fa3e570304 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:42 +0200 Subject: [PATCH 057/336] New translations census.adoc (French) --- .../participants/authorizations/census.adoc | 34 +++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 docs/fr/modules/admin/pages/participants/authorizations/census.adoc diff --git a/docs/fr/modules/admin/pages/participants/authorizations/census.adoc b/docs/fr/modules/admin/pages/participants/authorizations/census.adoc new file mode 100644 index 0000000000..b7e2cfbb9d --- /dev/null +++ b/docs/fr/modules/admin/pages/participants/authorizations/census.adoc @@ -0,0 +1,34 @@ += Organization's census authorization + +The process is as follows: + +. Admins upload a CSV with the emails of the accepted participants +. Participants go to its accounts and requests to be verified +. Only participants with an email in that CSV file can get verified + +NOTE: is this too simple and you need more features related to CSV census imports? +Check all the CSV or file based authorizations in our https://decidim.org/modules/[Modules page]. + +== 1. An administrator uploads the CSV of the participants + +In the admin panel, the administrator can review the request by going to the "Organization's census" in the "Participants" section. + +image:authorizations_organization_census.png[Organization's census in admin panel] + +After the CSV is imported then the administrator can see how many participants where imported. She can also delete this +imported census. + +image:authorizations_organization_census_imported.png[Imported CSV] + +== 2. A participant requests to be verified + +By going to the authorization section in its profile, or by clicking on the action button if this permission is requested, +a participant can request to be verified. + +image:authorizations_organization_census_account.png[Organization's census in participant's accounts] + +== 3. The participant is verified (or not) + +After is verified, as with other verifications, she can see it in her account settings. + +image:authorizations_organization_census_verified.png[Verified by organization's census] \ No newline at end of file From 19288594d1a35a0f42fdc79ceee06a4742eae44b Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:43 +0200 Subject: [PATCH 058/336] New translations code_postal_letter.adoc (French) --- .../authorizations/code_postal_letter.adoc | 57 +++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 docs/fr/modules/admin/pages/participants/authorizations/code_postal_letter.adoc diff --git a/docs/fr/modules/admin/pages/participants/authorizations/code_postal_letter.adoc b/docs/fr/modules/admin/pages/participants/authorizations/code_postal_letter.adoc new file mode 100644 index 0000000000..953c5c0eb0 --- /dev/null +++ b/docs/fr/modules/admin/pages/participants/authorizations/code_postal_letter.adoc @@ -0,0 +1,57 @@ += Code by postal letter authorization + +This authorization allows a participant to request for a verification code to be sent to its address, to confirm that she +lives or works in this place. She'll need to then fill the code in the platform. + +The process is: + +. Participants request a verification code to be sent to their address. +. An administrator sends the letter to their address with the verification code. +. An administrator marks the letter as sent. +. Once you mark the letter as sent, the participant will be able to introduce the code. +. If this code matchs, then she gets verified. + +== 1. A participant request the verification code + +By going to the authorization section in its profile, or by clicking on the action button if this permission is requested, +a participant can see the form for filling in her full address to request the verification code. + +image:authorizations_code_postal_letter_request.png[Code by postal letter request by participant] + +If she tries to edit it, she'll see this message: + +image:authorizations_code_postal_letter_edit.png[Edit the postal letter request] + +This is because the letter could be in the process of being sent. If this needs to be corrected, then the participant needs +to contact to the organization. + +== 2. An administrator review this request and sent the letter + +In the admin panel, the administrator can review the request by going to the "Code by postal letter" in the "Participants" section. + +image:authorizations_code_postal_letter_ongoing.png[Code by postal letter ongoing panel in admin] + +Here she can see the verification code and can send it to the participant by mail. After the code is sent she can mark it +as sent with the icon image:action_mark_as_sent.png[Mark as sent]. It'll also show when the letter was sent. + +== 3. A participant fills in the verification code + +After the participant has received the code, she can go to it's account settings and click in the "Code by postal letter" +verfication method. + +image:authorizations_code_postal_letter_verify.png[Code by postal letter ongoing in the participant account] + +Then she'll see the form for confirming the code. + +image:authorizations_code_postal_letter_confirm.png[Code by postal letter confirmation form] + +== 4. The verification code matches or not + +If the verification code matches, then the participant will see the message "Congratulations. You've been successfully verified". + +On the other hand, if the verification code doesn't match, then the participant will see the message "Your verification +code doesn't match ours. Please double-check the letter we sent to you." + +After is verified, as with other verifications, she can see it in her account settings. + +image:authorizations_code_postal_letter_verified.png[Verified by code by postal letter] \ No newline at end of file From 41ffbb5a8141d10287edb919b1abb93f97579990 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:45 +0200 Subject: [PATCH 059/336] New translations identity_documents.adoc (French) --- .../authorizations/identity_documents.adoc | 141 ++++++++++++++++++ 1 file changed, 141 insertions(+) create mode 100644 docs/fr/modules/admin/pages/participants/authorizations/identity_documents.adoc diff --git a/docs/fr/modules/admin/pages/participants/authorizations/identity_documents.adoc b/docs/fr/modules/admin/pages/participants/authorizations/identity_documents.adoc new file mode 100644 index 0000000000..2502903d6a --- /dev/null +++ b/docs/fr/modules/admin/pages/participants/authorizations/identity_documents.adoc @@ -0,0 +1,141 @@ += Identity documents authorization + +This authorization allows a participant to upload its identity documents. These documents depend on the organization, +they could be a driver's license, a passport, a national identity card, a club membership card, etc. + +These documents will be reviewed by an administrator to accept or reject them. It's possible to do this process in two ways: Online or Offline. + +* Online: the participant will be asked to upload the documents, and the administrator will review these documents. +* Offline: the participant will be asked to fill in some data, and then she'll need to go to a presential place to show her documents face to face. + +== Configuration + +By clicking on the btn:[Config] button in this section, an administrator can configure the settings for this authorization. + +image:authorizations_id_document_configuration.png[ID document authorization configuration] + +NOTE: As you can see, this authorization is based in the original implementers reality, in this case in the Spanish identities document types. +For instance, we're giving as options for document types "DNI, NIE or Passport" or we're asking for "Document number (with letter)" +You can change this by xref:customize:code.adoc[code customizing or overriding] these things. We also accept xref:contribute:governance.adoc[Pull Request contributions] +so it's possible to configure this. + + +.ID Documents authorization configuration +|=== +|Field |Type |Description + +|Available methods +|Required +|At least one method must be selected. Options: Online and/or Offline. + +|Instructions for offline verification +|Required (if offline is selected) +|Directions that participants need to follow to verify their documents when offline verification is selected. For instance, +do they need to go to a specific place to show their documents? Is this place open some days of the week? Is it open +for certain hours? +|=== + +== Online + +The process is: + +. Participants fill in their document type and number and upload a copy of their document. +. An administrator fills in the information present in the uploaded image. +. The information should match whatever the user filled in. +. If the administrator can't clearly see the information or she can't get it verified, she can reject the request and +the user will be able to fix it. + +=== 1. A participant fill in the document information and upload a copy of her document + +By going to the authorization section in its profile, or by clicking on the action button if this permission is requested, +a participant can see the form for uploading a copy of her document. She also needs to fill in her document type and number. + +image:authorizations_id_document_online.png[ID document authorization online form] + +=== 2. An administrator review this document + +After this document is uploaded, an administrator can review it by going to the Identity documents section in the admin +panel. + +image:authorizations_id_document_online_pending.png[ID document authorization pending online verification] + +After clicking on the document, the administrator needs to see the image and fill in the document number. This needs to match +with the one provided by the participant. + +image:authorizations_id_document_online_confirm.png[ID document authorization online confirmation form] + +=== 3. The request is accepted or rejected + +There are two actions an admin can do: + +* Accept: the participant will be fully authorized. +* Reject: the participant will be prompted to amend her documents + +If the request is rejected then the participant can provide other pictures or document. + +image:authorizations_id_document_online_rejected.png[ID document authorization rejected online verification] + +== Offline + +The process is: + +. Participants fill in their document type and number. +. Participants follow the instructions provided to them. For instance, if they need to go to a specific place in a +specific time to show their documents. +. An administrator go to the "Offline verification" panel and fills in the information present in the physical documents. +. The information should match whatever the user filled in. +. If the administrator can't clearly see the information or she can't get it verified, she can reject the request and +the user will be able to fix it. + +For this authorization to work, an administrator need to first configure it in the admin panel with the instructions explaining +what the participant need to do to finish the verification process. + +image:authorizations_id_document_configuration_offline.png[ID document authorization configuration: offline instructions] + +=== 1. A participant fill in the document information and follow the instructions + +By going to the authorization section in its profile, or by clicking on the action button if this permission is requested, +a participant can see the form for filling in her document type and number. + +image:authorizations_id_document_offline_request.png[ID document authorization offline form] + +=== 2. An administrator review this request + +In the admin panel, the administrator can review the request by clicking in the "Offline verification" button. + +image:authorizations_id_document_offline_button.png[ID document authorization offline button in admin] + +Then she'll need to fill some data provided by the participant and by reviewing the document physically provided by her. + +image:authorizations_id_document_offline_confirm.png[ID document authorization offline confirmation form in admin] + + +.ID Documents authorization offline flow +|=== +|Field |Type |Description + +|Participant email +|Required +|Email of the registered participant + +|Type of the document +|Required +|Can be: DNI, NIE or Passport + +|Document number (with letter) +|Required +|Document number of the participant. For instance, "12345678Z" +|=== + +=== 3. The request is accepted or rejected + +In the cases where the verifications don't match (meaning that the email or the document number provided by the +participant and the ones filled by the administrators aren't the same), then the participant need to ammend it with her +user account. + +== Both + +It's also possible to enable both of these verifications methods. In this case, the participant will be asked to choose +which kind of verification she wants to do. + +image:authorizations_id_document_account_choose.png[Choose ID document verification kind] \ No newline at end of file From d3a5db62ef6d47c5c587cb478ed4a043f5cf2a3f Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:46 +0200 Subject: [PATCH 060/336] New translations groups.adoc (French) --- .../admin/pages/participants/groups.adoc | 116 ++++++++++++++++++ 1 file changed, 116 insertions(+) create mode 100644 docs/fr/modules/admin/pages/participants/groups.adoc diff --git a/docs/fr/modules/admin/pages/participants/groups.adoc b/docs/fr/modules/admin/pages/participants/groups.adoc new file mode 100644 index 0000000000..3201f6fac9 --- /dev/null +++ b/docs/fr/modules/admin/pages/participants/groups.adoc @@ -0,0 +1,116 @@ += User Groups + +An user group is a group of participants. Depending in the installation and the context of the organization it could be disabled. This is enabled or disabled in the administration dashboard, in Settings -> Configuration -> Edit organization -> Enable groups. + +== Creation + +This action is done by **a participant**. She needs to go to their profile and in the sidebar there's a button that says "Create group": + +image:user_sidebar.png[User sidebar] + +When clicked it'll open the "New group form": + +image:user_group_new_form.png[New user group form] + + +.New group form +|=== +|Field |Type |Description + +|Name +|Required +|Name of your organization, association, collective, group, etc. + +|Nickname +|Required +|Nickname of your organization, association, collective, group, etc. Do not use spaces nor accents. 20 characters maximum. + +|Email +|Required +|Email of your organization, association, collective, group, etc. + +|Avatar +|Optional +|Guidance for image: Preferably a landscape image that does not have any text. The service crops the image. Maximum file size: 5MB. Allowed file extensions: jpg jpeg gif png bmp ico + +|About +|Optional +|Description of what's this group. + +|Document number +|Optional +|Used for verifications. Do not use dashes nor spaces. + +|Phone +|Optional +|Used for verifications. Do not use dashes nor spaces. +|=== + +== Membership + +After a group has been created, it's possible to invite participants to become members of the group. After a participant has accepted to be part of this group then she can become an admin. + +The actions that can be done by a participant in the user group are: + +* Edit group profile +* Manage members +* Manage admins +* Invite participant +* Leave group + +image:user_group_invite_participant.png[User groups: invite a participant] + +== Group verifications + +image:admin_user_group_verification.png[Admin panel: user group verifications] + +This action is done by **an administrator**. A group can be: +* Pending +* Verified +* Rejected + +This can be done with the buttons at the sidebar: + +image:admin_user_group_verification_actions.png[Admin panel: user group verifications actions] + +When a user group is pending it can be verified or rejected. Once is verified it can be rejected and once is rejected it can be verified. + +If you want to verify multiple user groups at the same time you can do so with the option "Verify via CSV": + +image:admin_user_group_verification_csv.png[Admin panel: user group verifications CSV] + +.... +Upload your CSV file. It must have the official emails of the groups in your organization in the first column of the file, without headers. Only groups that have confirmed their email and that have an email appearing in the CSV file will be validated. +.... + +After a group is verified this is publicly visible in their nickname in the platform and there's a message in its profile: "This group is publicly verified, its name has been verified to correspond with its real name". + +image:user_group_verified.png[User group: verified icon] + +== Actions + +As a verified user group, there's some options that your participant account can do in behalf of the group, such as: + +=== Create a Debate, Proposal or Meeting + +There's a dropdown in the form during the creation process: + +image:user_group_create_debate.png[User group: create a debate] + +=== Make a comment + +There's a dropdown in the form when making a comment: + +image:user_group_make_comment.png[User group: make a comment] + +=== Endorse + +When making an Endorse there's a modal window asking who do you want to make the endorse with: + +image:user_group_endorse.png[User group: endorse] + +=== Conversations + +You can also have Conversations as a group. This is in the group profile page: + +image:user_group_conversation.png[User group: conversations] \ No newline at end of file From aa1e61f5b6f19d2549cb70309f0d4ab19d937349 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:48 +0200 Subject: [PATCH 061/336] New translations impersonations.adoc (French) --- .../pages/participants/impersonations.adoc | 42 +++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 docs/fr/modules/admin/pages/participants/impersonations.adoc diff --git a/docs/fr/modules/admin/pages/participants/impersonations.adoc b/docs/fr/modules/admin/pages/participants/impersonations.adoc new file mode 100644 index 0000000000..9cd1788be5 --- /dev/null +++ b/docs/fr/modules/admin/pages/participants/impersonations.adoc @@ -0,0 +1,42 @@ += Participants Impersonations + +For participants that don't have the knowledge or don't have an email for registering +an account, there's the Impersonation feature. + +This allows an 'Administrator' or 'Participant manager' to search through a +Verification system for an already existing participant and also to create a +participant without email. + +NOTE: At the code and the User Interface we say both *Impersonation* and *Managed +Participants*. It's the same thing. + +== Panel + +image::participants_impersonations.png[Admin's Impersonations panel] + +This is the panel where you can find all the participants: + +* by filtering by managed or not managed participants +* by searching by name + +After you've clicked in `Manage new participant` you'll go to the form to enter +the personal data to check against the verification: + +image::participants_impersonations_form.png[Admin's Impersonations form] + +NOTE: If you don't see the `Manage new participant` button, is because this feature +only works when you have a Verification of kind `direct` (also known +as `form authorizations`). See in your xref:admin:system.adoc[system panel] which +`Available authorizations` are enabled. You can learn more regarding how to program +your form authorization in https://github.com/decidim/decidim/blob/develop/decidim-verifications/README.md[decidim-verification README]. + +After this data is confirmed then there'll be a session for the participant for +30 minutes: + +image::participants_impersonations_user.png[Impersonated user session] + +Finally, it's also possible to Promote a participant, meaning that after a +participant has been managed, an administrator can add the email and send her +an Invitation: + +image::participants_impersonations_promotion.png[Admin's promotion Impersonations] \ No newline at end of file From 68200738d432d157e410d3dc9d5f91767c159759 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:49 +0200 Subject: [PATCH 062/336] New translations participants.adoc (French) --- .../pages/participants/participants.adoc | 90 +++++++++++++++++++ 1 file changed, 90 insertions(+) create mode 100644 docs/fr/modules/admin/pages/participants/participants.adoc diff --git a/docs/fr/modules/admin/pages/participants/participants.adoc b/docs/fr/modules/admin/pages/participants/participants.adoc new file mode 100644 index 0000000000..e76ab358b4 --- /dev/null +++ b/docs/fr/modules/admin/pages/participants/participants.adoc @@ -0,0 +1,90 @@ += Participants + +In this page an administrator can: + +* Block a participant, for instance because she's spamming or acting against the Terms of Service +* Contact a participant with Decidim private messages (Conversations) +* Officialize a participant +* See its email + +image:participants_participants.png[Participants list] + +== Actions + +image:participants_participants_actions.png[Participants actions] + +|=== +|Icon |Name |Definition + +|image:action_block.png[Block user] +|xref:_block_user[Block user] +|To block or moderate a participant. + +|image:action_show_email.png[Show email] +|xref:_show_email_address[Show email address] +|To show an email of a participant. + +|image:action_contact.png[Contact] +|xref:_contact[Contact] +|To contact a participant with Decidim private messages (Conversations) + +|image:action_officialize.png[Officialize] +|xref:_officialize[Officialize] +|To recognize that a participant has a special status in the platform + +|image:action_reofficialize.png[Reoffficialize] +|Reoffficialize +|To change an officialization. See xref:_officialize[Officialize] + +|image:action_unofficialize.png[Unofficialize] +|Unofficialize +|To revoke an officialization. See xref:_officialize[Officialize] +|=== + +=== Block user + +After clicking in this option you'll need to provide a justification why you're +blocking this participant: + +image:participants_block_user_justification.png[Justificate the blocked user action] + +Once a blocked participant tries to log-in she'll see an error message: + +image:participants_block_user_alert.png[Message shown to blocked user] + +After a participant was blocked its name is changed to "Blocked user". + +See more at xref:admin:participants/reported_users.adoc[Reported users] + +=== Show email address + +After clicking this option, the admin will see a modal. She'll have to click in +button "Show email address". + +image:participants_show_email.png[Modal in show email] +image:participants_showed_email.png[Modal after the email is shown] + +This action will be logged in the Admin actvity log. + +image:participants_showed_email_admin_log.png[Admin activity log for show email] + +=== Contact + +By clicking on this option, it will open the private messaging (Conversation) for +this participant. + +image:participants_conversation.png[Conversation with a participant]. + +=== Officialize + +This option is useful to recognize that a participant has a special status in the +platform. For instance, if someone is the City Mayor, a City Councillor or the +President of an Association in an organization context. + +After Officializing a participant you can: + +- Change the Officialization text with "Reofficialize" +- Revoke the Officialization status with "Unofficialize" + +image:participants_officialize.png[Officialize a participant] +image:participants_participants_actions_officialize.png[Officialize a participant] \ No newline at end of file From eeefc97bd467ec510bac61e6887ca12ddd2cb557 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:51 +0200 Subject: [PATCH 063/336] New translations reported_users.adoc (French) --- .../pages/participants/reported_users.adoc | 33 +++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 docs/fr/modules/admin/pages/participants/reported_users.adoc diff --git a/docs/fr/modules/admin/pages/participants/reported_users.adoc b/docs/fr/modules/admin/pages/participants/reported_users.adoc new file mode 100644 index 0000000000..6616b10c2b --- /dev/null +++ b/docs/fr/modules/admin/pages/participants/reported_users.adoc @@ -0,0 +1,33 @@ += Reported users + +There are cases where participants could go against the Terms of Service of the +platform, so it's useful to have the option for reporting and blocking users. You +can read more about how moderation and reporting contents work in xref:global_moderations.adoc[Global moderations]. + +A participant can be blocked from the xref:participants/participants.adoc[participants +section in the admin panel] or through this "Reported users" section. + +Anyone can propose a moderation in Decidim, through the "Flag" icon in the participant +profile. After a participant has clicked in this action she needs to provide a +reason why she's making this report: + +* Contains clickbait, advertising, scams or script bots. +* Contains racism, sexism, slurs, personal attacks, death threats, suicide requests +or any form of hate speech. +* Contains illegal activity, suicide threats, personal information, or something +else you think doesn't belong on Demo. +* Other (and add it) + +image:reported_participant_modal.png[Give reason for reporting a participant modal] +image:reported_participant_flag.png[Flag in sidebar profile] + +After clicking in this option you'll need to provide a justification why you're +blocking this participant: + +image:participants_block_user_justification.png[Justificate the blocked user action] + +Once a blocked participant tries to log-in she'll see an error message: + +image:participants_block_user_alert.png[Message shown to blocked user] + +After a participant was blocked its name is changed to "Blocked user". \ No newline at end of file From e23de8ec2a83fa8a6d59a49c6cb53404fd68a977 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:52 +0200 Subject: [PATCH 064/336] New translations verifications_conflicts.adoc (French) --- .../participants/verifications_conflicts.adoc | 38 +++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 docs/fr/modules/admin/pages/participants/verifications_conflicts.adoc diff --git a/docs/fr/modules/admin/pages/participants/verifications_conflicts.adoc b/docs/fr/modules/admin/pages/participants/verifications_conflicts.adoc new file mode 100644 index 0000000000..1e14b977f6 --- /dev/null +++ b/docs/fr/modules/admin/pages/participants/verifications_conflicts.adoc @@ -0,0 +1,38 @@ += Verification's conflicts + +There are cases depending on which kind of verifications you've enabled that there could be verification's conflicts. + +For instance: + +. A participant get xref:admin:participants/impersonations.adoc[impersonated], and she doesn't provide an email +. Then she creates an account and tries to verify herself with the Census verification + +For security, we try to be extra cautious in these cases, and we want that an administrator reviews these verifications. +As you can see, this depends a lot on which kind of verifications you've enabled in your organization, so it's easy to say +that most of the time an organization will not see any conflicts in this panel. + +image:verifications_conflicts.png[Verification's conflicts panel] + +== Transfer user + +An administrator can review these conflicts by clicking in the Transfer user image:action_transfer_user.png[Transfer user] icon. + +Then she'll see the Transfer user form, where she can provide a reason for the transfer. + +image:verifications_conflicts_transfer_user.png[] + + +.Transfer user form +|=== +|Field |Type |Description + +|Reason +|Required +|Why you want to transfer the user + +|Email +|Required +|The email of the user to transfer +|=== + +After the user is transferred, both accounts (the original and the new one) will be merged. \ No newline at end of file From c24427e15211e9a91ea1d8d731a6218a435fbde8 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:54 +0200 Subject: [PATCH 065/336] New translations scopes.adoc (French) --- docs/fr/modules/admin/pages/scopes.adoc | 105 ++++++++++++++++++++++++ 1 file changed, 105 insertions(+) create mode 100644 docs/fr/modules/admin/pages/scopes.adoc diff --git a/docs/fr/modules/admin/pages/scopes.adoc b/docs/fr/modules/admin/pages/scopes.adoc new file mode 100644 index 0000000000..e189ca92cb --- /dev/null +++ b/docs/fr/modules/admin/pages/scopes.adoc @@ -0,0 +1,105 @@ += Scopes + +Scopes are the set of territories or subjects that an Organization has. A scope may have child scopes. + +For instance, in the case of the city of Barcelona the scopes are its districts, and the children of a district are its neighborhoods. They can also have types, so it can be configured, for example, by thematic and also territorial scopes. + +Most of the components and spaces in Decidim allow you to configure Scopes in one way or another. There are mainly three ways of using Scopes: + +To configure Scope on the Decidim platform, go to menu:Settings[Scopes] in the admin sidebar menu. A list will appear with the existing scopes if there are any: + +image:scopes_list.png[Scopes list] + +If you need so, you need to first configure the Scope type. + +== Form + +image:scopes_types_new_form.png[New scope type form] + + +.Admin New Scope Type form +|=== +|Field |Type |Description + +|Singular +|Required +|Name of the scope type in singular. + +|Plural +|Required +|Name of the scope type in plural. +|=== + +image:scopes_new_form.png[New scope form] + + +.Admin New Scope Form +|=== +|Field |Type |Description + +|Name +|Required +|Name of the scope. + +|Code +|Required +|(Internal) name of the scope. + +|Scope type +|Required +|Which type of scope it's. +|=== + +== Actions + +You have 3 possible actions in this list after a Scope is created: + +|=== +|Icon |Name |Definition + +|image:action_browse.png[Browse icon] +|Browse +|See and configure the children scopes for this Scope. + +|image:action_edit.png[Edit icon] +|Edit +|Edit form for a Scope. It's the same form as "Create a new scope". + +|image:action_delete.png[Delete icon] +|Delete +|To delete this scope. +|=== + +== Features + +The main features related with scopes are: + +. Filtering +. User interests and Newsletters + +=== Filtering + +For filtering. Most of the spaces and components allows an administrator or a participant to associate them to a scope. This allows to filter by scopes when exploring them. + +image:scopes_filter_initiatives.png[Initiatives scopes filtering] + +image:scopes_filter_processes.png[Processes scopes filtering] + +Some examples: + +* With Accountability module, so it's possible to filter Results +* Assemblies and Processes can have Scopes. It's used for filtering multiple assemblies in the main listing page (/assemblies or /processes). These can be hidden by unchecking the "Enable participatory space filters" in the xref:admin:configuration.adoc[admin's configuration page]. +* Filtering in the sidebar is possible in Budgets Projects, Initiatives and Proposals. In some of these components you can control if these filters are shown with the "Scopes enabled" checkbox in the component settings. This will also enable or disable the scope selector in the resource creation form. + +You can also configure a participatory space so the filtering will only concern one scope and its children scopes. For example, let's imagine your organization have 3 different scopes for 3 cities, each of them having children scopes for the cities neighbourhoods. +On a participatory space which concerns only one of the cities, you will be able to select only this scope and its children so that users do not see the scopes of other cities in the filter options. + +=== User interests and Newsletters + +A Participant can choose which Scopes she wants to follow in its account. + +image:account_my_interests.png[Account: my interests] + +This is used by the xref:admin:newsletters.adoc[Newsletters], in the "Select recipients to deliver" step, "Filter for users having activated any selected scope in their account's My Interests settings." section. + +image:newsletter_select_recipients.png[Newsletter: select recipients] \ No newline at end of file From 3ef000ba748132341373fe158753917769fa3b04 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:55 +0200 Subject: [PATCH 066/336] New translations spaces.adoc (French) --- docs/fr/modules/admin/pages/spaces.adoc | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces.adoc diff --git a/docs/fr/modules/admin/pages/spaces.adoc b/docs/fr/modules/admin/pages/spaces.adoc new file mode 100644 index 0000000000..6e3fcfab76 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces.adoc @@ -0,0 +1,12 @@ += Spaces + +The participatory spaces are the channels that citizens can participate through when public decisions are being taken. By default +the platform is provided with participatory processes, initiatives, consultations, conferences, votings and assemblies, but +any organization can develop its own mechanisms through xref:develop:modules.adoc[Modules]. + +They are accessible through the main sidebar in the administration panel, and also through the main navigation menu in the +public interface. + +image:spaces_admin.png[Spaces in admin sidebar] + +image:spaces_visitor.png[Spaces visible in the public interface] \ No newline at end of file From d681e46cd87e868a63137394d8ec607aa9ee04db Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:56 +0200 Subject: [PATCH 067/336] New translations assemblies.adoc (French) --- .../admin/pages/spaces/assemblies.adoc | 308 ++++++++++++++++++ 1 file changed, 308 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces/assemblies.adoc diff --git a/docs/fr/modules/admin/pages/spaces/assemblies.adoc b/docs/fr/modules/admin/pages/spaces/assemblies.adoc new file mode 100644 index 0000000000..82c7e1d8a0 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/assemblies.adoc @@ -0,0 +1,308 @@ += Assemblies + +An assembly is a group of members of an organization who meet periodically to make decisions about a specific area or +scope of the organization. + +Assemblies hold meetings, some are private and some are open. If they are open, it is possible to participate in them +(for example: attending if the capacity allows it, adding points to the agenda, or commenting on the proposals and decisions taken by this organ). + +Examples: A general assembly (which meets once a year to define the organisation's main lines of action as well as its +executive bodies by vote), an equality advisory council (which meets every two months to make proposals on how to improve +gender relations in the organisation), an evaluation commission (which meets every month to monitor a process) or a guarantee +body (which collects incidents, abuses or proposals to improve decision-making procedures) are all examples of assemblies. + +The main difference between xref:admin:spaces/processes.adoc[participatory processes] and assemblies is that assemblies don't +have phases, meaning that they don't have timelines. + +You can see a real world usage of assemblies in https://www.decidim.barcelona/assemblies[Decidim Barcelona], where you +can see the different Participation Organs, that are the regular spaces where the City Council meets with citizens and organizations +to get feedback. + +In this section, we'll explain how we can configure an Assembly in Decidim. + +== List + +To configure assemblies on the Decidim platform, click on btn:[Assemblies] in the admin sidebar menu. A list +will appear with the existing assemblies if there are any: + +image:assemblies_list.png[Assemblies list] + +You can filter by the ones that are: + +* Published / Unpublished +* Public / Private + +image:assemblies_list_filter.png[Assemblies list filtered] + +You can also search by title and control how many elements are in the list. + +You have 4 possible actions in this list after an Assembly is created: + +. Export: send by email the configuration for a given assembly. Can be imported in other Decidim installation. +. Duplicate: to duplicate this assembly. +. Configure: to edit the metadata and configuration for a assembly. +. Assemblies: to manage all the children assemblies for a assembly. +. Preview: how it will look once published. + +== New assembly form + +image:assemblies_new_form.png[New assembly form] + + +.New assembly form: General information +|=== +|Field |Type |Description + +|Title +|Required +|Title of the assembly. For instance, "General Committee". + +|Subtitle +|Required +|Subtitle. For instance, "Let's decide our priorities together" + +|Order position +|Required +|Which order will it have in relation with the other assemblies. Having a lower number means a higher priority. For instance, +if you have two assemblies, "Assembly a" with weight "10" and "Assembly b" with weight "0", then "Assembly b" will be first when ordering. + +|URL slug +|Required +|URL slugs are used to generate the URLs that point to this assembly. Only accepts letters, numbers and dashes, and must +start with a letter. Example: if your domain is 'example.org' and your slug 'general-committee' then your URL will +be https://example.org/assemblies/general-committee + +|Hashtag +|Optional +|Hashtag for Twitter + +|Short description +|Required +|A short explanation of what's your participatory process about. + +|Description +|Required +|A long explanation of what's your assembly about. + +|Purpose of action +|Optional +|Internal field that doesn't get shown publicly. To be removed in a future version. + +|Composition +|Optional +|Internal field that doesn't get shown publicly. To be removed in a future version. + +|Internal organisation +|Optional +|Internal field that doesn't get shown publicly. To be removed in a future version. + +|Announcement +|Optional +|The text you enter here will be shown to the user right below the assembly information. +|=== + + +.New assembly form: Duration +|=== +|Field |Type |Description + +|Date created +|Optional +|Information that's displayed in the assembly metadata sidebar. Expected format: dd/mm/yyyy + +|Included at +|Optional +|Information that's displayed in the assembly metadata sidebar. The date when this assembly was added to Decidim. It does +not necessarily have to be the same as the creation date. Expected format: dd/mm/yyyy + +|Duration +|Optional +|Information that's displayed in the assembly metadata sidebar. If the duration of this assembly is limited, select the +end date. Otherwise, it will appear as indefinite. Expected format: dd/mm/yyyy + +|Closing date +|Optional +|Information that's displayed in the assembly metadata sidebar. When this assembly closed. Expected format: dd/mm/yyyy + +|Closing date reason +|Optional +|Information that's displayed in the assembly metadata sidebar. Why this assembly closed. +|=== + + +.New assembly form: Images +|=== +|Field |Type |Description + +|Home image +|Optional +|Image that will be used in presentation cards of this assembly. Guidance for file: Has to be an image or a document. +For images, use preferably landscape images that does not have any text, the service crops the image. Maximum file size: 10MB +Allowed file extensions: jpeg jpg png + +|Banner image +|Optional +|Image that will be used inside of the assembly. Guidance for file: Has to be an image or a document. +For images, use preferably landscape images that does not have any text, the service crops the image. Maximum file size: 10MB +Allowed file extensions: jpeg jpg png +|=== + + +.New assembly form: Filters +|=== +|Field |Type |Description + +|Scopes enabled +|Optional +|Check if you want to have Scopes filtering in this assembly. + +|Scope +|Optional +|Which xref:admin:scopes.adoc[Scope] does this assembly belongs to. + +|Area +|Optional +|Which xref:admin:areas.adoc[Area] does this assembly belongs to. +|=== + + +.New assembly form: Metadata +|=== +|Field |Type |Description + +|What is decided +|Optional +|Information that's displayed in the assembly metadata sidebar. + +|How is it decided +|Optional +|Information that's displayed in the assembly metadata sidebar. + +|Scope metadata +|Optional +|Information that's displayed in the assembly metadata sidebar. + +|Promoter group +|Optional +|Information that's displayed in the assembly metadata sidebar. + +|Organization area +|Optional +|Information that's displayed in the assembly metadata sidebar. + +|Who participates +|Optional +|Information that's displayed in the assembly metadata sidebar. +|=== + + +.New assembly form: Visibility +|=== +|Field |Type |Description + +|Parent assembly +|Optional +|What is the assembly that this assembly belongs to. For instance in Metadecidim, the https://meta.decidim.org/assemblies/coordination-committee[Coordination Committee] +has the parent assembly of the https://meta.decidim.org/assemblies/general-assembly-association[General%20Assembly%20of%20the%20Decidim%20Association]. + +|Highlighted +|Optional +|Check if you want the assembly to have more visibility in the Assemblies public list. It'll also be visible in the +Assembly Content Block in the xref:admin:homepage.adoc[Homepage] configuration. + +|Private space +|Optional +|Check if this assembly should only be accessible by xref:admin:spaces/assemblies/private_participants.adoc[Private Participants] + +|Is transparent +|Optional +|Check if this assembly is private but should be visible to all the rest of participants. This means that other participants +or visitors will see it but they won't be able to interact with it. +|=== + + +.New assembly form: Other +|=== +|Field |Type |Description + +|Created by +|Optional +|Choose one of "City Council", "Public" or "Other". If it's Other, you can specify the name of the organization that created +this assembly. + +|Assembly type +|Optional +|Which xref:_assemblies_types[assembly type] is this assembly. + +|Related processes +|Optional +|Select other participatory processes that are related to this assembly. + +|Social +|Optional +|Which social networks profile does this assembly has. Can be Twitter, Facebook, Instagram, YouTube and/or GitHub. It's +displayed in the assembly metadata sidebar. + +|Show statistics +|Optional +|Check if you want to show the Statistics section. +|=== + +After you've initially created your assembly you have a submenu where you need to keep configuring more information +about your assembly. + +image:assembly_submenu.png[Assembly submenu in admin] + +Here you can keep configuring your process: + +. Info: the same form that we explained in this page. +. xref:admin:spaces/assemblies/components.adoc[Components] +. xref:admin:spaces/assemblies/categories.adoc[Categories] +. xref:admin:spaces/assemblies/attachments.adoc[Attachments] +. xref:admin:spaces/assemblies/members.adoc[Members] +. xref:admin:spaces/assemblies/admins.adoc[Assembly admins] +. xref:admin:spaces/assemblies/private_participants.adoc[Private participants] +. xref:admin:spaces/assemblies/moderations.adoc[Moderations] + +== Assemblies types + +For clasyfing the assemblies in different kinds, you can define Assembly types. These types can be filtered in the public +assemblies page. + +image:assemblies_type_filters.png[Filter by assembly type] + +image:assemblies_new_type_form.png[New assembly type form] + + +.New assembly type form +|=== +|Field |Type |Description + +|Title +|Required +|Title of the this assembly type. For instance, "Consultative". +|=== + +== Settings + +At the moment there's only a setting for configuring the general behaviour of assemblies. + +image:assemblies_settings.png[Assemblies settings] + + +.Settings for assemblies form +|=== +|Field |Type |Description + +|Enable organization chart +|Checkbox +|Whether you want to show the organization chart in the assemblies list. +|=== + +The organization chart is shown in the bottotm of the assemblies page. + +image:assemblies_organization_chart.png[Assemblies organization chart] + +It allows a navigation in the assemblies tree, with the possibility to see the sub-assemblies that belongs to a parent assembly. + +image:assemblies_organization_chart_filtered.png[Assemblies organization chart filtered] \ No newline at end of file From c58cf9f83cbdd2c353926338cbbd4132660da4f5 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:57 +0200 Subject: [PATCH 068/336] New translations admins.adoc (French) --- docs/fr/modules/admin/pages/spaces/assemblies/admins.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/fr/modules/admin/pages/spaces/assemblies/admins.adoc diff --git a/docs/fr/modules/admin/pages/spaces/assemblies/admins.adoc b/docs/fr/modules/admin/pages/spaces/assemblies/admins.adoc new file mode 100644 index 0000000000..59313271ef --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/assemblies/admins.adoc @@ -0,0 +1 @@ +include::partial$page_admins.adoc[] \ No newline at end of file From 5b8f023d86325f70854c90f15eaf247b93e765fc Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:54:58 +0200 Subject: [PATCH 069/336] New translations attachments.adoc (French) --- docs/fr/modules/admin/pages/spaces/assemblies/attachments.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/fr/modules/admin/pages/spaces/assemblies/attachments.adoc diff --git a/docs/fr/modules/admin/pages/spaces/assemblies/attachments.adoc b/docs/fr/modules/admin/pages/spaces/assemblies/attachments.adoc new file mode 100644 index 0000000000..493f7dc8c8 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/assemblies/attachments.adoc @@ -0,0 +1 @@ +include::partial$page_attachments.adoc[] \ No newline at end of file From cdbfbb5d936ae49371bd0e2786770fe69d309e27 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:00 +0200 Subject: [PATCH 070/336] New translations categories.adoc (French) --- docs/fr/modules/admin/pages/spaces/assemblies/categories.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/fr/modules/admin/pages/spaces/assemblies/categories.adoc diff --git a/docs/fr/modules/admin/pages/spaces/assemblies/categories.adoc b/docs/fr/modules/admin/pages/spaces/assemblies/categories.adoc new file mode 100644 index 0000000000..3ee4fc09cc --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/assemblies/categories.adoc @@ -0,0 +1 @@ +include::partial$page_categories.adoc[] \ No newline at end of file From c2727e94aa102136c76c2ab57c51ab0ed760eca9 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:01 +0200 Subject: [PATCH 071/336] New translations components.adoc (French) --- docs/fr/modules/admin/pages/spaces/assemblies/components.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/fr/modules/admin/pages/spaces/assemblies/components.adoc diff --git a/docs/fr/modules/admin/pages/spaces/assemblies/components.adoc b/docs/fr/modules/admin/pages/spaces/assemblies/components.adoc new file mode 100644 index 0000000000..7a204dda0b --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/assemblies/components.adoc @@ -0,0 +1 @@ +include::partial$page_components.adoc[] \ No newline at end of file From aae48d2f465ef0fe6ce80f6524bef4c3b8019395 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:02 +0200 Subject: [PATCH 072/336] New translations members.adoc (French) --- .../pages/spaces/assemblies/members.adoc | 72 +++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces/assemblies/members.adoc diff --git a/docs/fr/modules/admin/pages/spaces/assemblies/members.adoc b/docs/fr/modules/admin/pages/spaces/assemblies/members.adoc new file mode 100644 index 0000000000..64a7159a8f --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/assemblies/members.adoc @@ -0,0 +1,72 @@ += Assembly members + +Assembly members allow showing all the people or groups that belong to a given assembly. It's useful for being transparent. + +You can see an example in https://meta.decidim.org/assemblies/coordination-committee/members[Decidim Coordination Commitee Assembly in Metadecidim]. + +image:assembly_members.png[Assembly members of the Coordination Committee] + +== New assembly member form + +image:assembly_members_list.png[Assembly members admin list] + +For creating a new phase of a participatory process: + +. Sign in as administrator +. Go to the assemblies section in the sidebar +. Click on the assembly Edit action +. Click on the Members link in the sidebar +. Click on the "New member" button +. Fill the form + +image:assembly_members_new_form.png[Assembly members new form] + + +.New assembly member form +|=== +|Field |Type |Description + +|Participant type +|Required +|Wheter this assembly member is non-participant or existing participant. Does she already have an account created on the platform? + +|Full name +|Required if it's non-participant. +| + +|User or group +|Required if it's an existing participant. +|Type at least three characters to search. + +|Position +|Required +|Choose one of President, Vice president, Secretary, or Other. In case it's other, you can fill in the position title. + +|Weight +|Optional +|Which order will it have in relation to the other members. Having a lower number means a higher priority. For instance, if you have two members, "Member a" with weight "10" and "Member b" with weight "0", then "Member b" will be first when ordering. + +|Designation date +|Required +|When was this person or group assigned as a member of this assembly. Expected format: dd/mm/yyyy + +|Designation mode +|Optional +|How was this person designed. + +|Ceased date +|Optional +|When was this person or group ceased to be a member of this assembly. Expected format: dd/mm/yyyy + +|Gender +|Optional +|Which gender does this person most identify with. + +|Birthday +|Optional +|When was this person born. Expected format: dd/mm/yyyy + +|Birthplace +|Optional +|Where was this person born. +|=== \ No newline at end of file From 06ebada2e6e6e68f519671a9224339370f9c8f1f Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:03 +0200 Subject: [PATCH 073/336] New translations moderations.adoc (French) --- docs/fr/modules/admin/pages/spaces/assemblies/moderations.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/fr/modules/admin/pages/spaces/assemblies/moderations.adoc diff --git a/docs/fr/modules/admin/pages/spaces/assemblies/moderations.adoc b/docs/fr/modules/admin/pages/spaces/assemblies/moderations.adoc new file mode 100644 index 0000000000..12d6ac0858 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/assemblies/moderations.adoc @@ -0,0 +1 @@ +include::partial$page_moderations.adoc[] \ No newline at end of file From 2c06317b84ea8202195dd08868049b7cee07f048 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:04 +0200 Subject: [PATCH 074/336] New translations private_participants.adoc (French) --- .../admin/pages/spaces/assemblies/private_participants.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/fr/modules/admin/pages/spaces/assemblies/private_participants.adoc diff --git a/docs/fr/modules/admin/pages/spaces/assemblies/private_participants.adoc b/docs/fr/modules/admin/pages/spaces/assemblies/private_participants.adoc new file mode 100644 index 0000000000..16c939dfa3 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/assemblies/private_participants.adoc @@ -0,0 +1 @@ +include::partial$page_private_participants.adoc[] \ No newline at end of file From 5a1b67d5df7934edd32a95ab4478bf73b3bf3e50 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:05 +0200 Subject: [PATCH 075/336] New translations conferences.adoc (French) --- .../admin/pages/spaces/conferences.adoc | 169 ++++++++++++++++++ 1 file changed, 169 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces/conferences.adoc diff --git a/docs/fr/modules/admin/pages/spaces/conferences.adoc b/docs/fr/modules/admin/pages/spaces/conferences.adoc new file mode 100644 index 0000000000..405be42fa8 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/conferences.adoc @@ -0,0 +1,169 @@ += Conferences + +A conference is a collection of meetings arranged in a program, with a number of people invited as speakers, and other +information fields typical of large congresses or social events (registration, list of organizations that support or sponsor the +event, etc.). A conference can be a relevant event for an organization and its members, or take place as part of a participatory +process or follow a consultation. + +Examples: + +* A general assembly for an organization +* The annual meeting of a cooperative + +As a real world example you can see the anual Metadecidim conferences: + +image:spaces/conferences/example01.png[Decidim Fest 2020] + +* https://meta.decidim.org/conferences/decidimfest19[Decidim Fest 2019] +* https://meta.decidim.org/conferences/decidimfest2020[Decidim Fest 2020] +* https://meta.decidim.org/conferences/DecidimFest21[Decidim Fest 2021] + +== Create a new conference + +For adding a new conference, you need to: + +image:spaces/conferences/menu.png[Conferences menu] + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button "Conferences" +. Click in the button "Create a new conference" +. Configure the conference by filling the form + +image:spaces/conferences/new_conference.png[Create a new conference form] + + +.Create a new conference +|=== +|Field |Type |Description + +|Title +|Required +|What is the title of this conference. For instance "Decidim Fest 2021" + +|Slogan +|Required +|A subtitle for this conference. For instance, "Democracy, Technology and Global Justice" + +|URL slug +|Required +|URL slugs are used to generate the URLs that point to this conference. Only accepts letters, numbers, and dashes, and +must start with a letter. Example: if your domain is 'example.org' and your slug 'DecidimFest21' then your URL will be +https://example.org/conferences/DecidimFest21 + +|Hashtag +|Optional +|Hashtag for Twitter + +|Highlighted +|Optional +|Should this conference be more prominent than others? For instance, is this an ongoing or a conference that has happened years ago? + +|Short description +|Required +|A short explanation of what's your conference about. + +|Description +|Required +|A long explanation of what's your conference about. + +|Objectives +|Optional +|What are the objectives or goals for this conference? + +|Location +|Optional +|Where will this conference take place? + +|Home image +|Optional +|Preferrably a landscape image that does not have any text. The service crops +the image. Maximum file size: 10MB. Allowed file extensions: jpeg jpg png + +|Banner image +|Optional +|Preferrably a landscape image that does not have any text. The service crops +the image. Maximum file size: 10MB. Allowed file extensions: jpeg jpg png + +|Scopes enabled +|Optional +|Check if you want to have Scopes filtering in this conference + +|Scope +|Optional +|Which xref:admin:scopes.adoc[Scope] does this conference belongs to. + +|Show statistics +|Optional +|Check if you want to show the Statistics section. + +|Start date +|Required +|When will this conference start. Expected format: dd/mm/yyyy + +|End date +|Required +|When will this conference end. Expected format: dd/mm/yyyy + +|Registrations enabled +|Optional +|Check if you want to handle registrations on the platform. + +|Available slots +|Optional +|Leave it to 0 if you have unlimited slots available. + +|Registration terms +|Required if "Registrations enabled" is checked +|What are the terms of service or conditions that a participant must accept for registering in this conference? + +|Related participatory processes +|Optional +|Select the processes that are related to this conference. Use the *ctrl* function to select more than one option. + +|Related Assemblies +|Optional +|Select the assemblies that are related to this conference. Use the *ctrl* function to select more than one option. + +|Related Consultations +|Optional +|Select the consultations that are related to this conference. Use the *ctrl* function to select more than one option. +|=== + +== Creating the program + +For creating the program of the conference you need to create a new xref:components/meetings.adoc[Meeting component] with the +dates and times of the different talks, workshops, sessions, etc. After publishing the meetings, it will be visible in the landing page +and there'll be a special navigation for these meetings so they're ordered by date and time. + +image:spaces/conferences/program_frontend.png[Conferences program (frontend)] + +image:spaces/conferences/program_backend.png[Conferences program (backend)] + +Also if you they are "In person" meetings with a location then you'll have a list of the venues. + +image:spaces/conferences/program_venues_frontend.png[Conferences venues (frontend)] + +== Menu + +image:spaces/conferences/manage_conferences.png[Conferences list at admin panel] + +After you’ve initially created your conference you have a submenu where you need +to keep configuring more information about it. + +image:spaces/conferences/sidebar.png[Conferences sidebar] + +. Info: the same form that we explained in this page. +. xref:admin:spaces/conferences/components.adoc[Components] +. xref:admin:spaces/conferences/categories.adoc[Categories] +. xref:admin:spaces/conferences/attachments.adoc[Attachments] +. xref:admin:spaces/conferences/media_links.adoc[Media Links] +. xref:admin:spaces/conferences/partners.adoc[Partners] +. xref:admin:spaces/conferences/speakers.adoc[Speakers] +. xref:admin:spaces/conferences/registrations.adoc[Registrations] +.. xref:admin:spaces/conferences/registrations/types.adoc[Registration Types] +.. xref:admin:spaces/conferences/registrations/users.adoc[User Registrations] +.. xref:admin:spaces/conferences/registrations/invites.adoc[Invites] +.. xref:admin:spaces/conferences/registrations/certificates.adoc[Certificate of Attendance] +. xref:admin:spaces/conferences/admins.adoc[Conference admins] +. xref:admin:spaces/conferences/moderations.adoc[Moderations] \ No newline at end of file From e7cac2b9333dec6d004c3600e2a1d8a06856ac29 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:06 +0200 Subject: [PATCH 076/336] New translations admins.adoc (French) --- docs/fr/modules/admin/pages/spaces/conferences/admins.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/fr/modules/admin/pages/spaces/conferences/admins.adoc diff --git a/docs/fr/modules/admin/pages/spaces/conferences/admins.adoc b/docs/fr/modules/admin/pages/spaces/conferences/admins.adoc new file mode 100644 index 0000000000..59313271ef --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/conferences/admins.adoc @@ -0,0 +1 @@ +include::partial$page_admins.adoc[] \ No newline at end of file From 913f33a1027e0767f8349c6507ed649bbc3bee54 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:07 +0200 Subject: [PATCH 077/336] New translations attachments.adoc (French) --- .../pages/spaces/conferences/attachments.adoc | 81 +++++++++++++++++++ 1 file changed, 81 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces/conferences/attachments.adoc diff --git a/docs/fr/modules/admin/pages/spaces/conferences/attachments.adoc b/docs/fr/modules/admin/pages/spaces/conferences/attachments.adoc new file mode 100644 index 0000000000..d36f3e32d1 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/conferences/attachments.adoc @@ -0,0 +1,81 @@ += Attachments + +Attachments allow an administrator to upload static files to a conference. + +When a conference is launched, it is important to provide citizens with as much information as possible about them so +that they can participate with knowledge. That is why it is helpful to add files (Attachments) with the information that +is considered relevant. + +Optionally, these documents can be grouped in *Folders*. + +They can be found on the Conference "Media and links" section: + +image:spaces/conferences/attachments.png[Conferences attachments (backend)] + +image:spaces/conferences/media_links_frontend.png[Conferences attachments (frontend)] + +Read more about this in xref:admin:spaces/conferences/media_links.adoc[Media links]. + +== Create a new attachment + +image:spaces/attachments_admin.png[View the attachments of a conference in the admin interface] + +For creating a new phase of a conference: + +. Sign in as administrator +. Go to the conference section in the sidebar +. Click on the conference Edit action +. Click on the Attachments link in the sidebar +. Click on the "New attachment" button + +image:spaces/attachments_new_form.png[Create a new attachment form] + + +.Create attachment +|=== +|Field |Type |Description + +|Attachment or image name +|Required +|What is the title for this attachment. + +|Weight +|Optional +|Which order will it have in relation to the other attachments. Having a lower number means a higher priority. For instance, if you have two categories, "Attachment a" with weight "10" and "Attachment b" with weight "0", then "Attachment b" will be first when ordering. + +|Description +|Required +|A long description explaining what this file is about. + +|Folder +|Optional +|Which folder this attachment belongs to. + +|File +|Required +|Upload the file. Guidance for file: Has to be an image or a document. For images, use preferrably landscape images, the +service crops the image. For CSV files, the separator between columns must be a comma (","). Maximum file size: 10MB. Allowed +file extensions depends in your server configuration. +|=== + +== Create a new folder + +image:spaces/attachments_new_folder_form.png[Create a new folder for attachments form] + + +.Create folder +|=== +|Field |Type |Description + +|Name +|Required +|Name of the folder + +|Weight +|Optional +|Which order will it have in relation to the other folders. Having a lower number means a higher priority. For instance, if you have two folders, "Folder a" with weight "10" and "Folder b" with weight "0", then "Folder b" will be first when ordering. + +|Description +|Required +|A long description explaining what this folder is about. +|=== \ No newline at end of file From 61c9d46c1a3e8ea89df82e6996f34944bd5fb3af Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:08 +0200 Subject: [PATCH 078/336] New translations categories.adoc (French) --- docs/fr/modules/admin/pages/spaces/conferences/categories.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/fr/modules/admin/pages/spaces/conferences/categories.adoc diff --git a/docs/fr/modules/admin/pages/spaces/conferences/categories.adoc b/docs/fr/modules/admin/pages/spaces/conferences/categories.adoc new file mode 100644 index 0000000000..3ee4fc09cc --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/conferences/categories.adoc @@ -0,0 +1 @@ +include::partial$page_categories.adoc[] \ No newline at end of file From a4dc0776113a331a6f33ab2fef9cd0a610ee4fed Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:09 +0200 Subject: [PATCH 079/336] New translations components.adoc (French) --- docs/fr/modules/admin/pages/spaces/conferences/components.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/fr/modules/admin/pages/spaces/conferences/components.adoc diff --git a/docs/fr/modules/admin/pages/spaces/conferences/components.adoc b/docs/fr/modules/admin/pages/spaces/conferences/components.adoc new file mode 100644 index 0000000000..7a204dda0b --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/conferences/components.adoc @@ -0,0 +1 @@ +include::partial$page_components.adoc[] \ No newline at end of file From 84ccc5cccc36c67b6ab54e917355d65f3e1107cc Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:11 +0200 Subject: [PATCH 080/336] New translations media_links.adoc (French) --- .../pages/spaces/conferences/media_links.adoc | 45 +++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces/conferences/media_links.adoc diff --git a/docs/fr/modules/admin/pages/spaces/conferences/media_links.adoc b/docs/fr/modules/admin/pages/spaces/conferences/media_links.adoc new file mode 100644 index 0000000000..d39ad23e1d --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/conferences/media_links.adoc @@ -0,0 +1,45 @@ += Media links + +Conferences can have a section called "Media and links". It shows a list of media files and links that are associated to the conference. + +The media files are the files from the xref:admin:spaces/conferences/attachments.adoc[attachments] sections. +The media links are defined in a section in the admin panel of the conference. + +image:spaces/conferences/media_links_frontend.png[Conferences media links (frontend)] + +== Create a new media link + +image:spaces/conferences/media_links_backend.png[Conferences media links] + +For creating a new media link of a conference: + +. Sign in as administrator +. Go to the conferences section in the sidebar +. Click on the conference Edit action +. Click on the "Media links" link in the sidebar +. Click on the "New Media Link" button +. Fill the form + +image:spaces/conferences/new_media_link.png[Create a new conferences media link] + + +.New media link form +|=== +|Field |Type |Description + +|Title +|Required +|The title of the link + +|Link +|Required +|URL of the link + +|Date +|Required +|Published date of the link + +|Weight +|Optional +|Which order will it have in relation to the other links. Having a lower number means a higher priority. For instance, if you have two links, "Link a" with weight "10" and "Link b" with weight "0", then "Link b" will be first when ordering. +|=== \ No newline at end of file From 9318f633a775387f5f98fa24aa46d19ce00befd0 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:12 +0200 Subject: [PATCH 081/336] New translations moderations.adoc (French) --- docs/fr/modules/admin/pages/spaces/conferences/moderations.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/fr/modules/admin/pages/spaces/conferences/moderations.adoc diff --git a/docs/fr/modules/admin/pages/spaces/conferences/moderations.adoc b/docs/fr/modules/admin/pages/spaces/conferences/moderations.adoc new file mode 100644 index 0000000000..12d6ac0858 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/conferences/moderations.adoc @@ -0,0 +1 @@ +include::partial$page_moderations.adoc[] \ No newline at end of file From 416602493de2de096c615576e140fbbecf2e5be5 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:13 +0200 Subject: [PATCH 082/336] New translations partners.adoc (French) --- .../pages/spaces/conferences/partners.adoc | 47 +++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces/conferences/partners.adoc diff --git a/docs/fr/modules/admin/pages/spaces/conferences/partners.adoc b/docs/fr/modules/admin/pages/spaces/conferences/partners.adoc new file mode 100644 index 0000000000..e9d5fd13d6 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/conferences/partners.adoc @@ -0,0 +1,47 @@ += Partners + +The partners are the sponsors or supporters of a conference. They are listed on the Conference landing page. + +image:spaces/conferences/partners_frontend.png[Conferences partners (frontend)] + +== Create a new partner + +image:spaces/conferences/partners.png[Conferences partners] + +For creating a new partner of a conference: + +. Sign in as administrator +. Go to the conferences section in the sidebar +. Click on the conference Edit action +. Click on the Partners link in the sidebar +. Click on the "New partner" button +. Fill the form + +image:spaces/conferences/new_partner.png[Conferences partners form] + + +.New partner form +|=== +|Field |Type |Description + +|Name +|Required +|What is the name of this partner. + +|Partner type +|Required +|Choose one of these options: Main promotor or Collaborator + +|Weight +|Optional +|Which order will it have in relation to the other partners. Having a lower number means a higher priority. For instance, if you have two partners, "Partner a" with weight "10" and "Partner b" with weight "0", then "Partner b" will be first when ordering. + +|Link +| +| + +|Logo +|Required +|Guidance for image: Preferably a landscape image that does not have any text. The service crops the image. Maximum file size: 5MB +Allowed file extensions: jpg jpeg gif png bmp ico +|=== \ No newline at end of file From 6d1c648ec4e77709325055c1d22ed86145c5fd0e Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:15 +0200 Subject: [PATCH 083/336] New translations registrations.adoc (French) --- .../pages/spaces/conferences/registrations.adoc | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces/conferences/registrations.adoc diff --git a/docs/fr/modules/admin/pages/spaces/conferences/registrations.adoc b/docs/fr/modules/admin/pages/spaces/conferences/registrations.adoc new file mode 100644 index 0000000000..0aa2935425 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/conferences/registrations.adoc @@ -0,0 +1,12 @@ += Registrations + +As an administrator of a conference you can manage the registrations for the conference from the platform. + +For doing so, you have these admin sections: + +. xref:admin:spaces/conferences/registrations/types.adoc[**Registrations Types**] allows you to define which ways of registering participants +will have. For instance if there are a number of prices depending if the attendees are students or workers. +. xref:admin:spaces/conferences/registrations/users.adoc[**User Registrations**] allows you to confirm the requests for attending the conference. +. xref:admin:spaces/conferences/registrations/invites.adoc[**Invites**] allows you to invite participants to the conference. +. xref:admin:spaces/conferences/registrations/certificates.adoc[**Certificates of Attendance**] allows you to configure and send certificates +of attendance in PDF format to people that has gone to the conference. \ No newline at end of file From afc4f2aa8e0cb63249fa335966db18408298a239 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:16 +0200 Subject: [PATCH 084/336] New translations certificates.adoc (French) --- .../registrations/certificates.adoc | 39 +++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces/conferences/registrations/certificates.adoc diff --git a/docs/fr/modules/admin/pages/spaces/conferences/registrations/certificates.adoc b/docs/fr/modules/admin/pages/spaces/conferences/registrations/certificates.adoc new file mode 100644 index 0000000000..2e526c32a2 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/conferences/registrations/certificates.adoc @@ -0,0 +1,39 @@ += Certificates of Attendance + +Administrators can create Certificates of Attendance to participants. + +image:spaces/conferences/certificates_of_attendance.png[Conferences Certificate of Attendance (backend)] + + +.Certificate of Attendance form +|=== +|Field |Type |Description + +|Main logo +|Required +|Logo of the conference of the organization that makes the certificate of attendance. + +|Signature +|Required +|Image of the person that signs the certificate. + +|Sign date +|Required +|Date of the signature. Expected format: dd/mm/yyyy + +|Signature name +|Required +|Name of the person that signs the certificate. +|=== + +After the form is filled then there's a button to "Send certificates of attendance" to all the confirmed xref:admin:spaces/conferences/registrations/users.adoc[registrations] of the conference. + +image:spaces/conferences/certificates_of_attendance_button.png[Conferences Certificate of Attendance send button] + +Once it's sent it can't be resent. + +image:spaces/conferences/certificates_of_attendance_button_disabled.png[Conferences Certificate of Attendance send disabled button] + +The certificates of attendance are sent to the participants by email in PDF format. + +image:spaces/conferences/certificates_of_attendance_pdf.png[Conferences Certificate of Attendance (frontend)] \ No newline at end of file From 3e62b198f1639532b1e51f5d9ac944108e45f26c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:18 +0200 Subject: [PATCH 085/336] New translations invites.adoc (French) --- .../conferences/registrations/invites.adoc | 38 +++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces/conferences/registrations/invites.adoc diff --git a/docs/fr/modules/admin/pages/spaces/conferences/registrations/invites.adoc b/docs/fr/modules/admin/pages/spaces/conferences/registrations/invites.adoc new file mode 100644 index 0000000000..bd02c5da95 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/conferences/registrations/invites.adoc @@ -0,0 +1,38 @@ += Invites + +Administrators can invite participants to join the conference. + +image:spaces/conferences/invites.png[Conferences user invites (backend)] + +== Flow + +. An administrator sends an invitation to join the conference to a non-existing or existing participant +. The participant accepts the invitation + +image:spaces/conferences/invite_participant_form.png[Invite a participant form] + + +.Invite participant form +|=== +|Field |Type |Description + +|Attendee type +|Required +|Wheter this invited person is a non-existing or existing participant. Does she already have an account created on the platform? + +|Name +|Required if it's a non-existing participant. +|Name of the invited person. + +|Email +|Required if it's a non-existing participant. +|Email of the invited person. + +|User +|Required if it's an existing participant. +|Type at least three characters to search. + +|xref:admin:spaces/conferences/registrations/types.adoc[Registration type] +|Required +|What xref:admin:spaces/conferences/registrations/types.adoc[registration type] does this participant will have. +|=== \ No newline at end of file From e4421c3f5b22ee472d091d54e50921d8c46bd4c8 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:19 +0200 Subject: [PATCH 086/336] New translations types.adoc (French) --- .../conferences/registrations/types.adoc | 56 +++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces/conferences/registrations/types.adoc diff --git a/docs/fr/modules/admin/pages/spaces/conferences/registrations/types.adoc b/docs/fr/modules/admin/pages/spaces/conferences/registrations/types.adoc new file mode 100644 index 0000000000..1625887826 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/conferences/registrations/types.adoc @@ -0,0 +1,56 @@ += Registration types + +You can enable registrations in conferences, so it's easier to register to the whole conference, or by days, rather than +going meeting by meeting to enable registration for that particular event. + +After enabling registrations participants will have a button to register to the conference in the landing and the conference's header. + +image:spaces/conferences/registration_landing01.png[Registration button on landing page] + +image:spaces/conferences/registration_landing02.png[Registration button on landing page] + +If you want to enable registration you'll need to define and publish at least one registration type. + +image:spaces/conferences/registration_types_frontend_wo_user.png[Select registration type without a user account] + +== Create a new registration type + +For adding a new registration type, you need to: + +. Sign in as administrator +. Go to the conferences section in the sidebar +. Click on the conference Edit action +. Click on the "Registration types" link in the sidebar +. Click on the "New Registration type" button +. Fill the form +. Publish the registration type + +image:spaces/conferences/new_registration_type.png[Create a new registration type form] + +image:spaces/conferences/registration_types_backend.png[Manage registration types] + + +.Create a new registration type +|=== +|Field |Type |Description + +|Title +|Required +|What is the title of this registration type. + +|Weight +|Which order will it have in relation to the other types. Having a lower number means a higher priority. For instance, if you have two types, "Day 1" with weight "10" and "Day 2" with weight "0", then "Day 2" will be first when ordering. +|Description + +|Required +|Description for this registration type +|Price + +|Optional +|Define a price for this registration type. If you don't define a price, the price will be "Free". +|Select conference meetings +|=== + +If the participant is already logged in then she'll see her username and email in the registration page. + +image:spaces/conferences/registration_types_frontend_w_user.png[Select registration type with user account] \ No newline at end of file From 1eca2078ce0aa6736bd44ba59347452fa0236783 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:20 +0200 Subject: [PATCH 087/336] New translations users.adoc (French) --- .../conferences/registrations/users.adoc | 27 +++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces/conferences/registrations/users.adoc diff --git a/docs/fr/modules/admin/pages/spaces/conferences/registrations/users.adoc b/docs/fr/modules/admin/pages/spaces/conferences/registrations/users.adoc new file mode 100644 index 0000000000..33dc8d6b46 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/conferences/registrations/users.adoc @@ -0,0 +1,27 @@ += User registrations + +After participants have registered, they will appear in this section. + +image:spaces/conferences/user_registrations.png[Conferences user registrations (backend)] + +As an administrator, you can: + +* Export the registrations +* Confirm a registration + +== Export + +It's possible to export the registrations in multiple formats: CSV, JSON, and XLSX (Excel). + +== Flow + +. A participant registers to the conference +. She receives a pending registration notification +image:spaces/conferences/user_registration_pending_notification.png[Notification for pending user registration] +. She receives a pending registration email +image:spaces/conferences/user_registration_pending_email.png[Email for pending user registration] +. An administrator reviews and confirms the registration with the image:action_check.png[Confirm] button +. The participant receives a confirmed registration notification +image:spaces/conferences/user_registration_confirmed_notification.png[Notification for confirmed user registration] +. She receives a confirmed registration email with an calendar file (.ICS). +image:spaces/conferences/user_registration_confirmed_email.png[Email for confirmed user registration] \ No newline at end of file From 4b930f3b1cbe8d5e0a53690f8cd06358a4c33000 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:22 +0200 Subject: [PATCH 088/336] New translations speakers.adoc (French) --- .../pages/spaces/conferences/speakers.adoc | 68 +++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces/conferences/speakers.adoc diff --git a/docs/fr/modules/admin/pages/spaces/conferences/speakers.adoc b/docs/fr/modules/admin/pages/spaces/conferences/speakers.adoc new file mode 100644 index 0000000000..f62160a3e8 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/conferences/speakers.adoc @@ -0,0 +1,68 @@ += Speakers + +The speakers are people that are going to talk at the conference. + +image:spaces/conferences/speakers_frontend.png[Conferences speakers (frontend)] + +== Create a new speaker + +image:spaces/conferences/speakers.png[Conferences speakers] + +For creating a new speaker of a conference: + +. Sign in as administrator +. Go to the conferences section in the sidebar +. Click on the conference Edit action +. Click on the Speakers link in the sidebar +. Click on the "New Conference Speaker" button +. Fill the form + +image:spaces/conferences/new_speaker.png[Conferences speakers] + + +.New conference speaker form +|=== +|Field |Type |Description + +|Participant type +|Required +|Wheter this speaker is a non-participant or existing participant. Does she already have an account created on the platform? + +|Full name +|Required if it's non-participant. +|Name of the speaker. + +|User or group +|Required if it's an existing participant. +|Type at least three characters to search. + +|Related meetings +|Optional +|Which meetings does this speaker attend and participates actively? + +|Position +|Required +|Metadata for showing extra information about the speaker. + +|Affiliation +|Required +|Metadata for showing extra information about the speaker. + +|Short Bio +|Optional +|Metadata for showing extra information about the speaker. + +|Twitter handle +|Optional +|Metadata for showing extra information about the speaker. + +|Personal URL +|Optional +|Metadata for showing extra information about the speaker. + +|Avatar +|Optional +|Metadata for showing extra information about the speaker. + +Default image +|=== \ No newline at end of file From 3107821add41e8f39052e467b7036ca87a86f45e Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:23 +0200 Subject: [PATCH 089/336] New translations consultations.adoc (French) --- docs/fr/modules/admin/pages/spaces/consultations.adoc | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces/consultations.adoc diff --git a/docs/fr/modules/admin/pages/spaces/consultations.adoc b/docs/fr/modules/admin/pages/spaces/consultations.adoc new file mode 100644 index 0000000000..452763a87f --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/consultations.adoc @@ -0,0 +1,3 @@ += Consultations + +include::partial$deprecated.adoc[] \ No newline at end of file From a6517c4539d673ef6dc4b0183d07f6658aa2523b Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:24 +0200 Subject: [PATCH 090/336] New translations initiatives.adoc (French) --- .../admin/pages/spaces/initiatives.adoc | 408 ++++++++++++++++++ 1 file changed, 408 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces/initiatives.adoc diff --git a/docs/fr/modules/admin/pages/spaces/initiatives.adoc b/docs/fr/modules/admin/pages/spaces/initiatives.adoc new file mode 100644 index 0000000000..46f1682500 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/initiatives.adoc @@ -0,0 +1,408 @@ += Initiatives + +An initiative is a special type of participatory process that can be promoted by anyone (independently of other channels or participation spaces) through the collection of (online and in-person) signatures for the organization to carry out a specific action (modify a regulation, initiate a project, change the name of a department or a street, etc.). + +The promoters of an initiative can define its objectives, gather support, debate, disseminate it and define meeting points where signatures can be collected from the attendees or debates open to other participants. + +Examples: An initiative can collect signatures to call for a consultation among all the people of an organization, or to create an assembly, or to call for a process of budget increase for a territory or area of the organization. During the process of collecting signatures, more people can add to this demand and carry it forward in the organization. + +Initiatives are to be distinguished from the other participation spaces because they can be used as a participatory tool or mechanism promoted by participants. In other words, the initiatives are mechanisms for semi-direct democracy through which participants can promote a certain action of common interest to the organization, by collecting a specific number of signatures. In this case, what the organization has to do is enable the promotion of these initiatives and offer the necessary technical support and advice to the people concerned. The role of the platform’s administrator, then, is somewhat different from that of the other participation spaces. + +In the first place, you will have to configure the various forms of initiatives. This could be specified in a regulation (like a municipal normative or state law), specifying the number of signatures required for processing the various types of initiatives. For example, an initiative for incorporating one or several items into the Municipal Council’s agenda evidently requires fewer signatures than another initiative for promoting a binding consultation. + +== 0. Initiative setup + +How initiatives work depends on two things: how the initiative module is configured through the xref:admin:initiatives_initializer.adoc[initializer] (in code) and how the initiative type is configured in the administration panel. + +Regarding initiatives type, **an administrator** needs to define one. For Initiatives to work on an organization there must be at least one initiative type created and configured with at least one initiative type scope. If there's only one type then the participant will not get the possibility to choose the initiative type, this step will be skipped in the initiative creation wizard. + +Some real examples from the city of Barcelona are: + +* To add an item to the Municipal Council or Districts agendas +* To perform a participatory process +* To create a new assembly +* To approve or modify a regulation +* To request the holding of a citizen consultation +* To call for assemblies (neighborhood councils or public audiences) + +=== New initiative type form + +image:admin_initiative_type.png[New initiative type form] + + +.Admin new initiative type form: General information +|=== +|Field |Type |Description + +|Title +|Required +|Title of the initiative type. For instance, "New park at city center". + +|Description +|Required +|Explanation of what can be done with this initiative type. + +|Banner image +|Required +|An image for this initiative type. NOTE: At the moment this is not used. +|=== + + +.Admin new initiative type form: Options +|=== +|Field |Type |Description + +|Signature type +|Optional +|Which kind of signature type will be allowed. Options are: Online, In-person and Mixed. The Mixed option allows a participant to choose which signature type will have the initiative. + +|Enable attachments +|Optional +|Whether it'll allow to upload attachments to initiatives. + +|Enable participants to undo their online signatures +|Optional +|Can a participant undo its signature when they already signed? + +|Enable authors to choose the end of the signature collection period +|Optional +|Can the authors of an initiative change the end of the signature collection period? + +|Enable authors to choose the area for their initiative +|Optional +|Can the authors choose the area of their initiative? + +|Enable child scope signatures +|Optional +|This config flag doesn't support offline votes, it enables sub-scopes and works with an authorization handler that associates a scope to the user, make sure you select that authorization, bellow in authorization settings. For it to work, scopes need to be configured in a hierarchical way : 1 Parent - N Child. + +|Only allow global scope initiatives creation +|Optional +|Tick this flag if you enabled "Child scope signature" and configured the global scope as your parent scope. By enabling this, scope selection will be skipped in the initiative creation wizard. + +|Enable promoting committee +|Optional +|Whether it will only allow individual initiatives (made by only one person) or allow collective initiatives (multiple promoters, being multiple individuals or a user group). + +|Minimum of committee members +|Optional +|When "Enable promoting committee" option is checked, defines the minimum number of promoter's committee member to send the initiative to technical validation + +|Collect participant personal data on signature +|Optional +|Adds a step to the signature process. When a participant clicks on the signature button, she'll be redirected to a form asking for some personal data. This will be used with the PDF export action after the recollection period has ended. + +|Legal information about the collection of personal data +|Depends on whether the option "Collect participant personal data on the signature" is checked +|Privacy notice and terms of use for the participant personal data during the signature process. +|=== + + +.Admin new initiative type form: Authorization settings +|=== +|Field |Type |Description + +|Authorization to verify document number on signatures +|Optional +|When a participant is making the signature process, will she be asked for an authorization? + +|Add SMS code validation step to the signature process +| +|During the signature process, will it ask for SMS validation? +|=== + +=== New initiative type scope form + +An initiative type can also have scopes associated. For Initiatives it needs at least one scope configured. + +image:admin_initiative_type_scope.png[New initiative type form] + + +.Admin new initiative type scope form +|=== +|Field |Type |Description + +|Scopes +|Required +|A Scope. An author can choose this scope in the creation of the initiative. + +|Signatures required +|Required +|Number of signatures the initiative need to have before the end period so it can be accepted. +|=== + +== 1. Create an initiative + +This action is done by **the author**. The author is a participant that creates the initiative. Depending on how the initiatives module is configured in the initializer or how the initiative type is configured, it may need to ask for authorization, or it will even not show the "New initiative" button. + +image:initiative_list.png[Initiatives list] + +For creating an initiative, a participant must click in the "New initiative" button. Then she'll have a wizard with multiple steps: + +=== 1.1 Choose the initiative type + +image:initiative_new_step1.png[Initiative creation: step 1] + +=== 1.2 Add title and description + +image:initiative_new_step2.png[Initiative creation: step 2] + +=== 1.3 [Optional] Similarity comparison + +Checks the rest of the initiatives if there are other similar initiatives. If there are, the system will show them before continuing. This is a way to avoid duplicates. + +=== 1.4 Finish + +image:initiative_new_step3.png[Initiative creation: step 3] + +image:initiative_new_step4.png[Initiative creation: step 4] + +=== Actions after it was created + +After the initiative was created, a participant can see the initiative page, but until the initiative is reviewed and accepted by an administrator, through the technical validation, it will not be published and visible for all the participants. + +image:initiative_show.png[Initiative show] + +In the sidebar a participant can make some actions: Edit, Print and Send to technical validation. + +image:initiative_actions.png[Initiative actions] + +==== Edit + +After the initiative was created and before it was sent to technical validation, **an author** can edit and correct the initiative if it has any error. + +image:initiative_edit.png[Initiative edit] + +==== Print + +An author can also print the initiative. + +image:initiative_print.png[Print an initiative] + +==== Technical validation + +After the author has reviewed how the initiative will look, she can send it to technical validation. + +image:initiative_send_to_technical_validation.png[Send initiative to technical validation] + +== 2. Send initiative to technical validation + +This action is done by **the author**. + +After it has been reviewed by the author, it can be sent to "Technical validation", but it depends in the configuration of the initiative type, in whether the options "Enable promoting committee" and "Minimum of committee members" are configured. + +=== Promoter's committee + +An initiative type can optionally be supported by a promoter's committee, with a minimum number of committee members. Once the user has created the initiative and before it can be sent for technical validation they need to invite committee members to promote it. + +When the user has created the initiative they will be given a link to share with possible committee members, which will look something like `/initiatives/.../committee_requests/new` + +When a prospective committee member opens the link, they can click a button which allows them to request to be part of the committee. The initiative author then needs to approve each request. The author can approve them by clicking on the "Edit" button of their initiative at the bottom of the form they can approve or reject committee members. + +image:initiative_commitee_members_send_to_technical_false.png[Initiative promotor committee: edit screen] + +The initiative cannot be sent to technical validation until it meets the minimum number of committee members required. You can find the invitation link in the edit form. + +image:initiative_edit_commitee_members.png[Initiative promotor committee: edit screen] + +Share the invitation link with the people you'd like to have on your committee. + +image:initiative_commitee_members_ask.png[Initiative promotor committee: edit screen] + +The people invited with the link will be able to read the initiative and ask to be part of the committee. + +image:initiative_commitee_members_sent.png[Initiative promotor committee: edit screen] + +The request is sent and the author can then and accept or refuse it in the initiative edit form. + +image:initiative_commitee_members_approve.png[Initiative promotor committee: edit screen] + +image:initiative_commitee_members_send_to_technical_true.png[Initiative promotor committee: edit screen] + +Once enough people have joined the promoter committee the initiative author can send it for +technical validation. + +== 3. Publish an initiative + +This action is done by **an administrator**. + +After the initiative was sent to technical validation by a participant, an administrator can view all the initiatives in the admin panel and make some corrections. + +image:initiative_admin_list.png[Admin initiatives list] + +=== Actions + +Regarding the actions in an initiative, an administrator can "Preview", "Edit", "Answer" or "Print" an initiative: + +image:initiative_admin_list_actions.png[Initiative admin list actions] + +|=== +|Icon |Name |Definition + +|image:action_preview.png[Preview icon] +|Preview +|To see how it's shown in the frontend to participants. + +|image:action_edit.png[Edit icon] +|Edit +|Edit form for Initiative. + +|image:action_answer.png[Answer icon] +|Answer +|Allows to answer an Initiative. + +|image:action_print.png[Print icon] +|Print +|Allows to print. +|=== + +=== Components + +Once an initiative has been created it gets the Meetings and Page component enabled by +default. The initiative author has no control over these - an admin will need to manage +them. All of the other usual components may be added by an admin too. + +image:initiative_admin_show.png[Admin initiative show page] + +There are also other features inside initiatives, like Attachments and Moderations for the comments. + +image:initiative_admin_sidebar.png[Admin initiative sidebar] + +=== Publish + +After the initiative was reviewed and technically approved by an admin, for instance for checking that what the initiative is asking is legal or abides to the normative (ie it's municipal competency), then it can be published: + +image:initiative_admin_actions.png[Admin initiative actions] + +== 4. Sign an initiative + +This action is done by **a participant**. + +After the initiative was published, it'll be visible in the initiatives listing page (/initiatives): + +image:initiative_list_published.png[Initiative list after it was published] + +image:initiative_admin_show_published.png[Admin initiative show after it was published] +image:initiative_show_published.png[Initiative show after it was published] + +And authorized participants can sign it: + +image:initiative_admin_show_published_detail.png[Admin initiative show after it was published (detail)] + +image:initiative_show_signed.png[Initiative show after it was signed] + +== 5. Export signatures + +This action is done by **an administrator**. After the initiative has started to get signatures, there's an option for exporting a PDF of the signatures: + +image:initiative_actions_export.png[Initiative actions with Export to PDF] + +image:initiative_actions_export_pdf.png[Initiative exported PDF] + +== 6. Answer an initiative + +After the initiative has collected all the signatures then it can be answered by an administrator. An initiative answer don't have different types. + +image:initiative_backend_answer.png[Initiative backend answer] + +image:initiative_frontend_answer.png[Initiative frontend answer] + +== Initiative statuses + +For better understanding all the status, this is a summary: + +|=== +|Status |Explanation + +|Created +|The initiative has been created but is not yet public for every visitor or the rest of the participants. + +|Technical validation +|The initiative needs to be reviewed by an administrator. From here, it can be "discarded" or "published" + +|Expired +|The initiative wasn't reviewed by an administrator and wasn't approved, and the maximum time for validation has passed. + +|Discarded +|The initiative was reviewed by an administrator and was discarded, so it's not published. + +|Published +|The initiative was reviewed by an administrator and was approved, so it's published. + +|Rejected +|The period for signature recollection has ended and there weren't enough signatures. + +|Accepted +|The period for signature recollection has ended and there were enough signatures. +|=== + +[plantuml] +@startuml +:Created; +:Technical validation; +if (has passed the maximum validation time?) then (yes) + #pink:Expired; + kill; +elseif (validated?) then (no) + #pink:Discarded; + kill; +else (yes) + #palegreen:Published; + if (enough signatures?) then (no) + #pink:Rejected + (not enough signatures); + kill; + else (yes) + #palegreen:Accepted + (enough signatures); + stop; + endif; +endif +@enduml + +Finally, these are all the relevant settings in every moment in the initiatives life cicle: + +[plantuml] +@startuml +(*) --> "Create a new initiative" +if "Has only one type?" then +--> [Yes] "Fill initiative form" +else +--> [No] "Select initiative type" +--> "Fill initiative form" +Endif +partition Created { + if "Is the User a UserGroup?" then + --> [Yes] "Send to Technical Validation" + else + --> [No] Collect the minimum number of committee members (2 by default) + --> "Send to Technical Validation" + Endif +} +partition Validating { + if "Has passed the maximum time for validation (60 days by default)?" then + --> [Yes] "Expired" + else + --> [No] if "Is accepted by an administrator?" then + --> [No] "Discarded" + else + --> [Yes] "Publish" + endIf + endIf +} +partition Published { + --> "Signature process" + if "Has passed the configured time window for validation (60 days by default)?" + --> [Yes] "Expired" + else + --> [No] Export PDF to signatures + --> Check signatures with offline signatures for duplicates (if the Initiative has them) + --> if "Has the initiative get the number of signatures required?" then + --> [No] Rejected + else + --> [Yes] Accepted + endIf + endIf +} +--> (*) +@enduml \ No newline at end of file From a6a97fd90ad07c87150560d40b1728647ad75aad Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:25 +0200 Subject: [PATCH 091/336] New translations processes.adoc (French) --- .../modules/admin/pages/spaces/processes.adoc | 242 ++++++++++++++++++ 1 file changed, 242 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces/processes.adoc diff --git a/docs/fr/modules/admin/pages/spaces/processes.adoc b/docs/fr/modules/admin/pages/spaces/processes.adoc new file mode 100644 index 0000000000..f833ec1522 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/processes.adoc @@ -0,0 +1,242 @@ += Processes + +A participatory process is a sequence of participatory activities (e.g. first filling out a survey, then making proposals, +discussing them in face-to-face or virtual meetings, and finally prioritizing them) with the aim of defining and making a decision on a specific topic. + +Examples of participatory processes are: a process of electing committee members (where candidatures are first presented, +then debated and finally a candidacy is chosen), participatory budgets (where proposals are made, valued economically, +and voted on with the money available), a strategic planning process, the collaborative drafting of a regulation or norm, +the design of an urban space or the production of a public policy plan. + +A really important concept for making good use of Decidim is to understand the relationship between Phases and Components +in a participatory process in Decidim: + +image::process_steps_components.png[Relation between Steps and Components in a Process in Decidim] + +What this diagram is showing is that for a participatory process you can have 7 phases: + +. Configuration & Presentation +. Diagnostic +. Proposal Creation +. Proposal Selection +. Results +. Evaluation +. Monitoring + +Inside of every one of these Phases, there are some components (like Blog, Meetings, Survey, Debates, Proposals, Results). +Some of these Components allow some features depending on the Phase that we are. + +In this section, we'll explain how we can configure a Participatory Process in Decidim. + +== List + +To configure participatory processes on the Decidim platform, click on btn:[Processes] in the admin sidebar menu. A list +will appear with the existing processes if there are any: + +image::processes_list.png[Participatory processes list] + +You can filter by the ones that are: + +* Published / Unpublished +* Public / Private + +image::processes_list_filter.png[Participatory processes list filtered] + +You can also search by title and control how many elements are in the list. + +You have 4 possible actions in this list after a Participatory Process is created: + +1. Export: send by email the configuration for a given process. Can be imported in other Decidim installation. +1. Duplicate: to duplicate this process. +1. Configure: to edit the metadata and configuration for a process. +1. Preview: how it will look once published. + +== New process form + +image::processes_new_form.png[New participatory process form] + + +.New participatory process form: General information +|=== +|Field |Type |Description + +|Title +|Required +|Title of the participatory process. For instance, "Participatory Budgeting 2020". + +|Subtitle +|Required +|Subtitle. For instance, "Let's decide our priorities together" + +|URL slug +|Required +|URL slugs are used to generate the URLs that point to this process. Only accepts letters, numbers and dashes, and must +start with a letter. Example: if your domain is 'example.org' and your slug 'participatory-budget-2020' then your URL will +be https://example.org/processes/participatory-budget-2020 + +|Hashtag +|Optional +|Hashtag for Twitter + +|Short description +|Required +|A short explanation of what's your participatory process about. + +|Description +|Required +|A long explanation of what's your participatory process about. + +|Announcement +|Optional +|The text you enter here will be shown to the user right below the process information. +|=== + + +.New participatory process form: Duration +|=== +|Field |Type |Description + +|Start date +|Optional +|When this process start. You have a calendar widget to choose the day. Expected format: dd/mm/yyyy + +|End date +|Optional +|When this process start. You have a calendar widget to choose the day. Expected format: dd/mm/yyyy +|=== + + +.New participatory process form: Images +|=== +|Field |Type |Description + +|Home image +|Optional +|Image that will be used in presentation cards of this process. Guidance for file: Has to be an image or a document. +For images, use preferably landscape images, the service crops the image. Maximum file size: 10MB + +|Banner image +|Optional +|Image that will be used inside of the process. Guidance for file: Has to be an image or a document. +For images, use preferably landscape images, the service crops the image. Maximum file size: 10MB +|=== + + +.New participatory process form: Metadata +|=== +|Field |Type |Description + +|Promoter group +|Optional +|Information that's displayed in the process metadata sidebar. + +|Organization area +|Optional +|Information that's displayed in the process metadata sidebar. + +|Scope metadata +|Optional +|Information that's displayed in the process metadata sidebar. + +|Who participates +|Optional +|Information that's displayed in the process metadata sidebar. + +|What is decided +|Optional +|Information that's displayed in the process metadata sidebar. + +|How is it decided +|Optional +|Information that's displayed in the process metadata sidebar. +|=== + +image::process_frontend_metadata.png[Process frontend metadata] + +image::process_backend_metadata.png[Process backend metadata] + + +.New participatory process form: Filters +|=== +|Field |Type |Description + +|Scopes enabled +|Optional +|Check if you want to have Scopes filtering in this process. + +|Scope +|Optional +|Which xref:admin:scopes.adoc[Scope] does this process belongs to. + +|Scope filter depth +|Optional +|Restrict the scope filter depth; The filter will show from general to the selected scope type. This is only relevant if +you have complex relations in Scopes children (like a Russian Doll). For instance if you have a Grandmother -> Mother -> +Child, this setting allows you to choose the Mother, so the participants can only choose the Child. This would be the +case for instance if you have Provinces -> Cities -> Districts, and the process is about a particular City. + +|Area +|Optional +|Which xref:admin:areas.adoc[Area] does this process belongs to. +|=== + + +.New participatory process form: Visibility +|=== +|Field |Type |Description + +|Processes group +|Optional +|Enables to make groups of multiple participatory processes. Ideally for processes that are related between them, for +instance multiple squares in a City or multiple documents using the same participatory rules. + +|Private space +|Optional +|Check if this process should only be accessible by xref:admin:spaces/processes/private_participants.adoc[Private Participants] + +|Promoted +|Optional +|Check if you want the process to have more visibility in the Process public list. It'll also be visible in the +Participatory Process Content Block in the xref:admin:homepage.adoc[Homepage] configuration. This is accessible in the +btn:[Edit] action in a Process. +|=== + + +.New participatory process form: Filters +|=== +|Field |Type |Description + +|Related processes +|Optional +|Select other participatory processes that are related to this one. +|=== + + +.New participatory process form: Filters +|=== +|Field |Type |Description + +|Show statistics +|Optional +|Check if you want to show the Statistics section. + +|Show metrics +|Optional +|Check if you want to show the Metrics section. +|=== + +After you've initially created your process you have a submenu where you need to keep configuring more information +about your participatory process. + +image::process_submenu.png[Process submenu in admin] + +Here you can keep configuring your process: + +. Info: the same form that we explained in this page. +. xref:admin:spaces/processes/phases.adoc[Phases] +. xref:admin:spaces/processes/components.adoc[Components] +. xref:admin:spaces/processes/categories.adoc[Categories] +. xref:admin:spaces/processes/attachments.adoc[Attachments] +. xref:admin:spaces/processes/admins.adoc[Process admins] +. xref:admin:spaces/processes/private_participants.adoc[Private participants] +. xref:admin:spaces/processes/moderations.adoc[Moderations] \ No newline at end of file From 85b8e099d47420fc470009f8d88feeb976535ae0 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:26 +0200 Subject: [PATCH 092/336] New translations admins.adoc (French) --- docs/fr/modules/admin/pages/spaces/processes/admins.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/fr/modules/admin/pages/spaces/processes/admins.adoc diff --git a/docs/fr/modules/admin/pages/spaces/processes/admins.adoc b/docs/fr/modules/admin/pages/spaces/processes/admins.adoc new file mode 100644 index 0000000000..59313271ef --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/processes/admins.adoc @@ -0,0 +1 @@ +include::partial$page_admins.adoc[] \ No newline at end of file From 737dde65637e69e915be9bf7d31c6593a4602efa Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:28 +0200 Subject: [PATCH 093/336] New translations attachments.adoc (French) --- docs/fr/modules/admin/pages/spaces/processes/attachments.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/fr/modules/admin/pages/spaces/processes/attachments.adoc diff --git a/docs/fr/modules/admin/pages/spaces/processes/attachments.adoc b/docs/fr/modules/admin/pages/spaces/processes/attachments.adoc new file mode 100644 index 0000000000..493f7dc8c8 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/processes/attachments.adoc @@ -0,0 +1 @@ +include::partial$page_attachments.adoc[] \ No newline at end of file From 06a4fe06892787f8bc6b4093414941384cf74171 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:28 +0200 Subject: [PATCH 094/336] New translations categories.adoc (French) --- docs/fr/modules/admin/pages/spaces/processes/categories.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/fr/modules/admin/pages/spaces/processes/categories.adoc diff --git a/docs/fr/modules/admin/pages/spaces/processes/categories.adoc b/docs/fr/modules/admin/pages/spaces/processes/categories.adoc new file mode 100644 index 0000000000..3ee4fc09cc --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/processes/categories.adoc @@ -0,0 +1 @@ +include::partial$page_categories.adoc[] \ No newline at end of file From 71f003b05cac62e306ff5fc4d471b6e23767894d Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:29 +0200 Subject: [PATCH 095/336] New translations components.adoc (French) --- docs/fr/modules/admin/pages/spaces/processes/components.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/fr/modules/admin/pages/spaces/processes/components.adoc diff --git a/docs/fr/modules/admin/pages/spaces/processes/components.adoc b/docs/fr/modules/admin/pages/spaces/processes/components.adoc new file mode 100644 index 0000000000..7a204dda0b --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/processes/components.adoc @@ -0,0 +1 @@ +include::partial$page_components.adoc[] \ No newline at end of file From 87452fe9cde324dd7974af9d9a374b36fb46ad60 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:31 +0200 Subject: [PATCH 096/336] New translations groups.adoc (French) --- .../admin/pages/spaces/processes/groups.adoc | 113 ++++++++++++++++++ 1 file changed, 113 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces/processes/groups.adoc diff --git a/docs/fr/modules/admin/pages/spaces/processes/groups.adoc b/docs/fr/modules/admin/pages/spaces/processes/groups.adoc new file mode 100644 index 0000000000..315bedeaa7 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/processes/groups.adoc @@ -0,0 +1,113 @@ += Process groups + +A group of processes proves useful for subdividing large participatory processes into subprocesses according to a criteria, +for instance the xref:admin:scopes.adoc[scope] of every process. + +As an example you can see the https://www.decidim.barcelona/processes_groups/4[Barcelona City Council's Neighborhoods Plan, Pla de Barris]. +This is is a 150 million euro shock plan that aims to reduce inequalities within the city. There are 10 related processes, one for each involved neighborhood. + +image::processes_group_example.png[Participatory process group example] + +== New process group form + +For creating a new process group: + +. Sign in as administrator +. Go to the Processes section in the sidebar +. Click on the Process groups link in the sidebar +. Click on the "New process group" button +. Fill in the form + +image::processes_group_list.png[Participatory process groups list] + +image::processes_group_new_form.png[New participatory process group form] + + +.New participatory process group form: General information +|=== +|Field |Type |Description + +|Title +|Required +|Title of the participatory process group. For instance, "Participatory Budgeting". + +|Description +|Required +|A long explanation of what's your participatory process about. + +|Related processes +|Optional +|Which are the processes that are related to this one? They will be used for populating +the Content Blocks in the Landing page of this Process group. For selecting multiple you'll +need to use the *ctrl* function. + +|Image +|Optional +|Image that will be used in presentation cards of this process group. Guidance for image: +Preferably a landscape image that does not have any text. The service crops the image. +Maximum file size: 10MB. Allowed file extensions: jpeg jpg png +|=== + + +.New participatory process group form: Metadata +|=== +|Field |Type |Description + +Hashtag +Website + +|Promoter group +|Optional +|Information that's displayed in the process metadata content block. + +|Organization area +|Optional +|Information that's displayed in the process metadata content block. + +|Scope metadata +|Optional +|Information that's displayed in the process metadata content block. + +|Who participates +|Optional +|Information that's displayed in the process metadata content block. + +|What is decided +|Optional +|Information that's displayed in the process metadata content block. + +|How is it decided +|Optional +|Information that's displayed in the process metadata content block. +|=== + + +.New participatory process group form: Visibility +|=== +|Field |Type |Description + +|Promoted +|Optional +|Check if you want the process to have more visibility in the Process public list. It'll also be visible in the +ParticpipatoryProcess Content Block in the xref:admin:homepage.adoc[Homepage] configuration. This is accessible in the btn:[Edit] action in a Process. +|=== + +== Landing page + +One of the main features of a process group is to be able to configure the Lnading page, through Content blocks, just like +the general homepage of the platform. This means that you can enable or disable different sections of the landing page and also +configure some fo these sections. + +image::processes_group_landing.png[Participatory process group landing page] + +* Title, description and hashtag +* Metadata +* Image, text and Call to Action button. Configurable. +* Proposals. You can configure how the elements will be sorted: by most recent or random. +* Results. You can configure how the elements will be sorted: by most recent or random. +* Upcoming events +* Statistics +* Participatory processes +* First HTML block +* Second HTML block +* Third HTML block \ No newline at end of file From 6a845e7a62ab6bb8a4fd9bdc6dd1d7945f99d16b Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:32 +0200 Subject: [PATCH 097/336] New translations moderations.adoc (French) --- docs/fr/modules/admin/pages/spaces/processes/moderations.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/fr/modules/admin/pages/spaces/processes/moderations.adoc diff --git a/docs/fr/modules/admin/pages/spaces/processes/moderations.adoc b/docs/fr/modules/admin/pages/spaces/processes/moderations.adoc new file mode 100644 index 0000000000..12d6ac0858 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/processes/moderations.adoc @@ -0,0 +1 @@ +include::partial$page_moderations.adoc[] \ No newline at end of file From 3e5b8cc67bfb163368dd9d0106b3002f9b6ff123 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:34 +0200 Subject: [PATCH 098/336] New translations phases.adoc (French) --- .../admin/pages/spaces/processes/phases.adoc | 89 +++++++++++++++++++ 1 file changed, 89 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces/processes/phases.adoc diff --git a/docs/fr/modules/admin/pages/spaces/processes/phases.adoc b/docs/fr/modules/admin/pages/spaces/processes/phases.adoc new file mode 100644 index 0000000000..c9c58c5173 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/processes/phases.adoc @@ -0,0 +1,89 @@ += Phases + +A participatory process is a sequence of phases ordered in time. Depending on which phase of the process timeline you +are, then you can enable or disable some features. + +Ideally, the Phases of a Participatory Process are always the same and are not changed, so participants can know what are +the rules and timeframe and can organize their lives to know when it'd be best for them to participate in this process. + +As a guideline, the standard structure of a participatory process may be as follows: + +. Presentation +. Diagnosis +. Proposal creation and debate +. Proposals prioritization +. Proposals evaluation +. Monitoring + +Participants can find the link to different phases of a participatory process in the header of the participatory process, +in the link "Process phases". Here they can see the full description and explanation of the phases. The active phase +will be highlighted. + +image:process_phases_header.png[Header with processes phases link] + +image:process_phases.png[Process phases explanation] + +== Create a new phase + +image:process_phases_list.png[Phases of a participatory process] + +For creating a new phase of a participatory process: + +. Sign in as administrator +. Go to the participatory process section in the sidebar +. Click on the participatory process Edit action +. Click on the Phases link in the sidebar +. Click on the "New phase" button + +image:process_phases_new_form.png[Create a new participatory process phase form] + + +.Create meeting +|=== +|Field |Type |Description + +|Title +|Required +|What is the title for this phase. + +|Description +| +|A long description explaining what's this phase for. + +|Start date +| +|Which day this phase will start. Expected format: dd/mm/yyyy + +|End date +| +|Which day this phase will end. Expected format: dd/mm/yyyy + +|Call to Action path +| +|Where will the button link to. For instance, it could point to the new proposal creation form. Use partial paths, not full +URLs here. Accepts letters, numbers, dashes, and, slashes, and must start with a letter. If not set, the button will not be shown. + +|Call to Action text +| +|What will the button say. For instance, it could be "Create a proposal". If not set, the button will not be shown. +|=== + +== Actions + +After a phase was created you have these actions: + +|=== +|Icon |Name |Definition + +|image:action_activate.png[Activate icon] +|Activate +|To make this phase the active one. + +|image:action_edit.png[Edit icon] +|Edit +|To edit this phase. + +|image:action_delete.png[Delete icon] +|Delete +|To delete this phase. +|=== \ No newline at end of file From fc05aed27673f863f9c142e98842e1f72e0efcd9 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:35 +0200 Subject: [PATCH 099/336] New translations private_participants.adoc (French) --- .../admin/pages/spaces/processes/private_participants.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/fr/modules/admin/pages/spaces/processes/private_participants.adoc diff --git a/docs/fr/modules/admin/pages/spaces/processes/private_participants.adoc b/docs/fr/modules/admin/pages/spaces/processes/private_participants.adoc new file mode 100644 index 0000000000..16c939dfa3 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/processes/private_participants.adoc @@ -0,0 +1 @@ +include::partial$page_private_participants.adoc[] \ No newline at end of file From 462a194a59327fdd80e7db211110e26c76beb0c7 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:36 +0200 Subject: [PATCH 100/336] New translations votings.adoc (French) --- docs/fr/modules/admin/pages/spaces/votings.adoc | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 docs/fr/modules/admin/pages/spaces/votings.adoc diff --git a/docs/fr/modules/admin/pages/spaces/votings.adoc b/docs/fr/modules/admin/pages/spaces/votings.adoc new file mode 100644 index 0000000000..4ee78af415 --- /dev/null +++ b/docs/fr/modules/admin/pages/spaces/votings.adoc @@ -0,0 +1,3 @@ += Votings + +include::admin:partial$development.adoc[] \ No newline at end of file From 4bba981af07ef79e8c06e9c4c9044f14b59f4fe9 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:38 +0200 Subject: [PATCH 101/336] New translations system.adoc (French) --- docs/fr/modules/admin/pages/system.adoc | 124 ++++++++++++++++++++++++ 1 file changed, 124 insertions(+) create mode 100644 docs/fr/modules/admin/pages/system.adoc diff --git a/docs/fr/modules/admin/pages/system.adoc b/docs/fr/modules/admin/pages/system.adoc new file mode 100644 index 0000000000..b52b8da96d --- /dev/null +++ b/docs/fr/modules/admin/pages/system.adoc @@ -0,0 +1,124 @@ += System + +Every Decidim is multi-tenant by default. That means that you can have multiple organizations inside of your same installation. This is being used for instance for the Barcelona and Girona Provincials Governments, for offering Decidim installations to many small cities, or by the City of Barcelona, for giving service to lots of organizations (NGOs, cooperatives, etc). + +Even if you only have one Organization you also need to create one through the System Panel. It's available after you've installed Decidim, at `/system`. For instance if you domain is `example.org`, then it should be available at `http://example.org/system`. + +After you've freshly installed Decidim, you'll be redirected to the System panel log-in page: + +image::system-log_in.png[system panel log in] + +== 1. Create an admin account + +For accessing in this dashboard, you'll need to create a system admin account with the Rails console, as the instructions that you have in your `README.md` file: + +Open a console: + +[source, console] +.... +bin/rails console +.... + +Then create the systems' admin: + +[source, ruby] +.... +user = Decidim::System::Admin.new(email: , password: , password_confirmation: ) +user.save! +.... + +So for example, if your email is `system@decidim.org` and your password `decidim123456` that'd be: + +[source, ruby] +.... +user = Decidim::System::Admin.new(email: 'system@decidim.org', password: 'decidim123456', password_confirmation: 'decidim123456') +user.save! +.... + +IMPORTANT: Please don't use this password, is really insecure! + +== 2. Access the Dashboard + +After you've logged in, you'll see an empty dashboard: + +image::system-dashboard.png[system empty dashboard] + +== 3. Create a new organization + +Inside of the system panel, you need to create your Organization through the form: + +TIP: Please mind that some of these fields can't change through the System Form, as changing them could potentially leave your database in a broken state. You can change it through the console, but you'll be on your own. + + +.System New Organization form +|=== +|Field |Type |Description + +|Name +|Required +|Name of your organization. For instance, "Decidim Barcelona". + +|Reference prefix +|Required +|The reference prefix is used to uniquely identify resources across all organizations. It's for identifying different resources inside of Decidim. For instance, "BCN". You can change how it's created this reference through xref:configure:initializer.adoc[Decidim's initializer] (see **Custom resource reference**). + +|Host +|Required +|Fully qualified domain name. For instance, "example.org" or "decidim.barcelona". + +|Secondary hosts +|Optional +|Others domains or subdomains that point to this same installation. Normally this shouldn't be used. Enter each one of them in a new line. For instance, "example.com" + +|Organization admin name +|Required +|Name of the admin account. For instance, "Admin" + +|Organization admin email +|Required +|Email for the admin account. For instance, "admin@example.org" + +|Organization locales +|Required +|You'll need to configure at least one language. Decidim is multilanguage, meaning that you can have most of the admin contents with any number of languages. For seeing other languages you'll need to configure first the xref:configure:initializer.adoc[Decidim's initializer]. + +|Force authentication +|Optional +|Check if you want to **Force users to authenticate before access organization**. That means that they don't see any published content and they only have access to the log-in form. + +|Users registration mode +|Optional +|Control how you want the login / participant register or signup to work. See below. + +|Available authorizations +|Optional +|How you want to authorize and verify that your participants are who they say they are. It depends a lot on your Organization, country, etc. See xref:customize:authorizations.adoc[Authorizations customization]. + +|SMTP settings +|Optional +|Allows you to configure different SMTP servers for every Organzation in this installation. See xref:services:smtp.adoc[SMTP configuration]. + +|Omniauth settings +|Optional +|Allows you to configure through external OAUTH providers for every Organization in this installation. See xref:services:social_providers.adoc[Social providers configuration]. +|=== + +=== Users registration mode + +==== 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 (and you can disable that confirmation also if you want to through xref:configure:initializer.adoc[Decidim's initializer]) + +==== Don't allow participants to register, but allow existing participants to login + +This is for when you make a manual import of participants' accounts. + +==== Access only can be done with external accounts + +In the case where you have an external provider configured (like the `Omniauth settings`) and you want to have accounts from only this provider. + +== [Optional] 4. Edit an organization + +Finally, you can also Edit an organization, although some fields can not be changed as some contents in the database depends on them. + +For accessing your newly created Organization, you can do it going to the domain or subdomain that you've configured in `Host`. \ No newline at end of file From 8c4a059926c24e17eab12f72a8ddbb1f5f272f25 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:40 +0200 Subject: [PATCH 102/336] New translations components_list.adoc (French) --- .../admin/partials/components_list.adoc | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 docs/fr/modules/admin/partials/components_list.adoc diff --git a/docs/fr/modules/admin/partials/components_list.adoc b/docs/fr/modules/admin/partials/components_list.adoc new file mode 100644 index 0000000000..3f51e2a0ba --- /dev/null +++ b/docs/fr/modules/admin/partials/components_list.adoc @@ -0,0 +1,18 @@ +The platform currently have the following official components: + +* Accountability: allows to keep track of the results execution of a space. +It allows administrators to also relate them to the proposals and meetings that originated them. +* xref:admin:components/blog.adoc[*Blog*]: allows administrators to publish posts with news regarding a space. +* xref:admin:components/budgets.adoc[*Budgets*]: allows participants to vote in projects with amounts predefined. Used for +participatory budgeting processes. Allows to define different kind of rules, for instance a minimum percentage of the total budget or a minimum amount of projects. +* xref:admin:components/debates.adoc[*Debates*]: allows participants to have debates. Debates can be time limited or not. +* xref:admin:components/elections.adoc[*Elections*]: to have end-to-end auditable elections in a space. Uses the same +external system as xref:admin:spaces/votings.adoc[Votings] space. +* xref:admin:components/meetings.adoc[*Meetings*]: gatherings in person or online through videoconferences platforms. +* xref:admin:components/pages.adoc[*Page*]: static pages with multi-language support. +* xref:admin:components/proposals.adoc[*Proposals*]: contributions posted by participants which can be given support. +* Sortitions: this allows different kind of proposals to be selected randomly. +For instance the proposals could be candidates who form part of a group (such as a committee). +* xref:admin:components/surveys.adoc[*Survey*]: for conducting surveys with different kinds of questions. + +In the cases where your needs are not covered by one of the above components, you can create your own component through a xref:develop:modules.adoc[Module]. \ No newline at end of file From be97ebd18a41e42bcaaa6d7f164341ada03129ea Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:41 +0200 Subject: [PATCH 103/336] New translations deprecated.adoc (French) --- docs/fr/modules/admin/partials/deprecated.adoc | 4 ++++ 1 file changed, 4 insertions(+) create mode 100644 docs/fr/modules/admin/partials/deprecated.adoc diff --git a/docs/fr/modules/admin/partials/deprecated.adoc b/docs/fr/modules/admin/partials/deprecated.adoc new file mode 100644 index 0000000000..ceaa4f0f37 --- /dev/null +++ b/docs/fr/modules/admin/partials/deprecated.adoc @@ -0,0 +1,4 @@ +[CAUTION] +==== +This feature is deprecated and will be removed in the future. If you really depend in this feature and can't find an alternative way of working with this, please put in touch with us at hola [at] decidim [dot] +==== \ No newline at end of file From 8a3f000a6e10be14c516080b16731abc54702e4b Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:42 +0200 Subject: [PATCH 104/336] New translations development.adoc (French) --- docs/fr/modules/admin/partials/development.adoc | 4 ++++ 1 file changed, 4 insertions(+) create mode 100644 docs/fr/modules/admin/partials/development.adoc diff --git a/docs/fr/modules/admin/partials/development.adoc b/docs/fr/modules/admin/partials/development.adoc new file mode 100644 index 0000000000..1309f6aa16 --- /dev/null +++ b/docs/fr/modules/admin/partials/development.adoc @@ -0,0 +1,4 @@ +[CAUTION] +==== +This feature is in active development. It is not ready for production use. +==== \ No newline at end of file From e38940d89632f3d1888fd0f70d21a620eeebd1ea Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:43 +0200 Subject: [PATCH 105/336] New translations legacy.adoc (French) --- docs/fr/modules/admin/partials/legacy.adoc | 4 ++++ 1 file changed, 4 insertions(+) create mode 100644 docs/fr/modules/admin/partials/legacy.adoc diff --git a/docs/fr/modules/admin/partials/legacy.adoc b/docs/fr/modules/admin/partials/legacy.adoc new file mode 100644 index 0000000000..22c10a6058 --- /dev/null +++ b/docs/fr/modules/admin/partials/legacy.adoc @@ -0,0 +1,4 @@ +[CAUTION] +==== +This section hasn't been updated. It shows the content of an old version of Decidim. You can collaborate to improving the Documentation, please put in touch with us at hola [at] decidim [dot] org +==== \ No newline at end of file From 3ed69cd9503a690dd2329e0f8059cdf56c456ff4 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:44 +0200 Subject: [PATCH 106/336] New translations page_admins.adoc (French) --- .../modules/admin/partials/page_admins.adoc | 67 +++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 docs/fr/modules/admin/partials/page_admins.adoc diff --git a/docs/fr/modules/admin/partials/page_admins.adoc b/docs/fr/modules/admin/partials/page_admins.adoc new file mode 100644 index 0000000000..e4527970ba --- /dev/null +++ b/docs/fr/modules/admin/partials/page_admins.adoc @@ -0,0 +1,67 @@ += Space Admins + +You can give permissions to users with special rights in a space, +so they can only have access to some of the administration pages in this space. +These roles are administrators, moderators, collaborators, or valuators. + +* Administrators: they can administer the space and change the space settings. +* Collaborators: they can see the space and its components before it's published and view the space settings. +They can't change anything. +* Moderators: they can see the reported contents of the space and hide or unhide them. +* Valuators: they can evaluate proposals. Used by participatory budgeting processes. + +To invite them, in the space's submenu, go to *Space admins* and click on *New space admin*. This depends in the kind of space +that you're, for instance for participatory processes it'd be *Process admins* and *New process admin*. + +== New space admin form + +image:spaces/admins_form.png[New space admin form] + + +.New space admin form +|=== +|Field |Type |Description + +|Name +|Required +|What is the name of the new admin. + +|Email +|Required +|What is the email of the new admin, so she can receive the invitation. + +|Role +|Required +|Which role does this admin will have in the participatory process? Can be any of Administrator, Collaborator, Moderator, or Valuator. +|=== + +== Roles + +=== Administrators + +A space administrator can administer the space and change the space settings. It can also invite new space administrators. + +image:spaces/admins_role_admin01.png[Process administrators view 01] + +image:spaces/admins_role_admin02.png[Process administrators view 02] + +=== Collaborators + +A space collaborator can only see the space before it's published. + +image:spaces/admins_role_collaborator.png[Process collaborators view] + +=== Moderators + +A space moderator can review the reported contents of the space and hide or unhide them. + +image:spaces/admins_role_moderator.png[Process moderators view] + +=== Process valuators + +A space valuator can review the proposals of the space. She can: + +* change the status of the proposals, by accepting or rejecting them +* add a monetary value to the proposals, so they can be voted with the budget component. + +image:spaces/admins_role_valuator.png[Process valuators view] \ No newline at end of file From 507527f847e0b73972d9773892448e3cde96bd1e Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:45 +0200 Subject: [PATCH 107/336] New translations page_attachments.adoc (French) --- .../admin/partials/page_attachments.adoc | 77 +++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 docs/fr/modules/admin/partials/page_attachments.adoc diff --git a/docs/fr/modules/admin/partials/page_attachments.adoc b/docs/fr/modules/admin/partials/page_attachments.adoc new file mode 100644 index 0000000000..0b7fab6042 --- /dev/null +++ b/docs/fr/modules/admin/partials/page_attachments.adoc @@ -0,0 +1,77 @@ += Attachments + +Attachments allow an administrator to upload static files to a space. + +When a space is launched, it is important to provide citizens with as much information as possible about them so that they can participate with knowledge. That is why it is helpful to add files (Attachments) with the information that is considered relevant. + +Optionally, these documents can be grouped in *Folders*. For example, for a participatory process of remodeling a square, folders could be created with information about possible uses, with plans, with economic information, etc. + +They can be found on the Space homepage: + +image:spaces/attachments_folder.png[View the folder attachments in the public interface] + +image:spaces/attachments.png[View the attachments in the public interface] + +== Create a new attachment + +image:spaces/attachments_admin.png[View the attachments in the admin interface] + +For creating a new attachment of a space: + +. Sign in as administrator +. Go to the space section in the sidebar +. Click on the space Edit action +. Click on the Attachments link in the sidebar +. Click on the "New attachment" button + +image:spaces/attachments_new_form.png[Create a new attachment form] + + +.Create attachment +|=== +|Field |Type |Description + +|Attachment or image name +|Required +|What is the title for this attachment. + +|Weight +|Optional +|Which order will it have in relation to the other attachments. Having a lower number means a higher priority. For instance, if you have two categories, "Attachment a" with weight "10" and "Attachment b" with weight "0", then "Attachment b" will be first when ordering. + +|Description +|Required +|A long description explaining what this file is about. + +|Folder +|Optional +|Which folder this attachment belongs to. + +|File +|Required +|Upload the file. Guidance for file: Has to be an image or a document. For images, use preferrably landscape images, the +service crops the image. For CSV files, the separator between columns must be a comma (","). Maximum file size: 10MB. Allowed +file extensions depends in your server configuration. +|=== + +== Create a new folder + +image:spaces/attachments_new_folder_form.png[Create a new folder for attachments form] + + +.Create folder +|=== +|Field |Type |Description + +|Name +|Required +|Name of the folder + +|Weight +|Optional +|Which order will it have in relation to the other folders. Having a lower number means a higher priority. For instance, if you have two folders, "Folder a" with weight "10" and "Folder b" with weight "0", then "Folder b" will be first when ordering. + +|Description +|Required +|A long description explaining what this folder is about. +|=== \ No newline at end of file From bd2a3ca213eddcb5422b20b93d7db061a77ce81d Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:46 +0200 Subject: [PATCH 108/336] New translations page_categories.adoc (French) --- .../admin/partials/page_categories.adoc | 56 +++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 docs/fr/modules/admin/partials/page_categories.adoc diff --git a/docs/fr/modules/admin/partials/page_categories.adoc b/docs/fr/modules/admin/partials/page_categories.adoc new file mode 100644 index 0000000000..67571c88bd --- /dev/null +++ b/docs/fr/modules/admin/partials/page_categories.adoc @@ -0,0 +1,56 @@ += Categories + +Categories (and subcategories) are used for classifying resources inside of a space. + +An administrator can define them, can be assigned to when creating resources, and then participants can filter the +different resources by these categories. For instance, they can be set up in proposals, meetings and debates. + +As an example of this mechanism in action you can see it in https://meta.decidim.org/processes/roadmap/f/122/[Propose new functionalities for Decidim software] process: + +. Administrators have defined the categories in the process. +. Participants can create proposals that have one category. +. Participants can filter by these categories and navigate among all the proposals. + +image:spaces/categories_sidebar.png[Filter categories in proposals] + +image:spaces/categories_form.png[Select a category when creating a proposal] + +NOTE: Once a category is in use it cannot be removed, as there are resources that are using it. + +Decidim has other ways to classify resources, for instance xref:admin:scopes.adoc[Scopes] and Hashtags. +The main difference is that Categories can be defined in a given space, Scopes are global for all the platform, and Hashtags +are defined by the participants. + +Categories can be nested, meaning that a category can have subcategories. + +== Create a new category + +For configuring a new category, go to the space admin panel and click on the "Categories" tab. + +image:spaces/categories.png[View categories in a space admin page] + +Then click in "Add category" and fill the form. + +image:spaces/categories_new_form.png[Create a new category form] + + +.Create category +|=== +|Field |Type |Description + +|Name +|Required +|What is the name for this category. + +|Weight +|Optional +|Which order will it have in relation to the other categories. Having a lower number means a higher priority. For instance, if you have two categories, "Category a" with weight "10" and "Category b" with weight "0", then "Category b" will be first when ordering. + +|Description +|Required +|A long description explaining what this category is about. + +|Parent +|Optional +|What is the parent category. +|=== \ No newline at end of file From e23784f12f5db3007af1729ecbf3161791758cda Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:47 +0200 Subject: [PATCH 109/336] New translations page_components.adoc (French) --- .../admin/partials/page_components.adoc | 52 +++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 docs/fr/modules/admin/partials/page_components.adoc diff --git a/docs/fr/modules/admin/partials/page_components.adoc b/docs/fr/modules/admin/partials/page_components.adoc new file mode 100644 index 0000000000..5544cc7a1e --- /dev/null +++ b/docs/fr/modules/admin/partials/page_components.adoc @@ -0,0 +1,52 @@ += Components + +include::partial$components_list.adoc[] + +To configure components, click on *Components* from the space submenu. A list will appear showing the components +that have already been configured for the space. + +image::spaces/components.png[Components of space] + +To configure a new component, click on *Add component* from the upper right part of the screen and select the type of +component you wish to configure from the drop-down menu. + +image::spaces/components_new_dropdown.png[Add a component in a space] + +== Actions + +|=== +|Icon |Name |Definition + +|image:action_manage.png[Manage icon] +|Manage +|To manage all the resources inside of a component. For instance, all the Proposals of a Proposal component, the Meetings +in a Meeting component, etc. + +|image:action_publish.png[Publish icon] +|Publish +|To publish a component. This means that the component will be visible to the public. + +|image:action_unpublish.png[Unpublish icon] +|Unpublish +|To unpublish a component. This means that the component will be invisible to the public. + +|image:action_configure.png[Configure icon] +|Configure +|To configure a component with the specific rules. Depends in the component type. For instance, in the case of Meetings: +are comments enabled, participants can create meetings, etc. + +|image:action_permissions.png[Permissions icon] +|Permissions +|To configure which xref:customize:authorizations.adoc[Authorization] will be necessary to make certain actions in +this component. For instance, in the case of Proposals, which Verification will be necessary to create a new proposal or +to give supports. + +|image:action_share.png[Share icon] +|Share +|To share privately before publishing this component. Useful for reviewing with other people inside of your organization. + +|image:action_delete.png[Delete icon] +|Delete +|To delete this component. If there are contents most of the components will not let you delete them so it doesn't break +relations with other resources. In those cases it's recommended to just unpublish the component. +|=== \ No newline at end of file From a3b07ba625a04bd14d06cfd810d0420b5607eb39 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:49 +0200 Subject: [PATCH 110/336] New translations page_moderations.adoc (French) --- docs/fr/modules/admin/partials/page_moderations.adoc | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 docs/fr/modules/admin/partials/page_moderations.adoc diff --git a/docs/fr/modules/admin/partials/page_moderations.adoc b/docs/fr/modules/admin/partials/page_moderations.adoc new file mode 100644 index 0000000000..aeed3aac33 --- /dev/null +++ b/docs/fr/modules/admin/partials/page_moderations.adoc @@ -0,0 +1,9 @@ += Moderation + +Moderations inside of a space work like xref:global_moderations.adoc[Global moderations]. + +The main difference is that if you want so you can invite Moderators of this specific +space and they will only have access to the reports made for +contents of this space. + +Moderators are a kind of space admins. See it for instance for xref:spaces/processes/admins.adoc[participatory processes admins]. \ No newline at end of file From 4ca3b36458939653c51e43448be9f96a039c310b Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:50 +0200 Subject: [PATCH 111/336] New translations page_private_participants.adoc (French) --- .../partials/page_private_participants.adoc | 75 +++++++++++++++++++ 1 file changed, 75 insertions(+) create mode 100644 docs/fr/modules/admin/partials/page_private_participants.adoc diff --git a/docs/fr/modules/admin/partials/page_private_participants.adoc b/docs/fr/modules/admin/partials/page_private_participants.adoc new file mode 100644 index 0000000000..90580396be --- /dev/null +++ b/docs/fr/modules/admin/partials/page_private_participants.adoc @@ -0,0 +1,75 @@ += Private participants + +There are cases where you want to have a closed census of the participants in a space. For instance this could be a space +for a small group of people, or the members of a comission inside of a big organization. For these cases you can +use the private participants feature. + +image:spaces/private_participants.png[Private participants list] + +For inviting private participants of a space: + +. Sign in as administrator +. Go to the space's section in the sidebar +. Click on the space Edit action +. Click on the "Private participants" link in the sidebar +. Click on the "New participatory space private user" or "Import via CSV" buttons + +== New participatory space private user + +image:spaces/private_participants_new_form.png[New private participant form] + + +.New participatory space private user form +|=== +|Field |Type |Description + +|Name +|Required +|What is the name of the new participant. + +|Email +|Required +|What is the email of the new participant. +|=== + +== Import via CSV + +image:spaces/private_participants_csv_import.png[Import private participants via CSV] + +This form allows you to bulk import the participants of a space. + +It must have two columns with email in the first column of the file and the name in the last column of the file (email, name) +of the users that you want to add to the participatory space. Some tips: + +* The file should not have headers. That means that you do not have to add a column that says "email, name" +* You must avoid using invalid chars like `<>?%&^*#@()[]=+:;"{}\|` in user name. +* The separator between columns must be a comma (",") + +== Actions + +After the participants has been invited, you can resend or delete the invitation. + +image:spaces/private_participants_actions.png[Private participants actions] + +|=== +|Icon |Name |Definition + +|image:action_resend_invitation.png[Resend invitation] +|Resend invitation +|If the invitation wasn't accepted, send it again to the user + +|image:action_delete.png[Delete invitation] +|Delete invitation +|Revoke the invitation sent to the user +|=== + +== Invitation + +When a participant was invited she'll get an email with a link for accepting the invitation: + +image:spaces/private_participants_email_invite.png[Email invitation of a private participant] + +After clicking in this email, she'll have to fill a form for setting her password, accepting the Terms of Service and giving +her consent if she wants to receive newsletters. + +image:spaces/private_participants_user_registration_form.png[User registration form of a private participant] \ No newline at end of file From cfa34afc2e808c73766445ae9976dec9197227dd Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:50 +0200 Subject: [PATCH 112/336] New translations under-construction.adoc (French) --- docs/fr/modules/admin/partials/under-construction.adoc | 4 ++++ 1 file changed, 4 insertions(+) create mode 100644 docs/fr/modules/admin/partials/under-construction.adoc diff --git a/docs/fr/modules/admin/partials/under-construction.adoc b/docs/fr/modules/admin/partials/under-construction.adoc new file mode 100644 index 0000000000..8af7720c26 --- /dev/null +++ b/docs/fr/modules/admin/partials/under-construction.adoc @@ -0,0 +1,4 @@ +[NOTE] +==== +This section hasn't been written yet. You can collaborate to improving the Documentation, please put in touch with us at hola [at] decidim [dot] org +==== \ No newline at end of file From 3b139c1065dbdb91ed04a5af0cd1d1773f3eccf5 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:51 +0200 Subject: [PATCH 113/336] New translations documentation.adoc (French) --- .../contribute/pages/documentation.adoc | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 docs/fr/modules/contribute/pages/documentation.adoc diff --git a/docs/fr/modules/contribute/pages/documentation.adoc b/docs/fr/modules/contribute/pages/documentation.adoc new file mode 100644 index 0000000000..ba8b6938b5 --- /dev/null +++ b/docs/fr/modules/contribute/pages/documentation.adoc @@ -0,0 +1,19 @@ += Documentation + +To contribute to the documentation (for instance, this same page that you're reading), you can do it through two ways: editing on GitHub directly or editing locally. + +== Edit on GitHub + +This is the recomended way if you just want to make a quick fix (for instance, a typo or some clarification on a single page). For doing this you'll need to click in the "Edit this page" link in the top of every page. + +image::documentation-edit.png[Edit this page link] + +It'll open the page for editing in GitHub interface and after you've finished it'll guide you to make a Pull Request so maintainers can review your contribution. + +== Edit locally + +If you want to propose lots of changes in the documentation, or if you want to review your changes locally before sending them because you want to review things like formatting, you can install the environment for having the documentation site locally. + +Then you'll need to fork the repository, make a branch and propose your changes as a Pull Request so maintainers can review it. As you see this can be a hassle if you want to make small changes, so the prefered way would be to do it initially with the "Edit this page" link mehod. + +Read the full instructions on how to install this documentation website locally in the https://github.com/decidim/documentation/[Decidim Documentation GitHub repository]. \ No newline at end of file From 71194cc76b24812e187f76df77a3baae1b035dca Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:53 +0200 Subject: [PATCH 114/336] New translations governance.adoc (French) --- .../modules/contribute/pages/governance.adoc | 45 +++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 docs/fr/modules/contribute/pages/governance.adoc diff --git a/docs/fr/modules/contribute/pages/governance.adoc b/docs/fr/modules/contribute/pages/governance.adoc new file mode 100644 index 0000000000..c1617e40e9 --- /dev/null +++ b/docs/fr/modules/contribute/pages/governance.adoc @@ -0,0 +1,45 @@ += Governance + +== About the code + +For making new features, you can made a https://decidim.org/modules[new module] for your own application. If you want to publish it on the website, you can https://decidim.org/contact[send us an message]. + +If you want to add a new feature or a change on the codebase, the process is: + +. Suggest your change in https://meta.decidim.barcelona/processes/roadmap[Metadecidim] +. Wait until Product Team reviews and accept the feature, as it's important to be consistent with the rest of the software, comply with the Social Contract, etc. +. Then you can make the Pull Request. +. The PR will get reviewed by: +.. Product Team: will review the functionality +.. Mantainers: will review the code quality + +image::workflow-features.png[new feature workflow process] + +Some things that you need to take in account about this process: + +* If you make the PR without Product Team approval then you could get rejected (after investing lots of time on developing). +* Proposals can receive endorsements, although these are not decisive for a proposal to be included on the roadmap. The endorsements serve as indicators of the interest of the proposal or the need it covers. The comments to the proposals are also enabled, to collectively elaborate the initial idea and bring it to a productive result. +* Every Thursday the Product team reviews all new proposals that have been published the previous week +* If no funding is available it is included in the backlog of the corresponding component or module. + +== About the organization + +Decidim was initially created by the city of Barcelona, but quickly it evolved through the help of Localret and other entities and administrations from Catalonia, such as Diputació de Barcelona (Barcelona Provincial Government), and other catalan cities: Terrassa, Sabadell, Gavà, L'Hospitalet de Llobregat, Badalona and Sant Cugat. You can read more about the history in xref:understand:about.adoc[About]. + +Since our first version in 2017 we've detected that it's necessary for the sustainability of the project to not depend in a given institution such as the city of Barcelona, as that could be problematic for the future. Other open source projects made by public institutions that didn't have a strong community or a sustainability strategy get shut down or slowly die without funding. + +Making this kind of open source software from the public institutions and through public contracting law is really difficult and one other issue that we want to tackle with this new organization is about having resources for contracting in-house developers. + +With all this on mind, we started with the https://meta.decidim.org/processes/decidim-gov[Metadecidim Governance participatory process] starting in November 2017: + +**** +A process open to the entire Community regarding the decision-making and representative bodies that we must equip ourselves with in order to build an autonomous, transparent and democratic organisation for the Decidim Project. + +The objective is to define an organizational and representation system (internal organs and how they are chosen) that can be transformed into an autonomous entity or association from which the whole community participates and can manage the project at multiple levels + +The Decidim project needs a system of its own governance that allows it to enjoy sufficient autonomy to continue growing in a sustainable manner, which is why it has to be provided with decision-making and conflict resolution bodies. +**** + +As a result of this participatory process, on February 2019 the Decidim Free Software Association (_Associació de Software Lliure Decidim_ in catalan) was created. You can read more about the https://meta.decidim.org/assemblies/general-assembly-association[General Assembly of the Decidim Association]. + +On 2021, the Decidim Association https://decidim.org/blog/2021-02-09-the-government-of-catalonia-barcelona-city-council-and-the-free-software-association-decidim-sign-a-collaboration-agreement-to-promote-democratic-participation-with-free-and-open-technologies/[has signed a collaboration agreement with the Government of Catalonia and Barcelona City Council to promote the development of the platform]. \ No newline at end of file From d3f78fe3ae30044d08a76da4b59399f70ec996b1 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:54 +0200 Subject: [PATCH 115/336] New translations index.adoc (French) --- docs/fr/modules/contribute/pages/index.adoc | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 docs/fr/modules/contribute/pages/index.adoc diff --git a/docs/fr/modules/contribute/pages/index.adoc b/docs/fr/modules/contribute/pages/index.adoc new file mode 100644 index 0000000000..d16f3f107a --- /dev/null +++ b/docs/fr/modules/contribute/pages/index.adoc @@ -0,0 +1,9 @@ += Contribute + +You don't need to know how to code to contribute to Decidim, just having available time and attitude. + +Learn more about https://github.com/decidim/decidim/blob/develop/CONTRIBUTING.adoc[How to contribute to Decidim] in GitHub. + +* xref:contribute:governance.adoc[Governance] +* xref:contribute:translations.adoc[Translations] +* xref:contribute:documentation.adoc[Documentation] \ No newline at end of file From 36a09fcea4a3a8bd9c11a4946d993ce4bfe90187 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:56 +0200 Subject: [PATCH 116/336] New translations translations.adoc (French) --- .../contribute/pages/translations.adoc | 55 +++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 docs/fr/modules/contribute/pages/translations.adoc diff --git a/docs/fr/modules/contribute/pages/translations.adoc b/docs/fr/modules/contribute/pages/translations.adoc new file mode 100644 index 0000000000..a06acc9fb4 --- /dev/null +++ b/docs/fr/modules/contribute/pages/translations.adoc @@ -0,0 +1,55 @@ += Translations + +For translating Decidim we use a web platform called Crowdin, accesible in https://translate.decidim.org/ + +At the moment is translated in more than 18 languages: Catalan, Czech, Dutch, Finnish, French, German, Greek, Hungarian, +Italian, Japanese, Latvian, Norwegian, Polish, Portuguese, Romanian, Slovak, Spanish and Swedish. + +As Decidim is a living and in constant development process is necessary to maintain, improve and specially update the translations when there's a new release. For doing so: + +== Existing language + +You can ask for permission in the language of your choosing, for instance for Esperanto: + +image::translation-join-01.png[Join to Decidim Translations] + +image::translation-join-02.png[Message in Join Decidim Translations] + +== New language + +If your language isn't created yet, then we need to do it as it's necessary to make some adjustments. You need to contact us by the https://decidim.org/contact[contact form]. + +== How it works + +If you're curios, in the technical level we have a bot (the great decidim-bot) that periodically makes a PR to the relevant branches (last releases and develop). + +image::translation-bot.png[Decidim Bot in GitHub] + +If you want to try a new translation before it gets released, then you can do so by pointing to the xref:install:update.adoc#_from_git_repositories[relevant branch], for instance `chore/l10n/develop`. + +=== Checking locales + +You can make sure new translations are complete for all languages in your application with: + +[source,console] +---- +bin/rails decidim:check_locales +---- + +By default this will check against develop branch. If you're pointing to other branch in your Gemfile, then you can use the TARGET_BRANCH environment variable: + +[source,console] +---- +TARGET_BRANCH=release/0.22-stable bin/rails decidim:check_locales +---- + +Be aware that this task might not be able to detect everything, so make sure you also manually check your application before upgrading. + +If you have 100% in your Crowdin language then you can be pretty sure that everything is translated. + +== Rules + +* All the translations always start from English. If you want to propose changes to the English language then you need to do it in the Ruby on Rails translations files directly (like `decidim-core/config/locales/en.yml`) +* For every language (except English), you can't do changes in the Ruby on Rails translations files directly (for instance `decidim-core/config/locales/es.yml`) as these translations could get invalidated by decidim-bot in the future. See "How it works" section. +* We try to speak of Participants instead of Users when it's possible +* On Spanish and Catalan we follow https://en.wikipedia.org/wiki/Gender_neutrality_in_Spanish[Gender Neutrality] \ No newline at end of file From fe41e7e266df2aaeeb4503f5bfa4fb2c1fbc3a3c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:57 +0200 Subject: [PATCH 117/336] New translations components.adoc (French) --- .../fr/modules/features/pages/components.adoc | 183 ++++++++++++++++++ 1 file changed, 183 insertions(+) create mode 100644 docs/fr/modules/features/pages/components.adoc diff --git a/docs/fr/modules/features/pages/components.adoc b/docs/fr/modules/features/pages/components.adoc new file mode 100644 index 0000000000..2e847c7acf --- /dev/null +++ b/docs/fr/modules/features/pages/components.adoc @@ -0,0 +1,183 @@ += Components + +:page-partial: + +*Components* are participatory mechanisms that allow interactions among the platform Participants within each of the Participatory Spaces. + +== Proposals + +*Proposals* are Decidim's most important component. They can be defined as the minimum decision unit. + +Proposals can be made by any of the following *types of creators*: + +* by the *official organisation* managing the platform +* by registered *individual participants* +* by a *group* of registered participants +* from a *meeting* as a result of a discussion or collective deliberation + +Once a proposal has been published, it can be *moderated*, *amended* or *withdrawn* by its author(s). + +Proposals can be *accepted*, *rejected* or kept in an *evaluating* state. Proposals can also be imported to a new phase, so they can be re-written or elaborated in different stages. + +Other features associated with proposals include: + +* *Proposal creation wizard*: While a proposal is being created, the participant is accompanied through the process, which is divided into different steps, with contextual help and previews before the proposal is published. +* *Modification and withdrawal of proposals*: a proposal’s author can modify and/or withdraw it before the support stage opens. +* *Version control*: this makes it possible to keep a record of all the changes made to a proposal, as well as code-generation to verify the proposal’s integrity. +* *Detecting similarities*: This allows anyone making a new proposal to find similar ones previously made on the platform, thereby avoiding duplications. +* *Connections between proposals*: proposals made can be connected to one another using links in the comments section, showing related proposals as cards and giving notifications on the existence of a new connection. +* *Endorsement of proposals*: participants and collectives can endorse proposals and such public endorsement will be shown within the proposal. Followers of the endorsers will be notified that the followed endorsed the proposal. +* *Amendments*: any participant can edit a proposal’s text and a sub-proposal will be created in Amendment Mode (as Pull Request in Github). This sub-proposal can gather endorsements and supports. Besides, the proposal’s author can accept or reject the amendment (or sub-proposal). Where a sub-proposal is rejected, its author can convert it into an official proposal. +* *Collaborative draft for proposals*: Decidim permits collaboration and co-creation over proposals. It incorporates the following features: +** Creating rough drafts with numerous authors. +** Listing of collaborative drafts +** Comments in drafts +** Asking for help from and accepting the help of other collaborators + +== Endorsements + +include::admin:partial$development.adoc[] + +Participants can endorse proposals. Such endorsements can be interpreted as votes, signatures or any other format that demonstrates a positive agreement in accordance with the political will itself. +Participants can issue a single endorsement for each proposal they wish. The number of endorsements can be limited for each participant. +There is no limit to the number of proposals that can be endorsed. + +If the endorsement is a vote, it is possible to configure from the administration panel the *display settings for the voting results*, either during or solely after the voting period. + +There is a *special form used to vote for participatory budgets* which allows participants to vote by "spending" an amount equivalent to the budget in question among the proposed projects. The number of votes is limited here by the selected projects’ accumulated spending amount. + +== Results + +The *results* component is used to turn proposals into results and give official responses to them. +It is possible to merge various proposals into a single result or to create different results related to the same original proposal. + +Results gather information about the original proposal(s), like the meetings where they were created, discussed and debated and the endorsements received. + +== Debates + +Discussions and debates can be opened on questions and specific issues established by administrators or participants. + +== Surveys + +The *surveys* component can be used to design and publish surveys and to display and download their results. + +* *Survey configuration tool*: allows administrators to create questions and answers (open, test types, multiple selection etc.) and launch the survey, as well as download the responses in CSV format. +* *Survey interface for participants*: allows participants to respond to survey questions. + +== Sortitions + +The *sortition* component allows to select a number of proposals (e.g. candidates for a jury) with random, yet reproducible, procedures that guarantees non-biased and uniform distributions. + +== Informative pages + +The *pages* component is used to create informative pages with rich text formatting, embedded pictures and videos. + +== Blogs + +The *blog* component makes possible the creation of posts or news associated with a participatory space, and to navigate them chronologically. + +*Comments associated* with blog entries will be treated like the platform’s other comments, as described below. + +== Newsletter + +The *newsletter* component makes possible to send emails to everyone registered in the platform or, more selectively, to those who participate in a specific space who have agreed, under the terms and conditions of use, to receive this information newsletter email. Personalised emails are sent out addressed directly to the name of the user in the language chosen by the user by default. + +Participants will automatically and directly be able to *unsubscribe* through the email itself by clicking on a link in it and it will also be possible to *track the number of visits* generated by the newsletter. + +== Meetings + +The *meeting* component offers organizations and participants the opportunity to: + +* convene meetings, defining its structure and content +* *categorise* the meeting within a space. +* create *proposals associated with meetings* +* *publish* minutes +* upload *photos* of the meeting + +Meetings relating to a participatory space (a specific process or an assembly) can be shown on a *map* and be *ordered by date or category*. Besides, all the meetings can be shown in *calendar mode*, with the possibility of exporting them to a mobile phone calendar or other apps. + +Some of the meeting component’s advanced features include: + +* *Registration and attendance system*: +** This allows to manage the *type of registration* (open and automatic, closed and accessible only to certain types of participants, etc.), to establish the **number of places **available for attendees, to reserve a place, to do *manual registrations*, sent out *Invitations*, to define the *conditions* that need to be accepted in order to be able to attend the meeting (e.g. image rights release), and *registering the attendance* of participants. +** It allows participants *to register* for a meeting, request *a family reconciliation service* (playroom, childcare space) and to obtain an *accreditation code* for attending at a meeting. +** Those registered who have attended a meeting will have *special access* enabling them to evaluate the meeting or make comments, etc. +** Participants or administrators will be able to receive *notifications* on registration-period openings, the number of places remaining for registrations, reminders of meetings, and the publication of minutes. +* *Managing agendas*: allows to define the duration of meetings, to create agenda’s items and sub-items, title, content, and estimated duration. Participants can propose agenda items. +* System for *drafting, publishing and validating meeting minutes* [IMPORTANT NOTE:This is currently implemented differently]: +** Minutes can be uploaded in video, audio or text format. +** Minutes in text mode are associated with a *collaborative writing board* integrated into Decidim. +** Minutes go through 4 *stages of preparation*: 1. Collaborative writing during the meeting; 2. Preparing the official draft of the minutes; 3. Draft-amendment stage; 4. Publication and final validation of the minutes. +** Minutes can be *commented on* using the comments component. +** *Accompanying documents* may also be added to the minutes. +* *Auto-convening*: verified participants will be able to convene meetings directly through the platform , with support from a certain number of other participants, the meeting will be publicly activated and convening participants will have access to the administration panel [IMPORTANT: not implemented yet] +* *Displaying and exporting meetings*: meetings can be displayed in map mode (for spaces or generally on the platform) or in calendar mode, and can be exported to agenda and calendar managers (in iCalendar format). + +== Search engine + +*The search engine* allows participants to perform searches across all of the platform’s indexable content, both generally and specifically, by searching within a specific participatory process or inside its components (proposals, results, etc.), through advanced searches. + +== Secondary components + +There are other components that only exist on top of basic components are. These components are: + +=== Comments + +The *comments* component enables participants to take part on a deliberative process on an issue or proposal. +Participants can respond to them, endorse them and receive notifications about responses. +Comments can be *ranked* in chronological order or by number of votes in favour. + +=== Participatory texts + +Participatory texts are defined as an ordered collection of proposals that make up a document with complete text. Participation in the text stems from interaction with the proposals that form it. This component basically allows three operations: + +* *Breaking down a text document into ordered proposals* from a document in ODT, XDOC, MarkDown and HTML formats. If the text is structured in sections and subsections, ordered proposals will be created from the lower level subsection; if the text is not structured, a proposal will be created for each paragraph of text. The interface allows proposals to be re-edited, merged, separated, given titles, etc. +* *Composition of proposals in a unified text*: based on a series of proposals, these may be ordered and generate a unified and downloadable text. +* *Viewing and interacting* with documents composed of proposals: A collection of proposals will be shown as a unified text and may be amended or comments can be added in the margin. + +=== Accountability + +The *accountability* component works like a project management system built into the platform. . It offers the possibility of: + +* subdividing results into projects or sub-projects +* defining and applying progress in implementation statuses (0% to 100% implemented) around their implementation +* displaying the extent of the results’ implementation grouped by categories and scopes + +Results, projects and statuses can be updated through a CVS, or manually by the administration interface. + +=== Conferences + +The *conference* component allows an organization to join up a series predefined meetings (chats, workshops etc.) related to a participatory space. + +Configuration settings include: + +* Conference-page generator, which enables the creation of an *internal website* with information about the event. +* The option to generate an *interactive and downloadable programme* on the event (where there are guest speakers, it will include their name, position, organisation, a small biography and links to other websites). +* Email *invitations*. +* Registration system +* *Automatic diploma and certificates of attendance creation* for those who request it, through a support panel that an administrator can verify. +* Links to the event *video and materials* platforms in the programme and documents. +* Automatic links to digital-media websites covering the event. +* The ability to following events through *social networks* (e.g. by incorporating a Twitter feed). + +== Participatory Spaces and Components + +*Participatory Spaces* and *Components* can be combined in different ways. +For example, the various phases of a Participatory Budgeting Process (Participatory Space) can combine *Components* like this: + +1. At an early phase public *Meetings* can be opened for citizens to analyze different needs classified by districts. +1. In turn these *Meetings* can lead to the design of a *Survey*. +1. The *Survey* results can then be used to define a set of categories for projects to be proposed. +1. The *Proposal* component can then be activated for Participants to create and publish their projects as solutions to the identified needs. +1. These *Proposals* can then be commented and, after two weeks of deliberation, *voting* can be activated to select among the projects with a budget-expenditure system. +1. Participants can then be called to a public *Meeting* to evaluate the results. +1. An assessment *Survey* can be launched afterwards for those who could not attend the *Meeting*. +1. Finally, the *Accountability* component may be activated to monitor the degree of execution of the selected projects, and people can comment on it. + +== Displaying components: Cards + +Component items have their individual page but are also displayed as *cards* throughout the platform. + +[#card-anatomy-fig] +._Decidim's proposal card anatomy._ +image::card-anatomy.png[] \ No newline at end of file From ddd1411657c5d00b97de13767cecd90653c363ef Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:58 +0200 Subject: [PATCH 118/336] New translations general-description.adoc (French) --- .../features/pages/general-description.adoc | 63 +++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 docs/fr/modules/features/pages/general-description.adoc diff --git a/docs/fr/modules/features/pages/general-description.adoc b/docs/fr/modules/features/pages/general-description.adoc new file mode 100644 index 0000000000..c54b27a835 --- /dev/null +++ b/docs/fr/modules/features/pages/general-description.adoc @@ -0,0 +1,63 @@ += General description and introduction to how Decidim works +:page-partial: + +http://decidim.org[Decidim], from the Catalan for "let's decide", is a digital infrastructure for participatory democracy, built entirely and collaboratively as free software. More specifically, Decidim is a web environment (a _framework_) produced in _Ruby on Rails_ that allows users to create and configure a website platform or portal, to be used in the form of a social network, for democratic participation. The portal allows any organization (local city council, association, university, NGO,trade union, neighborhood or cooperative) to create massive democratic processes for strategic planning, participatory budgeting, collaborative regulatory design, urban spaces design and elections. It also enables the organization of in-person meetings, signing up for them, the publication of minutes, proposing points for the agenda and receiving notifications of the results. Decidim can also help organizing governing bodies, councils or assemblies, the convening of consultations and referendums or channeling citizen or member initiatives to impact different decision making processes. All together Decidim makes possible to digitally structure a complete system of participatory democratic governance for any organization. + +To understand in detail how Decidim operates, a distinction must be made between participatory _spaces_ and _components_ (see <>). + +[#functional-architecture-fig] +._Summary diagram of Decidim's functional architecture showing a combination of components in participatory spaces. The "Vote*" component allows a variety of voting systems, expressions of support or allegiance for a proposal._ +image::functional-architecture-en.svg[width=2000] + +* *Participatory spaces.* These are the frameworks that define how participation will be carried out, the _channels_ or means through which citizens or members of an organization can process requests or coordinate proposals and make decisions. _Initiatives_, _Processes_, _Assemblies_ and _Consultations are all participatory spaces. Specific examples of each of these include: a citizen initiative for directly changing a regulation (_Initiative_); a general assembly or workers’ council (_Assembly_); a participatory budgeting, strategic planning, or electoral process (_Processes_); a referendum or a call to vote “Yes” or “No” to change the name of an organization (_Consultation_). +* *Participatory components.* These are the participatory _mechanisms_ that allow a series of operations and interactions between the platform users within each of the participatory spaces. The following are participatory components: _comments, proposals, amendments, votes, results, debates, surveys, sortitions, pages, blogs, newsletters_ and _meetings_. Other components that build on top of basic components are: _participatory texts_, _accountability_ and _conferences_. + +[#spaces-components-fig] +._Decidim displays participatory spaces on the top menu (dark) and components are displayed on the bottom menu (white)._ +image::spaces-components.png[] + +The ways in which spaces and components interact is the following. Users of the platform (participants) interact through participatory mechanisms known as components which afford a variety of features for the various participatory _spaces_. In other words, participatory _spaces_ such as _Initiatives_, _Assemblies_, _Processes_ and _Consultations_ have components at their disposal which work together as participatory mechanisms. The more notable components include in-person _meetings_, _surveys_, _proposals_, _debates_, _results_ and _comments_. So, for example, the various phases of a participatory budgeting process can combine components in the following way: at an early phase public meetings can be opened for citizens to analyze different needs classified by districts. In turn these meetings can lead to the design of a survey. The survey results can then be used to define a set of categories for projects to be proposed. The proposal component can then be activated for participants to create and publish their projects as solutions to the identified needs. These proposals can then be commented and, after two weeks of deliberation, voting can be activated to select among the projects with a budget-expenditure system. Participants can then be called to a public meeting to evaluate the results, and an assessment survey can be launched afterwards for those who could not attend the meeting. Finally, the accountability component may be activated to monitor the degree of execution of the selected projects, and people can comment on it. What makes Decidim particularly powerful is this combination of components within spaces, which provides an organization with a complete toolkit to easily design and deploy a democratic system and adapt it to the organization's needs. + +Decidim's top navigation bar displays the different types of active *spaces* of the platform. *Processes* is a space that allows to create, activate/deactivate, and manage various participatory processes. These are distinguished from other spaces by being structured in different phases within which all of the components can be incorporated. Examples of participatory processes are: an election process for members of a committee, participatory budgeting, a strategic planning process, the collaborative writing of a regulation or norm, the design of an urban space or the production of a public policy plan. *Assemblies* is a space that offers the possibility of setting decision-making bodies or groups (councils, working groups, committees, etc.) that meet up periodically, detailing their composition, listing and geolocating their meetings, and allowing to take part in them (for instance: attending if the seating capacity and nature of the assembly so permits, adding items to the agenda, or commenting on the proposals and decisions taken by that body). *Consultations* is a space that makes it possible to coordinate referendums, trigger discussions and debates, get voting results published; it can be connected to a secure e-voting system. *Initiatives* is a space that allows participants to collaboratively create initiatives, define their trajectory and goals, gather endorsements, discuss, debate and disseminate initiatives and define meeting points where signatures can be collected from attendees or debates opened to other members of the organization. Initiatives is a special kind of space by which members of the organization can trigger actions that are generally restricted to elected bodies or platform administrators, by collecting (digital) signatures. The organization can define the types of initiatives and set up the number of signatures that are required to trigger the expected result (e.g. to call for a consultation). + +The *components* (also called features) are displayed as a second level menu with white background within spaces (as displayed in <>). The *collaborative draft* for proposals facilitates the collaborative creation of proposals as well as the monitoring and control of changes throughout the process. The *proposals* component allows a user to create a proposal using a creation wizard, compare it with existing ones, publish it in the platform and include additional information like geolocation or attached documents and images. This component also makes possible to navigate, filter and interact with a set of proposals. The proposal component has plenty of configuration options, and different features can be activated or de-activated in time. One such feature is *voting* or *support*: it offers organizations the possibility of activating different voting or support systems around proposals: unlimited, limited to a given threshold, weighted, cost-based, etc. Proposals can also be imported to a new phase, so they can be re-written or elaborated in different stages, where they can also be subject to *amends* which can be voted separately, accepted and merged or rejected, to improve proposals democratically. The *results* component is used to turn proposals into results and give official responses concerning their acceptance or rejection, merging various proposals into a single result or creating different results related to the same original proposal. The *accountability* component offers the possibility of subdividing results into projects, defining and applying progress statuses around their implementation, as well as displaying the extent of the results’ implementation grouped by categories and scopes. In this sense the accountability component works like a project management system built into the platform. The *surveys* component can be used to design and publish surveys and to display and download their results. The *sortition* component allows to select a number of proposals (e.g. candidates for a jury) with random, yet reproducible, procedures that guarantees non-biased and uniform distributions. The *comments* component enables users to add comments, to identify the comment as being in favor, against or neutral in relation to the commented object, to vote comments, respond to them and to receive notifications about responses. The *participatory texts* component can be used to convert lengthy text documents into various proposals or results and, vice versa, to compose and display a unified text based on a collection of proposals or results. This makes possible to work with a full document as continuous text in participatory manner. The *pages* component is used to create informative pages with rich text formatting, embedded pictures and videos. The *blog* component makes possible the creation of posts or news, and to navigate them chronologically. The *meeting* component offers organizations and participants the opportunity to convene meetings, determine their location and time, registration and management of attendees, to define the structure and content of the meeting as well as publishing the minutes, and the resulting proposals. The *conference* component allows an organization to create a website for a big event by joining up a series predefined meetings (chats, workshops etc.), putting together a unified program and managing attendees. The *newsletter* component makes possible to send emails to everyone registered in the platform or, more selectively, to those who participate in a specific space. + +Participants can carry on different *types of actions* within the platform: + +[start=0] +. They can *navigate* and search for information +. They can *create* contents of different types (e.g. proposals and debates). +. They can *vote, support or sign* all three modes allow for participants to aggregate their preference or will for a specific consultation question, proposal or initiative respectively (the difference between these three types of actions involve different levels of security and anonymity: signatures can be audited and attributed to a participant, supports cannot, in order to prevent coercion, while votes involve higher cryptographic guarantees than supports). +. They can *comment* on any object of the platform (proposals, debates, results, sortitions, etc.). +. They can *endorse* any content, meaning that they can publicly declare they support it or find it relevant, with the participants following it then receiving notifications. +. They can *follow* other participants, a participatory process, an initiative, a specific proposal, etc. and receive notifications. +. They can *sign up* for a meeting. +. They can also *share* and *embed* content out of the platform, sharing the link to other social networks and embedding content on other sites. + +Component items (e.g. a proposal, a blog post, a meeting) have their individual page but are also displayed as *cards* throughout the platform, cards being a major design interface to interact with components. <> displays a proposal card with the different types of data and interactions identified within the card. + +[#card-anatomy-fig] +._Decidim's proposal card anatomy._ +image::card-anatomy.png[] + +The users who participate in Decidim can be grouped into three different categories: + +* *Visitors* have access to all of the platform's content without having to sign up or provide any information. +* *Registered* participants can create content and comments, sign-up for meetings, endorse content, follow other participants and objects of the platform, customize their profile and receive notifications, mentions and private messages. By choosing a username and password, accepting the user agreement, and providing an email account (or using an account for several social networks) participants become registered. Registered participants can also have their account officialized (meaning their username is accompanied by a special symbol indicating they really are who they claim they are on their profile). +* *Verified* participants can make decisions. In order to fall under this category they must first be verified as members of the organization, citizens of the municipality, or constituents of the decision-making group (an association, community, collective etc.). Decidim offers different ways to carry out this verification. Once verified, participants will be able to take decisions by supporting proposals, signing initiatives and voting in consultations. + +Administrators can *manage permissions* for registered or verified users selectively. For example proposal creation can be activated for both registered and verified users but supports to proposals only for verified users. It is also possible (although rarely recommended) to consider all registered users as verified and to grant them decision making powers. + +There are different types of administrators: *administrators* of the whole platform or of specific spaces and components, they can also be *moderators* (with the exclusive power of moderating proposals, comments or debates) or *collaborators* that can read unpublished content, create notes and responses to proposals. + +Participants can register as an *individual* or as a *collective* (associations, working groups, etc. within the main organization). User *groups* might also be created so that individuals can be associated to a *group*. Decidim allows participants belonging to such a group to express or act individually or embodying the group identity: when an action is carried the platform prompts the participant to choose wether she wants to act as herself or as the group she belong to. + +Participants can not only navigate the content of Decidim through the top menu and move down the architectural hierarchy, from a space to its different components; they can also get information through the *search engine*, or via *notifications*. Participants can also talk to each other by internal messaging or *chat*. + +The participant's *profile* makes possible to read notifications, manage followers, and monitor different gamification and engagement badges. + +The *home page* of the platform is fully customizable: it can display different types of banners, call-to-action buttons, it can also display statistics and interactive visualizations, activity streams, and maps with the upcoming meetings. + +The content of the platform can be classified by different criteria. A participatory space and its contents (e.g. a participatory process or the proposals within) can be (independently) assigned a *scope*. Scopes are defined for the whole platform, and they can be thematic or territorial (for example, an assembly can be assigned to a specific theme or subject, like "ecology", and to a specific territory, like a district within a city). Content within a space-instance can be assigned to a *category* or sub-category (e.g. topics) that are specific for such a space-instance. For example, the categories "sport facilities", "parks" and "schools" can be created for a participatory budgeting process, and proposals will be assigned to these categories. *Hashtags* can also be freely created and introduced in the body text almost anywhere in the platform (proposals, debates, comments, process description, etc), both by participants and administrators, to classify content and make it searchable. + +Unlike other existing platforms, Decidim’s architecture is *modular*, *scalable*, easy to *configure*, and *integrated* with other tools or apps (data analysis, maps, SMS, mail, social networks, etc.). The platform has been designed in such a way that processes, assemblies and mechanisms can be set up easily and deployed from an administration panel. No knowledge of programming is required to install, configure and activate it. The participatory spaces and components can be developed, activated and deactivated independently. \ No newline at end of file From eb1604ccca1116f437a21b1bec6a85f35c297a21 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:55:59 +0200 Subject: [PATCH 119/336] New translations general-features.adoc (French) --- .../features/pages/general-features.adoc | 77 +++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 docs/fr/modules/features/pages/general-features.adoc diff --git a/docs/fr/modules/features/pages/general-features.adoc b/docs/fr/modules/features/pages/general-features.adoc new file mode 100644 index 0000000000..176164832f --- /dev/null +++ b/docs/fr/modules/features/pages/general-features.adoc @@ -0,0 +1,77 @@ += General features + +:page-partial: + +Below, we will outline a series of the platform’s general features and characteristics which do not appear in the spaces or components, or in the features directly associated with participants. + +== Installation and settings + +Decidim **can be easily installed **using the command prompt in any GNU/Linux server with the following installed services: PostgreSQL 9.4+, Ruby 2.4.1, NodeJS with yarn (JavaScript dependency manage), ImageMagick and PhantomJS. An automatic installation script allows you to deploy the whole dependency system, libraries, databases and other automatically required services in Heroku or Docker [feature expected for 2018Q4]. + +The portal’s *settings* are **customisable **in the following fields that are filled out on a form from the administration panel: Name of the portal, social network profiles (Twitter, Facebook, Instagram, YouTube, Github); brief description; welcome text; default language; home image; the organisation’s logo; favicon; reference prefix (unique identifier that will apply to the portal’s elements) and the organisation’s URL. + +== Integration with other services and compatibility/creation of additional services + +Decidim can be easily integrated with the following services that can be installed or configured with Decidim: + +* *OpenStreetMap*: to show events and proposals with geo-location +* *Piwik*: website traffic analysis +* *Pad*: collaborative real-time writing boards (technology to be determined) +* *Digital identity and signature*: integration with OAuth2 digital-identity management system, systems based on blockchain and recognised institutional digital identity and signature management systems. +* *Distributed filing system*: Disseminating or copying proposals or other elements from the platform in a distributed filing system (blockchain or IPFS type) [Missing feature]. +* *Microblogging*: integration/compatibility with a standardised and open microblogging protocol/service such as GNU Social or StatusNet type for participants’ activities (proposals, observations and messages) [Missing feature]. + +Decidim automatically generates the following services besides the ones that can be browsed on the website or accessed through an API: + +* *SMTP*: sending emails. +* *Calendar*: integration and compatibility with calendar-management systems and automatic creation and updating of events calendars, etc. + +== Multitenancy + +The multitenancy of the platform can be used on the basis of a single installation. In other words, a single instance of Decidim software allows to deploy as many portals (tenants) as you want under specific settings for each of the tenants. That way an organisation can create participatory portals for its sub-organisations or various organisations can share a server and reduce the maintenance costs of its portals. + +== Multi-language + +Decidim is a *multi-language* platform. Its available languages will be configured during its installation. Menus, administrative forms and, generally, the platform's fixed texts are available in several languages (Spanish, Catalan, Basque, Italian, French, Dutch and Finnish). A **collaborative translation **system in https://crowdin.com/project/decidim enables new languages to be incorporated into the platform. + +As for content, once the official languages of the instance have been set during the installation, all the content that is created from the administration panel has the option of being generated in these languages. The administration panel allows *content to be managed in several languages* through tabs. The content generated by users is displayed on the platform in a single language (the one chosen by the participant through the language selector in the upper part of the menus or automatically through its browser's language settings). + +== Statistics, open data and downloads + +Besides the application programming interface (API) which automatically provides access to public data, Decidim’s home page features a *general statistics table* with the following fields: number of participants, processes, proposals, results, meetings, observations and votes. + +Another *statistics table for each participatory process* shows the number of meetings, proposals, votes and results of a specific process. + +The administration panel lets you **export the proposals, results and observations **of a participatory process in CSV and JSON format and responses to surveys for processing and/or integration with other management systems. Participants can **download the results of a participatory process and the extent of its implementation **through a CSV file. + +Decidim also has a **data-display component **at its disposal on the platform’s general level and on a specific level (showing data from a specific Participatory Space) [Feature expected for 2018Q2-3, AjB-Lote2Mod4]. The following are included among the graphics that are displayed: + +* **Interactive graphics **in the form of a time line showing the development of the various components’ counters. +* *Heat map* of all the meetings, proposals or other content with geo-location tags. +* **Interactive diagrams **(bar or pie charts) with the results of a process (amounts of each of the participatory budget projects, filter by category and status of the proposals - whether selected or not, etc.) + +All of these displays are accompanied by an **option for downloading data **in CSV format [Feature expected for 2018Q2-3, AjB-Lote2Mod4]. + +== API, adaptable website design and mobile app + +Decidim has an application programming interface or API which is a series of independent service calls and data from Decidim's website interface. This allows third parties to develop services on the platform, automatically release data or develop new interfaces, or integrate other services with decidim. + +The API comes with *documentation* and a *formal participatory ontology* [Not completed] + +Decidim's website *design* is completely *adaptable* (_responsive_), using _mobile-first_ design philosophy (designed first for mobiles and later extended to desktop systems and tablets). + +Both the website's design and the API enable the development of mobile apps for Decidim, and a *Mobile App* is expected to be developed soon. + +== Content-classification systems + +As for content classification, the following to be distinguished and adjusted in Decidim: fields, categories and labels (or tags). + +*Scopes* are generic throughout the platform and divided up into *territorial* and **topic **types. Territorial areas, once defined, allow the spaces’ elements to be classified by territory (e.g. if a process or a body or an initiative affects a district or two, the entire city, a region or country, depending on the organisation). Topic areas are likewise defined for the entire platform and allow classification of the various elements of the participatory spaces. + +*Categories and subcategories* are used for classifying content within the various spaces and are defined for each of the levels of the spaces. So, for example, a participatory process may include several categories and subcategories (the process administrator defines them) whereas the process’ meetings, surveys, proposals and other components can be classed under these categories. + +In contrast to fields and categories, *labels* or tags are cross-cutting and freely defined by participants and can apply to any level or component. Labels can be created, embedded and defined in the administration panel. A label-suggestion system allows the people taking part to choose labels similar to the ones that are they are suggesting for labelling any of the platform's elements. Elements can be browsed by labels and the most popular labels displayed. + +== Contextual help system, usability and evaluation tests + +Decidim includes *editable contextual help* for guiding individual and administrative participants in using the platform. It also includes a **automatic evaluation surveys** to be conducted on participants for the purposes of identifying usability and participatory-procedure errors and improving the democratic quality experience of the software . \ No newline at end of file From a6d0d58a63588408329e4574be9793ac56fd942d Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:56:01 +0200 Subject: [PATCH 120/336] New translations participants.adoc (French) --- .../modules/features/pages/participants.adoc | 53 +++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 docs/fr/modules/features/pages/participants.adoc diff --git a/docs/fr/modules/features/pages/participants.adoc b/docs/fr/modules/features/pages/participants.adoc new file mode 100644 index 0000000000..305e9fafeb --- /dev/null +++ b/docs/fr/modules/features/pages/participants.adoc @@ -0,0 +1,53 @@ += Participants + +:page-partial: + +*Participants* of Decidim can be grouped into three different categories: + +* *Visitors* have access to all of the platform's content without having to sign up or provide any information. +* *Registered* participants can submit proposals and comments, sign-up for meetings, endorse content, follow other Participants and receive notifications, mentions and private messages. +Users may register *directly* on the platform or through gateways of other *social networks* (Facebook, Twitter or Google+). To register directly, users will need to associate a email account and a password to the user-account. + Registered participants can also have their account officialized (meaning their username is accompanied by a special symbol indicating they really are who they claim they are on their profile). +* *Verified* participants can make decisions. Decidim offers different ways to carry out this verification. + +Administrators can *manage permissions* for *Registered* users and *Verified* users selectively. For example, _proposal creation_ can be activated for both Registered and Verified users but _supports to proposals_ only for Verified users. + +== Public registration of administrative activity + +The manual verification of participants, as well as other administrative actions can create vulnerability or may enable the administrators to use the platform in an abusive manner. To avoid it, Decidim includes a *public register of administrative activities* so these actions can be publicly and transparently audited. + +== User profile and personal settings + +There is a **user-profile page **where participants can make **changes to their data **(such as email account, password etc.), upload and enable an *avatar* image, set notifications or delete their account. + +The user-profile page also allows participants to add *additional information* to include interests and skills, voluntarily and by selecting the level of visibility of that information. This allows personal notifications to be sent and participants can be matched with others for collaborations. + +== Monitoring and notifications + +Participants receive *automated notifications* regarding the content they have created: responses to comments and comments on their proposals, as well as the results of their proposals (whether accepted or rejected). + +Besides automated notifications, participants can decide to **follow any element** of the system (other proposals, results, processes, assemblies, initiatives, groups or users etc.), and receive notifications. + +== Communication among participants + +**Instant messages **can be sent to participants through the platform, who will receive an email notification. + +*Mentions* can also be added (in the comments section) to any registered user and a notification will be automatically sent. + +== User groups + +Participants can register with the platform as members of one or several organisations/collectives. Once the organisation and membership status have been verified, participants can carry out actions (make proposals or submit comments, etc.), with their user or with the organisation name. + +User groups can also manage user permissions and administration roles assigned to groups, as well as private debate spaces or share information among group users, for example, who attended an in-person meeting. [Feature currently missing] + +== Engagement + +Decidim has a series of features geared to _gamifying_ the platform, to *attract and keep a growing number of participants interested*, as well as to promote practices that boost democratic quality and collective intelligence in participation [the gamification system is expected for 2018Q2-3, AjB-Lote1]. + +The gamification system includes two modes, one centred on users and the other on proposals. + +* The **user-centred **mode incorporates a *points system* based on several criteria (degree of detail of its user profile, number of invitations to others on the platform, number of proposals made and commented on, number of comments, number of endorsements obtained, number of followers, etc.) + +The combination of these and other indicators is used for generating gamification routes for each user and defining threads such as: most participatory person in the district, leadership in discussions and debates, etc. + +* Gamification *centred on proposals/initiatives* allows promoters, signatories and followers to boost interaction with them by incorporating several *metrics* (number of times that the proposal is shared in social networks, degree of controversy (number of positive and negative comments), quality of deliberation (depth of observation tree), number of hits received, etc. \ No newline at end of file From c177590296e5f5d769faef449ded2d461a164fbc Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:56:02 +0200 Subject: [PATCH 121/336] New translations participatory-spaces.adoc (French) --- .../features/pages/participatory-spaces.adoc | 66 +++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 docs/fr/modules/features/pages/participatory-spaces.adoc diff --git a/docs/fr/modules/features/pages/participatory-spaces.adoc b/docs/fr/modules/features/pages/participatory-spaces.adoc new file mode 100644 index 0000000000..69a8dcab3e --- /dev/null +++ b/docs/fr/modules/features/pages/participatory-spaces.adoc @@ -0,0 +1,66 @@ += Participatory spaces + +:page-partial: + +Participatory spaces define the main participatory channels. They are displayed in the platform's main upper menu. + +The basic logic behind Decidim's structure is that *components work together in the participatory spaces*. There are different types of spaces (initiatives, processes, consultations and assemblies) and various instances within each type (a process for an election and another for participatory budgets, council body for neighbourhoods and another for workers, an initiative to call for a change in legislation and another for something to be included in a plenary meeting agenda, etc.). + +== Processes + +Participatory processes require a general *configuration* form with the following fields: Title or name of the process; short name for URL; hash tag (used as a reference for communications on social networks); short description; long description; home page image; banner image; date of start and finish; field; promoter group (responsible for the participatory process on a political level, may be the local authority or a group made up of the authority’s experts/politicians and associations and other organisations); who it is aimed at; goal of the participatory process and participatory structure. The participatory process allows *accompanying documents* to be added. + +Participatory processes are divided into *stages* (e.g. 1. Information and convening stage; 2. diagnostics stage; 3. proposals stage; 4. prioritisation stage; 5. decision stage; 6. evaluation stage and 7. results-monitoring stage). Each stage includes the following configuration fields: title, description, start date, end date. + +*Highlights of announcements or texts* may also be displayed in the processes, both on the home page and in the heading of each component (proposals, discussions and debates, etc.) Different messages can be configured depending on the particular stage of a process. + +A *participatory process configuration tool* enables the simple activation and deactivation of stages and their components. Decidim's process configuration tool is one of its most powerful features, enabling total flexibility in designing participatory processes according to the various realities and forms of citizen participation. + +The feature of **process groups **enables various processes to be grouped, such as by the Participatory Budgets of different districts or neighbourhoods. + +Participatory processes may have one of the following *process statuses*: 0) published or unpublished; 1) open (started); 2) closed (the participatory process has ended but its results are still under way; 3) finished (both the process and its results phase are complete) and 4) future (has not yet started). + +A process can be **highlighted** (which increases its visibility on the homepage). + +There is also the possibility to **copy participatory processes** from the administration panel. This feature enables process models to be designed and copied so that certain details can be configured within the new processes, avoiding the need to create them from scratch. + +== Assemblies + +Decidim allows the **creation and configuration** of participatory or government *assemblies* (government or participatory bodies; councils; work groups, etc.) defined as structured participant groups which, whether on an individual or representative level, meet up periodically, with the authority to make proposals and decisions. + +The *assemblies section* allows you to see a full list of all of the assemblies that are activated and configured from the administration panel. The basic *settings* require the following fields to be completed for each body: name; image; scope (global, territorial or sectoral); body’s function (purpose of action); type of body (government, executive, consultative / advisory, participatory, work group, commission etc.); creation date; created on the initiative of (City Council, citizens or others); duration (indefinite or fixed, in the latter case, finishing date); date of inclusion in Decidim; date of closure and reason; how it is organised (functions, powers etc.); composition; if it can be joined and how to do that; method of choosing members; type/ function of members within the body; composition of internal work groups as monitoring or advisory committees; characteristics of the body; the body's social networks (name of social network and link) and the body’s next meetings. + +* *Convening meetings*: enables to send automatic meeting invitations, collaboratively create agendas, and register attendance. For a complete list of features see the "meetings" component. +* *Assembly’s characteristics*: open, public, transparent and other characteristics regarding the level of participation that the assembly allows. +* *Composition:* This enables the composition of the body to be defined in greater detail, using the profiles of participants associated with the body as well as other characteristics. A display of the body’s structure is automatically generated based on the composition of participating members: +** *Types of members*: Chair, deputy chair, secretaries, others +** *Membership origin*: by draw; direct election; representation from another assembly; government representation etc. +** *Internal work groups*: for the creation of sub-assemblies. Work groups will be able to relate to the body they belong to +** *Characteristics*: Open/closed; transparent; with various access permits. +* *Display*: allows us to view internal data about each body as well as the associations between assemblies +** *Composition*: the structure of a body is shown in the form of a circle diagram +** *Organisation charts*: allow us to view the hierarchy or network of assemblies and their associations. +* *Map and calendar*: allow us to view the location of all the assemblies on a map and calendar +* *Involvement with other spaces and components* +** *Involvement with processes*: assemblies can be promoter groups, start a process or make proposals within a process. A body’s composition may be the result of a process (for electing posts) +** *Proposals and results*: a body can generate its own proposals or results. +*** It shows how the proposal was agreed on (by consensus, majority, number of votes etc.). +** *Meetings*: assemblies will have a list of associated meetings, but some features may jump from one meeting to another, such as citizen initiatives to include an item in an agenda. Likewise, it must be possible to view minutes separately from the meeting, as they are associated directly with the body . + +== Initiatives + +*Initiatives*. This participatory space allows citizens to make proposals and collect the *requisite number of signatures and/or endorsements* depending on type (the various types are set out in the municipal regulations), giving rise to the start of the administrative procedure for its processing and citizen monitoring. + +Initiatives operate as follows: + +* Any person or citizen association can make a citizen-initiative proposal. There are *several types of initiatives* with various numbers of endorsements/signatures required for their processing (these are all configurable). From the initiative-creation page, a description of each of the methods, the number of signatures required and examples (e.g. explanatory videos) can be viewed. +* To avoid duplicates, once an initiative has been created, the system will present suggestions for **similar initiatives** before continuing with the following step. Once similar proposals have been ruled out, the specific form will be shown for each type of initiative, along with the minimum number of endorsements required. The creator then has an URL at their disposal which can be used to invite others to join in and endorse the initiative. A map is also displayed showing the locations of meeting points to collect signatures should there be any. +* Once the the initiative has been created, the initiative will move to a **technical moderation and validation** stage, where the City Council’s staff can respond in various ways (by approving it, rejecting it or suggesting amendments). +* Initiatives can be monitored and **notifications received on updated** statuses, in addition to which their individual promoter or group can periodically send information newsletters to other uses of the platform who have opted to follow the initiative. +* On reaching the specified end date, an initiative can have two possible states: +** *Rejected*: where it fails to reach the minimum number of signatures, a message will be shown stating "does not meet the number of signatures required" and the initiative's creator will be notified. +** *Accepted*: where it has achieved a sufficient number of signatures or endorsements it will be accepted and the corresponding procedure will start. + +== Consultations + +Consultations (a voting procedure where all of the organisation’s participants are called to vote on specific questions), allows participants **to find out about current or prospective consultations**, *discuss and debate* the consultation’s subject area and *monitor* the results. It also provides a *gateway to an e-voting system* which is external to Decidim but integrated in the interface in order to manage and verify identities. \ No newline at end of file From 5499676744c58aeae18e5eddba1bcbb71e607a0c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:56:05 +0200 Subject: [PATCH 122/336] New translations catalan.adoc (French) --- docs/fr/modules/publications/pages/catalan.adoc | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 docs/fr/modules/publications/pages/catalan.adoc diff --git a/docs/fr/modules/publications/pages/catalan.adoc b/docs/fr/modules/publications/pages/catalan.adoc new file mode 100644 index 0000000000..129537fc69 --- /dev/null +++ b/docs/fr/modules/publications/pages/catalan.adoc @@ -0,0 +1,5 @@ += Catalan Publications + +== Media + +* Barandiaran, X. E., Monterde, A., & Pin, G. (2016). Decidim.barcelona: autonomía, participación y software libre - Software libre. In Xarxaip (Ed.), _Programari lliure i de codi obert-Societat lliure i govern obert._ (pp. 31–32). http://softwarelibre.xarxaip.cat/18.html \ No newline at end of file From e99438bcc7ea00cd246e2ede548250849b81c732 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:56:06 +0200 Subject: [PATCH 123/336] New translations english.adoc (French) --- .../modules/publications/pages/english.adoc | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 docs/fr/modules/publications/pages/english.adoc diff --git a/docs/fr/modules/publications/pages/english.adoc b/docs/fr/modules/publications/pages/english.adoc new file mode 100644 index 0000000000..15df7cacb3 --- /dev/null +++ b/docs/fr/modules/publications/pages/english.adoc @@ -0,0 +1,19 @@ += English Publications + +IMPORTANT: Barandiaran, X., Calleja-López, A. & Monterde, A. (2018). Decidim: political and technopolitical +networks for participatory democracy. __Decidim’s project white paper__. (You can http://ajbcn-meta-decidim.s3.amazonaws.com/uploads/decidim/attachment/file/2005/White_Paper.pdf[download an alpha version of the document here]) + +== Academic + +* Borge, R., Balcells, J. , Padró-Solanet, A. (2019) "A model for the analysis of online citizen deliberation: Barcelona case study", International Journal of Communication. 13, pp. 5671–5695. https://ijoc.org/index.php/ijoc/article/view/10805/2873 + +== Media + +* Preville, P. (2019, November 13) _How Barcelona is leading a new era of digital democracy_ https://medium.com/sidewalk-talk/how-barcelona-is-leading-a-new-era-of-digital-democracy-4a033a98cf32 +* Graham, T. (2018, May 18) - _Barcelona is leading the fightback against smart city surveillance_ https://www.wired.co.uk/article/barcelona-decidim-ada-colau-francesca-bria-decode +* Barandiaran, X. E., & iaran. (2018, April 24). _What is Decidim?_ https://xabier.barandiaran.net/2018/04/24/what-is-decidim/ + +pass:[
][.biblio-abstract-label]#Abstract.# Many people ask what is this project called “Decidim” to which I have devoted my last two year of work with complete dedication. I wanted to share a brief summary here. This text is the…pass:[
] +* Stark, K. (2017, May 9). _Barcelona’s Decidim Offers Open-Source Platform for Participatory Democracy Projects_. https://www.shareable.net/blog/barcelonas-decidim-offers-open-source-platform-for-participatory-democracy-projects + +pass:[
][.biblio-abstract-label]#Abstract.# The word Decidim translated from Catalan means we decide, and it’s the name of Barcelona’s digital infrastructure for participatory democracy. One part functional database and one part political statement, organizers say Decidim is key to a broad digital transformation that is taking place in Barcelona — its institutions, markets, and economy.pass:[
] +* _Decidim: Free Open-Source participatory democracy for cities and organizations | Hacker News_. (n.d.). Retrieved January 21, 2019, from https://news.ycombinator.com/item?id=18952328 +* Oikos Denktank. (n.d.). _(W)E-Democracy - speaker 5 (1) - E-democratic cities - Arnau Monterde and Xabier E. Barandiaran_. Retrieved August 30, 2017, from https://www.youtube.com/watch?v=qrQ8ij4Ekag \ No newline at end of file From 4818a5f43df438e8479d19d14b49f7292b76180c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:56:08 +0200 Subject: [PATCH 124/336] New translations french.adoc (French) --- docs/fr/modules/publications/pages/french.adoc | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 docs/fr/modules/publications/pages/french.adoc diff --git a/docs/fr/modules/publications/pages/french.adoc b/docs/fr/modules/publications/pages/french.adoc new file mode 100644 index 0000000000..6d095bf12a --- /dev/null +++ b/docs/fr/modules/publications/pages/french.adoc @@ -0,0 +1,8 @@ += French Publications + +== Media + +* Politics, O. S. (2018a, March 7). _Decidim, la plateforme de participation citoyenne d’envergure européenne_. https://medium.com/open-source-politics/decidim-la-plateforme-de-participation-citoyenne-denvergure-europ%C3%A9enne-9b3cb92681e5 + +pass:[
][.biblio-abstract-label]#Abstract.# Cet article est basé sur une série de conversations que nous avons eues avec Pablo Aragon, Xabier Barandiaran, Josep Jaume[1] et de…pass:[
] +* Politics, O. S. (2018b, March 7). _Le Contrat Social de Decidim, un texte fondateur_. https://medium.com/open-source-politics/le-contrat-social-de-decidim-un-texte-fondateur-7a8916213270 + +pass:[
][.biblio-abstract-label]#Abstract.# Nous reproduisons ici, pour la première fois en français, le « Contrat Social » de la plateforme Decidim, traduit du catalan en passant…pass:[
] \ No newline at end of file From 6e8dc11695b5ca0208f9a6f1b8af366f0ef76b30 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:56:09 +0200 Subject: [PATCH 125/336] New translations german.adoc (French) --- docs/fr/modules/publications/pages/german.adoc | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 docs/fr/modules/publications/pages/german.adoc diff --git a/docs/fr/modules/publications/pages/german.adoc b/docs/fr/modules/publications/pages/german.adoc new file mode 100644 index 0000000000..14d09475be --- /dev/null +++ b/docs/fr/modules/publications/pages/german.adoc @@ -0,0 +1,10 @@ += German Publications + +== Media + +* Macher, J. (2020, March 4), _Barcelonas Erfolg mit der Plattform Decidim. Deutschlandfunk_ https://www.deutschlandfunk.de/wenn-buerger-politik-gestalten-barcelonas-erfolg-mit-der.795.de.html?dram:article_id=471680 +* Huber, P. (2019, May 29), _In Barcelona schreiben die Bürger das Regierungsprogramm selbst – und machen ihre Stadt sozialer_ https://kontrast.at/barcelona-smart-city-wirtschaft/ +* _Wie Barcelona eine offene “Smart City” im Dienste des Gemeinwohls plant_. (2018, September 9). https://netzpolitik.org/2018/freie-software-als-oeffentliches-gut-und-was-rathaeuser-dafuer-tun-koennen/ + +pass:[
][.biblio-abstract-label]#Abstract.# Im Interview spricht Francesca Bria, Barcelonas Chief Technology and Digital Innovation Officer, über “Digitale Soziale Innovation” und passende Strategien um die lokale Wirtschaft, Privatsphäre und die demokratische Teilhabe der Bürger*innen auch in einer “Smart City” langfristig zu sichern und zupass:[
] +* Macher, J. (n.d.). _Digital und demokratisch (neues deutschland)_. Retrieved December 7, 2019, from https://www.neues-deutschland.de/artikel/1129769.smart-city-digital-und-demokratisch.html + +pass:[
][.biblio-abstract-label]#Abstract.# In Barcelona bedeutet »Smart City«: Mehr Mitsprache für die Menschen. Andere Städte sind dem Beispiel gefolgt.pass:[
] \ No newline at end of file From 3ecfbc1124131637e8ea7c511ae86b459c517605 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:56:10 +0200 Subject: [PATCH 126/336] New translations italian.adoc (French) --- docs/fr/modules/publications/pages/italian.adoc | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 docs/fr/modules/publications/pages/italian.adoc diff --git a/docs/fr/modules/publications/pages/italian.adoc b/docs/fr/modules/publications/pages/italian.adoc new file mode 100644 index 0000000000..4c85f3200d --- /dev/null +++ b/docs/fr/modules/publications/pages/italian.adoc @@ -0,0 +1,6 @@ += Italian Publications + +== Media + +* _Perché Barcelona Smart City è un modello per il mondo. Intervista a Francesca Bria_. (2018, August 13). http://www.designatlarge.it/barcelona-smart-city-francesca-bria/ + +pass:[
][.biblio-abstract-label]#Abstract.# La sovranità tecnologica ai cittadini. Ecco come Barcelona Smart City è diventata un modello per il mondo. Intervista alla CTO Francesca Briapass:[
] \ No newline at end of file From 1c6a07acebc910e90d5bf2f2cd27cf0d64fd890c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:56:12 +0200 Subject: [PATCH 127/336] New translations spanish.adoc (French) --- .../modules/publications/pages/spanish.adoc | 34 +++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 docs/fr/modules/publications/pages/spanish.adoc diff --git a/docs/fr/modules/publications/pages/spanish.adoc b/docs/fr/modules/publications/pages/spanish.adoc new file mode 100644 index 0000000000..165abbb338 --- /dev/null +++ b/docs/fr/modules/publications/pages/spanish.adoc @@ -0,0 +1,34 @@ += Spanish Publications + +== Academic + +* Barandiaran, X. E., Calleja, A., Monterde, A., Aragón, P., Linares, J., Romero, C., & Pereira, A. (2017). Decidim: Redes políticas y tecnopolíticas para la democracia participativa. __Recerca__. Revista de pensament i anàlisi., 21, 137-150. https://doi.org/10.6035/Recerca.2017.21.8 +* Barandiaran, X. E. (2019). Tecnopolítica, municipalismo y radicalización democrática. In L. Roth, A. Monterde, & A. Calleja-López (Eds.), _Ciudades Democráticas. La revuelta municipalista en el ciclo post-15M_ (pp. 173–207). Icaria. http://ciudadesdemocraticas.tecnopolitica.net/ +* Borge, R., Balcells, J., Padró-Solanet, A., Batlle, A., Orte, A., & Serra, R. (2018) La participación política a través de la plataforma Decidim: análisis de 11 municipios catalanes. Paper presentado en el IX Congreso Internacional en Gobierno, Administración y Políticas Públicas GIGAPP. Madrid, 24-27 Septiembre. https://dryfta-assets.s3-accelerate.amazonaws.com/assets/congreso2018/abstractfiles/1536574598Laparticipacion_politica_a_traves_de_la_plataforma_Decidim.pdf +* Solà, J. (2018). _How are decisions made in Decidim.barcelona_ [Master Thesis, Pompeu Fabra]. https://repositori.upf.edu/handle/10230/36105 +* Barandiaran, X. E., Monterde, A., & Pin, G. (2016a). Decidim.barcelona: autonomia, participació i programari lliure. In Xarxaip (Ed.), _Programari lliure i de codi obert-Societat lliure i govern obert._ (pp. 31–32). +* Barandiaran, X. E., Monterde, A., & Pin, G. (2016b). Decidim.barcelona: autonomía, participación y software libre - Software libre. In Xarxaip (Ed.), _Programari lliure i de codi obert-Societat lliure i govern obert._ (pp. 31–32). http://softwarelibre.xarxaip.cat/18.html +* Aragón, P., Kaltenbrunner, A., Calleja-López, A., Pereira, A., Monterde, A., Barandiaran, X. E., & Gómez, V. (2017). Deliberative Platform Design: The Case Study of the Online Discussions in Decidim Barcelona. _Social Informatics_, 277–287. https://doi.org/10.1007/978-3-319-67256-4_22 + +pass:[
][.biblio-abstract-label]#Abstract.# With the irruption of ICTs and the crisis of political representation, many online platforms have been developed with the aim of improving participatory democratic processes. However, regarding platforms for online petitioning, previous research has not found examples of how to effectively introduce discussions, a crucial feature to promote deliberation. In this study we focus on the case of Decidim Barcelona, the online participatory-democracy platform launched by the City Council of Barcelona in which proposals can be discussed with an interface that combines threaded discussions and comment alignment with the proposal. This innovative approach allows to examine whether neutral, positive or negative comments are more likely to generate discussion cascades. The results reveal that, with this interface, comments marked as negatively aligned with the proposal were more likely to engage users in online discussions and, therefore, helped to promote deliberative decision making.pass:[
] + +== Media + +* Calleja-López, A., Monterde, A., & Barandiaran, X. E. (2017, October 18). _De las redes sociales a las redes (tecno)políticas: redes de tercera generación para la democracia del siglo XXI_ [Text]. http://tecnopolitica.net/content/de-las-redes-sociales-las-redes-tecnopol%C3%ADticas-redes-de-tercera-generaci%C3%B3n-para-la + +pass:[
][.biblio-abstract-label]#Abstract.# La sociedad deviene (en) red.pass:[
] +* _TIPS - Cultura digital - La democracia 2.0_. (2017, February 2). http://www.rtve.es/alacarta/videos/tips/tips-cultura-digital-democracia-20/3896837/ + +pass:[
][.biblio-abstract-label]#Abstract.# TIPS - Cultura digital - La democracia 2.0, Tips online, completo y gratis en RTVE.es A la Carta. Todos los programas de Tips online en RTVE.es A la Cartapass:[
] + +[[ref-4881969-FWFFK8LS]] +* Bravo, E. (2016, July 20). _Cómo mejorar Barcelona con la participación de sus ciudadanos_ [Magazzine]. http://www.yorokobu.es/barcelona-participacion/ + +pass:[
][.biblio-abstract-label]#Abstract.# El cricket es un deporte muy curioso. Los partidos pueden durar días y, entre sus reglas, está la de parar el juego para tomar el té. Una de las potencias en este deporte es Paquistán, país del que procede parte de la población inmigrante de Barcelona. Muchos de los miembros de esa comunidad llevan años […]pass:[
] +* Barandiaran, X. E., Pereira, A., Monterde, A., & Calleja-López, A. (2016). _Plan de desarrollo Decidim Barcelona_. Ajuntament de Barcelona City Council. https://decidim-barcelona.s3.amazonaws.com/uploads/decidim/attachment/file/54/Plan_desarrollo_decidim.pdf + +pass:[
][.biblio-abstract-label]#Abstract.# Este documento detalla el futuro desarrollo de la plataforma digital de participación de l´Ajuntament de Barcelona, decidim.barcelona (disponible en URL https://decidim.barcelona). Los principales objetivos de la plataforma son articular, estandarizar, visualizar y comunicar todos los procesos de participación del Ajuntament de Barcelona y de la ciudad ofreciendo un servicio de infraestructura digital para la democracia directa y participativa a todas las escalas territoriales y asociativas de Barcelona. El documento detalla los objetivos de la plataforma, el flujo de desarrollo, las funcionalidades previstas, y un código ético-político.pass:[
] +* Participa Pamplona. (2017a, July 18). _Decidim Barcelona (Xabier Barandiaran)_. https://www.youtube.com/watch?v=zQYvdwGsg8M + +pass:[
][.biblio-abstract-label]#Abstract.# 1a Jornada de tecnología y democracia (24/05/2017). Infraestructuras digitales para la democracia. Decidim Barcelona Xabier Barandiaran. Coordinador del proyecto Decidim, asesor de la Regiduría de Participación del Ayuntamiento de Barcelona. Teknologia eta demokraziari buruzko 1. jardunaldia (24/05/2017). Demokrazia partizipatiborako azpiegitura digitalak Decidim Barcelona Xabier Barandiaran. Decidim proiektuaren koordinatzailea eta Bartzelonako Udaleko Partaidetza zinegotziaren aholkulariapass:[
] +* Participa Pamplona. (2017b, July 18). _Hacia una democracia participativa inteligente y democrática (Asier Gallastegui y Asier Amezaga)_. https://www.youtube.com/watch?v=z4FTUt8wnRs + +pass:[
][.biblio-abstract-label]#Abstract.# 1a Jornada de tecnología y democracia (24/05/2017). Infraestructuras digitales para la democracia. Decidim Barcelona Xabier Barandiaran. Coordinador del proyecto Decidim, asesor de la Regiduría de Participación del Ayuntamiento de Barcelona. Teknologia eta demokraziari buruzko 1. jardunaldia (24/05/2017). Demokrazia partizipatiborako azpiegitura digitalak Decidim Barcelona Xabier Barandiaran. Decidim proiektuaren koordinatzailea eta Bartzelonako Udaleko Partaidetza zinegotziaren aholkulariapass:[
] +* Participa Pamplona. (2017c, July 18). _Metadecidim. Diseño participativo de la plataforma Decidim Barcelona (Andrés Pereira de Lucena)_. https://www.youtube.com/watch?v=I31yY4ip3rk + +pass:[
][.biblio-abstract-label]#Abstract.# 1a Jornada de tecnología y democracia (24/05/2017). Infraestructuras digitales para la democracia. Andrés Pereira de Lucena. Presidente de la asociación aLabs, coordinador técnico y arquitecto técnico de Decidim. Teknologia eta demokraziari buruzko 1. jardunaldia (24/05/2017). Demokrazia partizipatiborako azpiegitura digitalak Andrés Pereira de Lucena. aLabs elkarteko lehendakaria eta Dicidimen koordinatzaile teknikoa eta arkitekto teknikoa.pass:[
] +* Barandiaran, X. E., & Romero, C. (2018, May 17). _Presentació Decidim Ada Lovelace_. https://www.youtube.com/watch?v=-3eh_v339Cg +* Barcelona Activa. (n.d.). _Fòrum d’Economies Col·laboratives Procomuns 2017. Activitat paral·lela 3_. Retrieved January 13, 2018, from https://www.youtube.com/watch?v=IvDsgJcNxnQ +* Govern Digital. (n.d.). _CGDL2018 - Participació ciutadana: com fer de la política quelcom més proper_. Retrieved April 9, 2018, from https://www.youtube.com/watch?v=7LH6OItIrRU \ No newline at end of file From f6a4c472a087dc1033db0026d38edfbad2a9afa0 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:56:13 +0200 Subject: [PATCH 128/336] New translations index.adoc (French) --- docs/fr/modules/releases/pages/index.adoc | 34 +++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 docs/fr/modules/releases/pages/index.adoc diff --git a/docs/fr/modules/releases/pages/index.adoc b/docs/fr/modules/releases/pages/index.adoc new file mode 100644 index 0000000000..b8433a43af --- /dev/null +++ b/docs/fr/modules/releases/pages/index.adoc @@ -0,0 +1,34 @@ += Releases + +Here you can find all the blog posts for every minor release. + +You can find all the releases (with minor and patches) at +https://rubygems.org/gems/decidim/versions[RubyGems.org] and +https://github.com/decidim/decidim/releases[GitHub]. + +* https://decidim.org/blog/2022-09-30-new-version-0-27-0/[Version 0.27 (2022-09-30)] +* https://decidim.org/blog/2022-02-22-new-version-0-26-0/[Version 0.26 (2022-02-22)] +* https://decidim.org/blog/2021-10-07-new-version-0-25-0/[Version 0.25 (2021-10-07)] +** xref:develop:guide_migrate_webpacker_module.adoc[Migrate to Webpacker a module] +** xref:develop:guide_migrate_webpacker_app.adoc[Migrate to Webpacker an instance app] +* https://decidim.org/blog/2021-03-26-new-version-0-24-0/[Version 0.24 (2021-03-26)] +* https://decidim.org/blog/2020-11-12-new-version-0-23-0/[Version 0.23 (2020-11-12)] +* https://decidim.org/blog/2020-09-02-new-version-0-22-0/[Version 0.22 (2020-09-02)] +* https://decidim.org/blog/2020-04-12-new-version-0-21-0/[Version 0.21 (2020-04-12)] +* https://decidim.org/blog/2020-02-06-new-version-0-20-0/[Version 0.20 (2020-02-06)] +* https://decidim.org/blog/2019-10-21-release-0-19-0/[Version 0.19 (2019-10-21)] +* https://decidim.org/blog/2019-07-03-release-0-18-0/[Version 0.18 (2019-07-03)] +* https://decidim.org/blog/2019-03-25-release-0-17-0/[Version 0.17 (2019-03-25)] +* https://decidim.org/blog/2019-01-14-release-0-16-0/[Version 0.16 (2019-01-14)] +* https://decidim.org/blog/2018-12-13-release-0-15-0/[Version 0.15 (2018-12-13)] +* https://decidim.org/blog/2018-08-30-release-0-14-0/[Version 0.14 (2018-08-30)] +* https://decidim.org/blog/2018-07-11-release-0-13-0/[Version 0.13 (2018-07-11)] +* https://decidim.org/blog/2018-06-13-release-0-12-0/[Version 0.12 (2018-06-13)] +* https://decidim.org/blog/2018-04-27-release-0-11-0/[Version 0.11 (2018-04-27)] +* https://decidim.org/blog/2018-03-29-release-0-10-0/[Version 0.10 (2018-03-29)] +* https://decidim.org/blog/2018-02-06-release-0-9-0/[Version 0.9 (2018-02-06)] +* https://decidim.org/blog/2017-12-21-release-0-8-0/[Version 0.8 (2017-12-21)] +* https://decidim.org/blog/2017-11-21-release-0-7-0/[Version 0.7 (2017-11-21)] +* https://decidim.org/blog/2017-09-21-release-0-6-0/[Version 0.6 (2017-09-21)] +* https://decidim.org/blog/2017-08-29-release-0-5-0/[Version 0.5 (2017-08-29)] +* https://decidim.org/blog/2017-07-17-release-0-4-0/[Version 0.4 (2017-07-17)] \ No newline at end of file From e4eadff367da9140aa1c08b2363882a4b661dd83 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:56:14 +0200 Subject: [PATCH 129/336] New translations about.adoc (French) --- docs/fr/modules/understand/pages/about.adoc | 90 +++++++++++++++++++++ 1 file changed, 90 insertions(+) create mode 100644 docs/fr/modules/understand/pages/about.adoc diff --git a/docs/fr/modules/understand/pages/about.adoc b/docs/fr/modules/understand/pages/about.adoc new file mode 100644 index 0000000000..7522cbfe2c --- /dev/null +++ b/docs/fr/modules/understand/pages/about.adoc @@ -0,0 +1,90 @@ += About + +:experimental: +:icons: font +:page-partial: +:source-highlighter: highlightjs + +Decidim is a technopolitical project. A digital citizen-participation platform for a democratic city, made openly and collaboratively using free software.. It is a public commons infrastructure. Public because it enjoys a clear institutional impetus and commons because the code is open and free, in other words, anyone can see it, use it, copy it or amend it. It is a platform designed for coordinating citizen-participation processes and spaces, aimed at extending and facilitating access to citizen participation, opening new spaces for deliberation and collaboration in co-designing and co-producing public policies and new spaces for direct participation and democracy, thereby enabling disintermediation and cooperation between citizens, institutions and organisations of civil society. + +[#decidim.barcelona-fig] +._decidim.barcelona_. +image::decidim_barcelona_homepage.png[decidim.barcelona homepage] + +== Principles + +The Decidim platform has been designed and developed on the basis of a series of principles that promote further exploration and democratic innovation in the digital era as well as possibilities for improving, opening and developing citizen-participation policies and democratic forms of government at various levels, with special emphasis on the municipal scale. These principles are listed below: + +=== Technopolitical hybridisation + +This is key to preventing what we could define as “digital reductionism" (Calleja-López, 2017), a variant of technocentrism that puts the emphasis mainly or exclusively on the new participatory forms’ digital aspects and infrastructures, without dealing with the necessary powerful innovations in participatory practices, processes and culture that result from the hybridisation of face-to-face and digital participation. The hybrid approach attempts to connect spaces and activities taking place in decidim.barcelona with face-to-face spaces and activities and to consider the multiple variants that may arise for the purposes of boosting new forms of collective action. + +=== Enhanced and multi-modal participation + +The result of digital reductionism is to foster "click-participation" (Calleja-López, 2017), where participation becomes a definite phenomenon, first and foremost for its digital aspect, and, more specifically, for its convenience, speed and non-interference with other players and ideas. There is therefore a need to boost enriched forms of interaction between people in decidim.barcelona, ​​and between them, the platform’s contents and the hybrid participatory processes in a broader sense. This implies, on the one hand, enriching participatory processes with functions that go beyond voting (information and data displaying, deliberation etc.,) and, on the other, designing hybrid processes (e.g. Face-to-face meetings connected to the platform), which turn participation into an enhanced, comprehensive and multimodal participation, rather than reduced and “clicked”. + +=== Transparency and traceability + +With the exception of data that can affect user privacy, details of activities in participatory processes in digital media need to be absolutely traceable and public, if a new level of transparency in participation is to be fostered. Transparent participation and traceability are necessary conditions for confidence in these new processes. + +=== Opening/ releasing + +The principles of releasing and opening refer firstly to the platform’s code and functions, secondly to the processes’ data and contents and thirdly and more generically, to the processes themselves. This implies, in the first two cases, using the most exacting share-alike licenses and standards (e.g. Affero GPLv3 for code, CreativeCommons for content, Open Access Database Licences for data). Decidim needs to be a free-software platform that allows anyone to see, amend and reuse the code it is based on. In the case of processes, these principles connect to several others that we mention in this list, such as transparency and accessibility, and aim to make these processes as participatory and reappropriable as possible on multiple levels. + +=== Cross-cutting participation + +Dealing with many of the keys of success for recent initiatives such as 15M, decidim.barcelona's deployment and communication strategies and media processes need to be geared towards achieving legitimacy first and then participation, within reach of as many social and political groups as possible. + +=== Knowledge, technoscience and collective intelligence + +The new forms of participation should benefit from the possibilities that are offered by both popular and expert knowledge from citizens and data science (data occasionally from the participatory processes themselves) to improve decision-taking and participation. An informed and expert participation, capable of catalysing social knowledge. + +=== Collective and networked participation + +One of the central challenges to achieiving an “enhanced”, digitally mediated, participation, is boosting its collective dimension in the face of atomising tendencies, often resulting from remote-participation conditions. This implies using functions that boost interactions between users in collective processes, whether on a platform or face to face. Digital or face-to-face discussion and deliberation spaces are necessary for coordinating better participation. + +=== Public-commons orientation, reappropriation and recursive participation + +Democracy’s new digital infrastructures have to be a space belonging to, by and for the commons. If democracy is to be promoted, infrastructures themselves have to be radically democratic. This implies consideration of an innovative and alternative model to the one for privatising the public sphere. To this end, Decidim needs to be a digital infrastructure of public-commons construction, ownership and use. In other words, what we define as "technopolitical commons", technology open to participation from everyone and anyone in its design and management, governed through distribution and with collective-production and share-alike models. Compared to the closed and exclusive platforms controlled by big corporations, Decidim is a democratic infrastructure for democracy. + +=== Technopolitical accessibility and training + +It also needs to be a public service, which is why it is essential to ensure citizens have access and training for taking part and exploiting all its potential. Promoting its grassroots-empowered use and use by excluded social groups is a key challenge. Both decidim.barcelona and digital participatory processes have to be governed by more demanding accessibility standards (e.g. Those of the Web Accessibility Initiative, WAI). + +=== Independence, empowerment and affiliation + +If social movements have demonstrated something over the last few years it is the central role played by self-organised collective action in kick-starting and guiding processes of change. In this regard decidim.barcelona and the processes using the platform need to boost social independence and self-organisation. In addition, political affiliation has to be a requisite feature in many of the platform’s processes, given that it is a key element of the platform’s medium- and long-term public and operative legitimacy. In other words, both independent social processes and bottom-up processes that are affiliated to public institutions. + +== Brief history + +During its public presentation in September 2015, Decide Madrid, a digital participatory platform launched by Madrid City Council and based on Consul software, began to experiment with various participatory processes, such as public debates and citizen proposals. Launched by Barcelona City Council, the Decidim Barcelona project, which was also based on Consul but with major changes and adapted to new needs, was presented in February 2016. ​​Its original goal was to coordinate the participatory process for drafting the Municipal Action Plan (PAM) as well as other participatory processes in the city in the future. Some 25,000 people signed up to it in under two months, 10,860 proposals were submitted, 410 meetings held and over 160,000 votes in favour collected. In this way a collaboration and deliberation space opened up between citizens, social organisations and Barcelona City Council. + +A great deal of interest was expressed in many municipalities in going ahead with similar processes, taking advantage of the technology used, given its success and the fact it was free and reusable. To be more specific: Coruña City Council, through its A Porta Aberta platform for Participatory Budget processes; Oviedo City Council, through its Consulta Oviedo, with a space for citizen proposals, and Valencia City Council, through decidimVLC, for preparing participatory budgets. There were also numerous cases of local authorities and other institutions showing great interest in the decidim.barcelona project and its implementation, such as the city councils of Hospitalet, Badalona, ​​Terrassa and Gavà, as well as Barcelona Provincial Council and the Localret Consortium. + +This series of changes and adaptations led in turn to a new technological need involving the adaptation of technology dealing with local-authority diversity, independence and the medium-term sustainability of the platform. Hence the establishment of a scalable and decentralised (or modular) development strategy enabling the entire project to be flexible and grow over time as well as generate a development, functional design and support community, which is sustained at both municipal and (more importantly) inter-municipal levels. + +This led Barcelona City Council to thoroughly reconsider the platform’s architecture and carry out a complete rewrite of the software based on the above-mentioned principles and needs. This rewrite gave rise to the Decidim project, a generic,participatory democratic framework based on Ruby on Rails, whereby any group, organisation or institution that wanted to use it could do so with minimum technical requirements. + +== Open development and free software + +The Decidim platform project has been developed with free software (both at its initial stage, based on Consul, and after the code's complete rewrite) and all its development has been open, enabling its entire development to be traceable and followed right from the very beginning. + +Its creation from free software refers to the fact that the platform's source code has a AGPL v3 Licence or GNU Affero General Public Licence,footnote:[https://github.com/AjuntamentdeBarcelona/decidim/blob/master/LICENSE-AGPLv3.txt] which means the code has to allow for the possibility of its being consulted, copied, amended and reused, so long as the same licence is kept in any work or product derived from it. This is one of the licences that provides most freedom and is copyleft footnote:[Copyleft stands for a whole range of licences that can be applied to IT, artistic and other creations. Copyleft's supporters see copyright as a way of restricting people's right to make and redistribute copies of a work.[2] A copyleft licence, in fact, uses actual copyright legislation to ensure that everyone who receives a copy or derived work can use, amend and even distribute both the work and any derivative versions. In a strictly non-legal sense, then, copyleft is the opposite of copyright. (Wikipedia, 2017).]. In this regard, it makes sense for public authorities to make a clear commitment to this type of software, given that it is through such licences that we can receive social return on our public investments. + +The fact that the software has been openly developed means that the entire development process is transparent and accessible, in other words, that anyone can see, right from the start of the software's development, every change, contribution, community of developers involved etc. By the same token, transparency is becoming a fundamental principle not just in citizen participation but in software development too. + +All this has been done on a platform designed for open collaboration in software development known as GitHub.footnote:[https://github.com/] This platform enables access to codes and monitoring of the software's development. GitHub is designed to host Git repositories, though there are other alternatives to GitHub such as GitLab. + +== Decidim Barcelona + +Decidim Barcelona is the first instance of Decidim and the origin of the project. Decidim Barcelona came about from Barcelona City Council’s need to open up a technologically mediated citizen-participation process around the Municipal Action Plan (PAM), with three major goals: making a process that is transparent and traceable, expanding participation through the digital platform and integrating face-to-face and digital participation. + +This process received over 10,000 proposals and more than 160,000 votes in favour, with a final balance of 71% of citizen proposals accepted and included in PAM through over 1,600 initiatives. Decidim was originally designed exclusively for hosting this process though the need for extending it to other participation processes was quickly spotted. + +It was here that the idea for today's Decidim came about. A participatory platform that enables as many processes as people want, divided up into stages and with the possibility of setting several functions at each stage. The possibility was accordingly left open for designing new functions that could be integrated into the processes (surveys, collaborative-text drafting, result monitoring and so on), as well as the integration of new participatory spaces such as citizen initiatives and participation councils. + +Decidim Barcelona is currently (July 2017) hosting 12 participatory processes and already has some 26,600 participants, almost 12,000 collected proposals, 1,700 results, 670 face-to-face meetings and 185,000 votes in favour collected. The platform’s good results in Barcelona led to its extension to other municipalities, including Hospitalet de Llobregat, Sabadell, Badalona, Terrassa, Gavà, Sant Cugat, Mataró and Vilanova i la Geltrú. + +== Decidim Municipis + +Decidim is a multitenant platform, that is, a platform where as many instances can be used as needed, with a single installation. There are numerous successful examples of multitenant architectures in the world of software, such as the Wordpress free software for blogs project. It is especially useful for institutions that wish to provide Decidim as a third-party service. The Provincial Council's case is especially important as it can be used with a single installation - maintained, updated and sustained by a single entity - for as many local authorities as desired, thereby reducing installation and maintenance costs and providing technological solutions for improving citizen participation in medium-sized and small local authorities that would otherwise have much less access to such resources. \ No newline at end of file From 97b73c198dfb96464cdf93d35edd3d04ee06ceba Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:56:16 +0200 Subject: [PATCH 130/336] New translations background.adoc (French) --- .../modules/understand/pages/background.adoc | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 docs/fr/modules/understand/pages/background.adoc diff --git a/docs/fr/modules/understand/pages/background.adoc b/docs/fr/modules/understand/pages/background.adoc new file mode 100644 index 0000000000..d2b4cce858 --- /dev/null +++ b/docs/fr/modules/understand/pages/background.adoc @@ -0,0 +1,29 @@ += Background + +:experimental: +:icons: font +:page-partial: +:source-highlighter: highlightjs + +== Citizen participation in the Network Society + +Becoming a network(ed) society. Information and communication technologies (henceforth, ICTs) and their associated practices are bringing about irreversible changes to the social and political landscape. From the smallest residents’ association to the most intensive electoral campaign, from a neighbourhood organisation or social movement to the European Union, political relations are being increasingly determined by the use of digital devices and technologies. It seems that the future of democratic participation and collective action will be through the development of digital platforms and hybrid processes, which renovate traditional practices and combine them with digital ones (Fuchs, 2007). + +This transition coincides with the decline of representative systems over the last few decades (Norris, 1999; Pharr & Putnam, 2000; Tormey, 2015), which has contributed to the questioning of the legitimacy and sense of democracy itself, reduced and often identified with this system (Crouch, 2004; Keane, 2009; Streeck, 2016). Several authors have used the terms “post-representation" to refer to the emptying of power and meaning of the representative institutions that go from globalisation to disaffection and divestment of citizens (Brito Vieira and Runciman, 2008; Keane, 2009; Rosanvallon , 2011; Tormey, 2015). The various attempts to boost participation have proved unequal to the task of reversing these trends (Keane, 2011; Tormey, 2015). + +This long-running political crisis comes on the back of the financial and economic crisis of 2008, and is directly linked to this earlier crisis. Even so, millions of people mobilised in the face of the crisis, intent not only on demanding but also on experimenting and building a real democracy. The key development here was the 15M network-movement. It is in the context of technological hypermediation that information and communication technologies, used in the 1980s and 1990s to accelerate financial flows and globalisation (Castells, 1996), became crucial spaces and devices for a multitudinous re-appropriation of policy, as well as democratic experimentation (Martinet Ros et al., 2015). + +After four years of numerous successes and failures, new political citizen initiatives in May 2015 managed to take power in Spain’s main cities, including Barcelona. In this respect they were riding on the tide of countries such as Iceland, where the economic crisis had led to a period of citizen re-appropriation of the institutions and fertile democratic innovation, based on an intense and creative use of ICTs. + +Since 15M, most of the experiments aimed at introducing new forms of participatory and deliberative democracy (Barber, 1984; Habermas, 1994, 1996; Della Porta 2013) have been technologically mediated. As can be seen from the case of Iceland (as well as others, such as Finland), the democratising processes of citizen mobilisation and empowerment require technopolitical coordination (Rodotà 1997; Martinet Ros et al., 2015) to achieve their maximum richness and capacity. Technopolitics stems from the politicisation of technologies and technological re-assemblage of politics as well as the co-development and co-production of politics and technologies. As for forms of technopolitical participation and deliberation, digital and face-to-face practices, spaces and processes connect to and feed back from one another, acquiring a multi-layered dimension. These participatory devices are geared towards increasing the number, variety and parity of players that "take part" in the city’s common government, expanding and enriching the areas, forms and periods in which it takes place and helping to boost a collective intelligence (Levy, 1997) capable of taking on the complexity of contemporary urban life. Technopolitics needs to tackle the numerous limits of what has been called “digital democracy" (Hindman, 2008) starting by freeing itself from the technocentric and technooptimistic narratives around digitally mediated participation. + +New participatory processes are being built within a context full of opportunities and fraught with risks. The 2015 government programme and Municipal Action Programme (PAM) for 2016-2019 drawn up for the city of Barcelona gives centre stage to participation and, more specifically, innovation and the development of new democratic participatory models. PAM, ​​the development of which involved thousands of people, meets a clear social demand that calls for ​​a thorough redesign of the democratic system and its participatory mechanisms. This, however, is occurring in a context defined by: a) large politically, economically and socially excluded population sectors; b) increasing difficulty accessing participation as a result of the economic-crisis situation; c) a crisis over the legitimacy and operability of the representative democratic system and public authorities; d) an enormous technological dependency on private corporate infrastructures and services; e) a legal and political context adverse to direct democracy, social independence and territorial sovereignty; f) an abysmal institutional disadvantage in understanding social complexities through techniques analysing social-behaviour data and models that big technological companies and digitally coordinated services possess. + +[[h.2et92p0]] +== Data Control and digital infrastructures for democracy + +In the context of new configurations of informational capitalism (Castells, 1996), so-called “data capitalism" (Lohr, 2015; Morozov, 2015) or "surveillance capitalism" (Zuboff, 2015), the new digital infrastructures of democracy run the risk of contributing to dynamics contrary to such principles as privacy and technological sovereignty. Exclusive, closed and opaque platforms geared towards exploiting social activities for corporate profit are operating as non-democratic spaces occupying more and more areas of social life. This model is particularly dangerous in relation to the new infrastructures and processes of democracy that we are talking about. + +Compared to the exclusive and corporate infrastructural model, the public commons model, which we believe decidim.barcelona’s development needs to be inspired by, ​​is geared towards developing platforms where design, ownership and management are free, open and participatory, shared between public workers and citizens (organised or not). Under this model, not only the platform's code but also the data that are generated in it are processed and appropriated according to the logic of public and common management. The opening-up of everything and anything to participation, the hallmark of the commons as a political principle (as opposed to the private and even state-public sphere --- Laval & Dardot, 2015), seems to be a basic condition for participatory infrastructures to be fully functional. Participation has to be recursive here: it needs to help to define and establish the infrastructural conditions of its own existence and to affect the design, development and management of digital participatory platforms as well as the processes and results (e.g. data) that are generated in them. + +Put in the hands of large digital-service corporations, the algorithmic organisation of social life and the area we are concerned with, political participation, poses a risk to democracy and technological sovereignty that only a public commons effort in digital infrastructures can reverse. Only platforms based on free, open, transparent, secure and public-commons management software offer guarantees when it comes to building democracies of greater quality. The democracy of the future has to be built, then, on democratic infrastructures. \ No newline at end of file From 88be6f19ce1a4aabed6eb47007b66ce335b963c2 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:56:17 +0200 Subject: [PATCH 131/336] New translations social-contract-ca.adoc (French) --- .../understand/pages/social-contract-ca.adoc | 63 +++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 docs/fr/modules/understand/pages/social-contract-ca.adoc diff --git a/docs/fr/modules/understand/pages/social-contract-ca.adoc b/docs/fr/modules/understand/pages/social-contract-ca.adoc new file mode 100644 index 0000000000..cedfaf7ea8 --- /dev/null +++ b/docs/fr/modules/understand/pages/social-contract-ca.adoc @@ -0,0 +1,63 @@ += Contracte Social de Decidim + +[NOTE] +==== +Pots llegir el Contracte Social de Decidim en altres idiomes: xref:understand:social-contract-es.adoc[Castellano] - xref:understand:social-contract.adoc[English] + +Si vols traduïr-ho al teu idioma sisplau https://decidim.org/contact[contacta amb nosaltres]. +==== + +Codi de garanties democràtiques i de col·laboració oberta + +Aquest és el contracte social que tots el membres del projecte Decidim es comprometen a seguir. + +La utilització de la plataforma Decidim per part de qualsevol ajuntament o qualsevol altre ens municipal o supramunicipal, així com altres organitzacions, comporta l'assumpció total i íntegra d'aquest codi. + +== Programari lliure i continguts oberts + +El codi de la plataforma, així com els mòduls, llibreries o qualsevol altre codi que es desenvolupi per al seu funcionament, serà sempre programari lliure amb llicència https://www.gnu.org/licenses/agpl-3.0.en.html[Affero GPLv3 o posterior] en el cas dels nous desenvolupaments, i de llicències compatibles amb aquesta en el cas de reutilització d’altres codis. + +Així mateix, els continguts, dades, APIS i/o interfícies que el Decidim faci servir per interactuar amb qualsevol tipus d’usuari, compliran amb estàndards oberts i interoperables (ex. OpenID, RSS, OStatus, etc.), tendint sempre al màxim nivell d’integració amb els estàndards oberts més estesos. + +De cara a maximitzar la transparència i la col·laboració ciutadana en els processos, òrgans i mecanismes de participació, el contingut de textos, gràfiques, fonts tipogràfiques, àudio, vídeo o altres elements de disseny, es farà públic amb una llicència https://creativecommons.org/licenses/by-sa/4.0/legalcode[Creative Commons By-Sa]. + +Igualment les dades de la plataforma, especialment totes aquelles que es puguin recollir de manera sistemàtica a través de scrappers o altres tècniques de consulta massiva, seran publicades amb llicències http://opendatacommons.org/licenses/odbl[Open Data Commons Open Database License], en formats estandarditzats i accessibles (tipus CSV, JSON, etc.) i, sempre que sigui possible, amb eines que facilitin l’anàlisi i visualizació d’aquestes dades. + +== Transparència, traçabilitat i integritat + +La plataforma, així com la seva configuració, desenvolupament, implementació i ús actual o futur han de garantir i maximitzar en tot moment la transparència, la traçabilitat i la integritat dels diagnòstics, propostes, debats, decisions, o qualsevol altre objecte, mecanisme o procés de participació. + +Per transparència entenem que totes les dades relacionades amb aquests mecanismes i processos estiguin disponibles per a baixar, analitzar i tractar, seguint els formats i estàndards de compartició més exigents (accessibilitat, multi-format, etc.). + +La transparència serà una condició necessària pel seguiment dels processos i mecanismes de participació, però mai, i en cap cas, pel tractament de dades personals que vagin contra la defensa de la privacitat de la persona participant en la plataforma. + +Entenem per traçabilitat de les propostes la possibilitat de realitzar un seguiment complet, cap enrere (passat) i cap endavant (futur), de tot el que ha passat amb les propostes, plans, reglaments o qualsevol altre tipus d'objecte de decisió o participació inclòs en un procés o mecanisme. La plataforma ha de mostrar en tot moment com, per què, per qui i amb quin tipus de garanties un determinat objecte d'un procés de participació va ser descartat, aprovat o bloquejat. + +Entenem per integritat l'autenticitat d'un determinat contingut, i la garantia que aquest no ha estat manipulat o modificat sense que aquesta modificació quedi clarament registrada i sigui visiblement verificable i contrastable, amb l'objecte d'evitar la manipulació de les propostes o resultats dels processos o mecanismes de participació. + +== Igualtat d’oportunitats i indicadors de qualitat + +Al costat de les garanties anteriorment definides, la plataforma es compromet a garantir la igualtat d'oportunitats per a totes les persones, així com les seves propostes o altres contribucions que pugui acollir. La plataforma oferirà les mateixes oportunitats de partida a tots els objectes participatius (propostes, debats, etc.) perquè siguin vistos, discutits, comentats, valorats o tractats, sense discriminació de cap tipus. En aquest sentit la identitat digital de les persones usuàries de la plataforma serà sempre personal i intransferible, la verificació que otorgui drets de decisió a la plataforma ha de ser a més única, i serà l’ens responsable l’encarregat de garantir la no-suplantació d’una persona física o jurídica. + +Amb l’objectiu de garantir la qualitat democràtica de la plataforma es fomentarà l’ús d’indicadors de qualitat a partir dels processos i mecanismes de participació, així com l’activitat de les persones usuàries de la plataforma. També es fomentarà la compartició de la configuració dels diferents components així com de les dades obertes per a la definició d’aquests indicadors. + +La igualtat en la participació política de la ciutadania és un dels principis fonamentals del sistema democràtic i la plataforma, no només ha de garantir la igualtat d’oportunitats pel que fa als usos i funcionalitats, sinó també el dret d’accés. En aquest sentit cada ens promotor de la plataforma es compromet a impulsar aquelles accions que avancin en la direcció de facilitar i acompanyar l’accés a la plataforma a tota la ciutadania per igual de manera universal, propocionant les eines i els recursos adients per a que la plataforma estigui a l’abast de qualsevol persona que en vulgui fer ús. + +== Confidencialitat de les dades + +Es garanteix la confidencialitat i la privacitat de les dades personals que els ciutadans aporten per a participar en qualsevol de les funcionalitats i/o possibilitats de participació que ofereixi la plataforma DECIDIM en tot moment. En cap cas es cediran aquestes dades personals a tercers. Tampoc es farà un ús de les mateixes que vagi més enllà de l'estrictament necessari per a la gestió del registre d'usuaris o millores de la usabilitat de la plataforma. Sempre que la tecnologia de la plataforma ho permeti les expressions de preferències polítiques en els processos de decisió romandran inaccessible fins i tot per l’ administrador/a de la plataforma o els servidors. + +== Rendiment de comptes i responsabilitat + +S’adopta un compromís davant la ciutadania de respondre totes les aportacions i consultes en el mínim temps possible. També s’adopta el compromís de donar seguiment als resultats dels processos de participació, així com de donar resposta a aquelles demandes que específicament ho sol·licitin. Finalment s’assumeix el compromís d’estudiar la incorporació d’indicadors de seguiment dels processos de participació un cop estiguin finalitzats, per tal de poder avaluar de manera sistemàtica el seu desplegament. + +== Millora contínua i col·laboració interinstitucional + +S’adoptaran mecanismes de revisió i avaluació periòdica per facilitar la millora contínua de la plataforma. + +Es prioritzarà la col·laboració i l’intercanvi d’experiències entre institucions involucrades en el projecte, amb l’objectiu de millorar, corregir i generar nous desenvolupaments que ajudin a la millora contínua de la plataforma. + +En aquest sentit es facilitaran les condicions i entorns de col·laboració a l’hora de tirar endavant millores que apuntin a un benefici comú del conjunt de la plataforma, habilitant mecanismes de coordinació interinstitucional quan sigui necessari. +Condicions d’ús + +Totes els punts d’aquest codi han de quedar reflectits en les condicions d’ús que cada ens redacti per a la seva plataforma i mai entraran en contradicció. \ No newline at end of file From ab0130a7ba483b71d53501c1ff601eeadbaf5a44 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:56:19 +0200 Subject: [PATCH 132/336] New translations social-contract-es.adoc (French) --- .../understand/pages/social-contract-es.adoc | 63 +++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 docs/fr/modules/understand/pages/social-contract-es.adoc diff --git a/docs/fr/modules/understand/pages/social-contract-es.adoc b/docs/fr/modules/understand/pages/social-contract-es.adoc new file mode 100644 index 0000000000..9f15eeba3b --- /dev/null +++ b/docs/fr/modules/understand/pages/social-contract-es.adoc @@ -0,0 +1,63 @@ += Contrato social de Decidim + +[NOTE] +==== +Puedes leer el Contrato Social de Decidim en otros idiomas: xref:understand:social-contract-ca.adoc[Català] - xref:understand:social-contract.adoc[English] + +Si lo quieres traducir a tu idioma por favor https://decidim.org/contact[contáctanos]. +==== + +Código de garantías democráticas y colaboración democrática + +Este es el contrato social que todos los miembros del proyecto Decidim se comprometen a seguir. + +El uso y desarrollo de la plataforma Decidim por parte de una institución o grupo social de cualquier tipo implica la aceptación total e integral del presente contrato social y su compromiso con el mismo. + +== Software libre y contenido abierto + +El código de la plataforma, junto con los módulos, las bibliotecas o cualquier otro código que se desarrolle para su funcionamiento y utilización, será siempre un software de código abierto libre con una licencia de https://www.gnu.org/licenses/agpl-3.0.en.html[Affero GPLv3 o versiones posteriores], siempre que el código se cree de nuevo y con licencias que sean compatibles con el anterior código cuando este se reutilice. + +Del mismo modo, el contenido, los datos, las API o cualesquiera otras interfaces que se utilicen para interactuar con cualquier tipo de usuario debe seguir estándares abiertos e interoperables (OpenID, RSS, OStatus, etcétera), procurando siempre maximizar su integración con los estándares abiertos de uso más amplio. + +Con el fin de maximizar la transparencia y la colaboración ciudadana en procesos, órganos y mecanismos participativos, el contenido, así como texto, gráficos, fuentes, audio, vídeo u otros elementos de diseño se publicarán bajo una licencia https://creativecommons.org/licenses/by-sa/4.0/legalcode[Creative Commons By-SA]. + +Los datos disponibles en la plataforma, especialmente todos los datos que se pueden recopilar de manera sistemática a través de scrappers u otras técnicas de consulta masiva, se publicarán bajo licencia http://opendatacommons.org/licenses/odbl[Open Data Commons Open Database], en formatos estandarizados y accesibles (CSV, JSON, etcétera) y, siempre que sea posible, con herramientas que faciliten el análisis y la visualización de datos. + +== Transparencia, trazabilidad e integridad + +La plataforma y su configuración, desarrollo, implementación y uso actuales o futuros deben asegurar y maximizar en todo momento la transparencia, trazabilidad e integridad de documentos, propuestas, debates, decisiones o cualquier otro objeto, mecanismo o proceso participativo. + +Por transparencia entendemos que todos los datos relacionados con todos estos mecanismos y procesos participativos están disponibles para su descarga, análisis y tratamiento, siguiendo los estándares y formatos más exigentes para compartir información (accesibilidad, multiformato, etcétera). + +La transparencia es una condición necesaria para el seguimiento de los procesos y mecanismos participativos, pero en ningún caso debe aplicarse al tratamiento de los datos personales o contra la defensa de la privacidad de las personas que participan en la plataforma. + +Entendemos por trazabilidad la capacidad de hacer un seguimiento completo de propuestas, planes, regulaciones o cualquier otro objeto de participación o decisión, tanto pasados como futuros, incluidos en un proceso o mecanismo. La plataforma debe mostrar en todo momento cómo, por qué, a través de quién y con qué garantías se desestimó, se aprobó o se bloqueó un determinado tipo de objeto de un proceso participativo. + +Entendemos por integridad la autenticidad de un contenido específico, con la seguridad de que no ha sido manipulado o alterado sin que esta modificación esté claramente registrada y sea visiblemente verificable y auditable. El objetivo de la integridad es evitar la manipulación de propuestas o resultados de procesos o mecanismos participativos. + +== Igualdad de oportunidades e indicadores de calidad + +Junto con las garantías previamente definidas, la plataforma promete garantizar la igualdad de oportunidades para todas las personas, así como para sus propuestas u otras contribuciones que la plataforma pueda albergar. La plataforma ofrecerá iguales oportunidades de inicio a todos los objetos participativos (propuestas, debates, etcétera) para que se puedan conocer, debatir, comentar, evaluar o tratar sin que exista discriminación de ningún tipo. En este sentido, la identidad digital de los usuarios de la plataforma será siempre personal y no transferible, la verificación que confiere derechos de decisión sobre la plataforma también debe ser única y la responsable de asegurar la no representación de una persona o entidad será la entidad administrativa responsable de la plataforma. + +La plataforma debe promover, con el objetivo de garantizar su calidad democrática, el uso de indicadores de calidad desarrollados a partir de los datos obtenidos de los procesos participativos y los mecanismos y la actividad de los usuarios. Se promoverá que se comparta la configuración de los diferentes componentes, así como datos abiertos, para la definición de estos indicadores. + +La igualdad en la participación política de la ciudadanía es uno de los principios fundamentales de cualquier sistema democrático, y la plataforma no solo debe garantizar la igualdad de oportunidades con respecto a los usos y las funciones, sino también el derecho de acceso. En ese sentido, la entidad a cargo de la plataforma asume el compromiso de promover acciones enfocadas a proporcionar acceso y apoyo a la plataforma para todos los ciudadanos por igual de manera universal. Las herramientas y los recursos apropiados a la plataforma están disponibles para cualquiera que los quiera usar. + +== Confidencialidad de los datos + +Se garantizará en todo momento la confidencialidad y privacidad de los datos personales que las personas puedan proporcionar para participar en cualquiera de las funcionalidades o posibilidades de participación que la plataforma proporcione. Los datos personales no se transferirán, en ningún caso, a terceros. Tampoco se utilizarán más allá de lo estrictamente necesario para el registro de usuarios y mejoras en la usabilidad de la plataforma. Siempre que la tecnología de la plataforma lo permita, la expresión de las preferencias políticas o la voluntad en los procesos de toma de decisiones seguirá siendo inaccesible incluso para el administrador de la plataforma o el servidor o servidores que la alojan. + +== Compromiso y responsabilidad + +Se establecerá un compromiso con los ciudadanos para responder a todas las consultas y contribuciones en el menor tiempo posible. También se adoptará un compromiso para dar seguimiento a los resultados de los procesos participativos y responder a esas demandas específicamente. Por último, se adoptará el compromiso de estudiar la incorporación de indicadores para el seguimiento de los procesos de participación una vez finalizados con el fin de evaluar sistemáticamente su implementación. + +== Mejora continua y colaboración interinstitucional + +Se estipularán mecanismos de revisión y evaluación periódica para facilitar la mejora continua de la plataforma. + +Se dará prioridad a la colaboración y al intercambio de experiencias entre las instituciones involucradas en el proyecto con el objetivo de mejorar, fijar y construir nuevos desarrollos para la mejora continua de la plataforma. + +En este sentido, se facilitarán las condiciones y los entornos de colaboración cuando se avance en mejoras que apunten a un beneficio común de toda la plataforma, y se permitirán mecanismos de coordinación interinstitucionales cuando sea necesario. +Términos de uso + +Todos los puntos de este código deben reflejarse en el acuerdo de licencia de usuario final (EULA, por sus siglas en inglés), documento que cada organización que presta servicios utilizando Decidim establece con los usuarios y que nunca deberá ser contradicho. \ No newline at end of file From b6765afcc6da4b1bfe6b1fbc65fe19aac87ddd3d Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:56:20 +0200 Subject: [PATCH 133/336] New translations social-contract.adoc (French) --- .../understand/pages/social-contract.adoc | 60 +++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 docs/fr/modules/understand/pages/social-contract.adoc diff --git a/docs/fr/modules/understand/pages/social-contract.adoc b/docs/fr/modules/understand/pages/social-contract.adoc new file mode 100644 index 0000000000..240f49069d --- /dev/null +++ b/docs/fr/modules/understand/pages/social-contract.adoc @@ -0,0 +1,60 @@ += Decidim's Social Contract + +[NOTE] +==== +You can also read Decidim's Social Contract in other languages: xref:understand:social-contract-ca.adoc[Català] - xref:understand:social-contract-es.adoc[Castellano] + +If you want to translate it to your own language please https://decidim.org/contact[contact us]. +==== + +Code for democratic guarantees and open collaboration + +This is the social contract that all members of the Decidim community are committed to follow. + +By signing this Social Contract, any individual, institution or social group of any kind, commits to fulfill the principles established here when using, developing and participating in the community of Decidim. + +== Free software and open content + +The code of the platform, along with the modules, libraries or any other code that is developed for its functioning and deployment, will always be Free Open Source Software with an https://www.gnu.org/licenses/agpl-3.0.en.html[Affero GPLv3 license or later versions] whenever the code is newly developed and with licenses that are compatible with the above one when code re-used. + +Likewise, the content, data, APIs and/or any other interfaces that are deployed to interact with any type of user must follow open and interoperable standards (ex. OpenID, RSS, OStatus, etc.), always tending to maximize their integration with the most widely used open standards. + +In order to maximize transparency and citizen collaboration in participatory processes, organs and mechanisms, the content, text, graphics, fonts, audio, video or other design elements will be published under a https://creativecommons.org/licenses/by-sa/4.0/legalcode[Creative Commons By-SA]. + +The data available through the platform, especially all data that can be collected in a systematic way through scrappers or other techniques of massive consultation, will be published and licensed under http://opendatacommons.org/licenses/odbl[Open Data Commons Open Database License], published under standardized and accessible formats (such as CSV, JSON, etc.) and, whenever possible, with tools that facilitate the analysis and visualization of data. + +== Transparency, traceability and integrity + +The platform, and its current or future configuration, development, deployment and use must ensure and maximize, at all times, the transparency, traceability and integrity of documents, proposals, debates, decisions, or any other object, mechanism or participatory process. + +By _transparency_ we understand that all data related to all such participatory mechanisms and processes are available for download, analysis and treatment, following the most demanding standards and formats to share information (accessibility, multi-format, etc.). + +Transparency is a necessary condition for monitoring of participatory processes and mechanisms, but should never, in any case, be applied for the treatment of personal data or against the defense of the privacy of the people participating in the platform. + +We understand by _traceability_ the ability to fully track backward (past) and forward (future) what happened to the proposals, plans, regulations, or any other object of participation or decision included in a process or mechanism. The platform must at all times show how, why, by whom and with what guarantees a certain type of object of a participatory process was dismissed, approved or blocked. + +We understand by _integrity_ the authenticity of a specific content, and ensuring that it has not been tampered with or altered without this modification being clearly recorded and visibly verifiable and auditable. The goal of integrity is to avoid manipulation of proposals or results of participatory processes or mechanisms. + +== Equal opportunities and quality indicators + +Alongside the guarantees previously defined, the platform promises to ensure equal opportunities for all people, as well as for their proposals or other contributions the platform might host. The platform will offer equal starting opportunities to all participatory objects (proposals, debates, etc.) for them to be viewed, discussed, commented, evaluated or treated without discrimination of any kind. In this sense, the digital identity of the users of the platform will always be personal and not transferable, the verification that confers decision rights on the platform should also be unique, and it is the administrative entity in charge of the platform who should be responsible for ensuring non-impersonation of a person or entity. + +The platform should promote, with the aim of ensuring its democratic quality, the use of quality indicators developed on the basis of the data obtained from participatory processes, mechanism and user activity. Sharing of the setting of the different components as well as open data will be promoted for the definition of these indicators + +Equality in political participation of citizens is one of the fundamental principles of any democratic system and the platform, not only has to ensure equal opportunities with respect to the uses and functions, but also the access right. In this sense the entity in charge of the platform assumes the commitment to promote actions that advance in the direction of providing access and support to the platform for all citizens alike universally Giving tools and resources appropriate to the platform is available to anyone who wants to use. + +== Data confidentiality + +The confidentiality and privacy of the personal data that people might provide to participate in any of the functionalities and/or possibilities of participation that the platform provides shall be guaranteed at all times. In no case shall personal data be transferred to third parties. Personal data will not be used beyond what is strictly necessary for the purposes of user registration and improvements on the usability of the platform. Whenever platform technology makes it possible, the expression of political preferences or will in decision-making processes shall remain inaccessible even for the administrator of the platform or the server/s that host it. + +== Accountability and responsibility + +A commitment to citizens shall be taken to respond to all queries and contributions in the shortest time possible. A commitment shall also be adopted to follow-up the results of participatory processes and to respond to those demands which specifically request it. Finally, a commitment shall be taken to study the incorporation of indicators to monitor the participation processes once they are finalized, in order to systematically evaluate its implementation. + +== Continuous improvement and inter-institutional collaboration + +Mechanisms for periodic review and evaluation will be provided in order to facilitate the continuous improvement of the platform. + +Priority will be given to the collaboration and the exchange of experiences between the institutions involved in the project, with the aim to improve, fix and build new developments for the continuous improvement of the platform. + +In this sense, collaborative conditions and environments will be facilitated when moving forward improvements that point to a common benefit of the entire platform, enabling inter-agency coordination mechanisms when necessary. \ No newline at end of file From 2bc296c1657ead631151a86ceff95246b6fcf534 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:56:21 +0200 Subject: [PATCH 134/336] New translations decidim-a-brief-overview.adoc (French) --- .../pages/decidim-a-brief-overview.adoc | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 docs/fr/modules/whitepaper/pages/decidim-a-brief-overview.adoc diff --git a/docs/fr/modules/whitepaper/pages/decidim-a-brief-overview.adoc b/docs/fr/modules/whitepaper/pages/decidim-a-brief-overview.adoc new file mode 100644 index 0000000000..886e8bd9f5 --- /dev/null +++ b/docs/fr/modules/whitepaper/pages/decidim-a-brief-overview.adoc @@ -0,0 +1,16 @@ += Decidim: a brief overview +:experimental: +:icons: font +:page-partial: +:source-highlighter: highlightjs + +IMPORTANT: The content of this section is a fragment of Barandiaran, X., Calleja-López, A. & Monterde, A. (2018). Decidim: political and technopolitical +networks for participatory democracy. __Decidim’s project white paper__, pp. 7-26. (You can http://ajbcn-meta-decidim.s3.amazonaws.com/uploads/decidim/attachment/file/2005/White_Paper.pdf[download an alpha version of the document here]) + +*We have been busy building Decidim, it is now time to explain it*. The goal of this white paperfootnote:[A white paper is document that expresses the principles, vision, technical details and insights of a project with the goal of explaining, detailedly and contextually, its value, to help others understand, join and support the project.] is to explain in detail the nature of the Decidim project. The paper comes to fill a long lasting gap and outlines what the project is really about, why it is relevant, and how we (the Metadecidim community) have made it possible and developed it so far. It presents the Decidim platform, its features and design principles, but also other dimensions of the project, from the political to the technical. It also outlines the theoretical and political vision, as well as the practical and organizational work behind the project. This document also situates Decidim in a historical context defined by political struggle. Furthermore, it discusses some of the sociopolitical problems it tries to address and the possibilities it opens up looking forward. Authorship of this document entails not more, not less, than putting together, making explicit and elaborating a set of theoretical and practical principles and guidelines that have been developed by a multitude of participants in our community. + +*How to read this white paper and make it yours*. Readers might be interested on different dimensions of the project and we encourage you to find the chapter or section that best matches your interests. The introduction however is worth reading for any of you. We start with a brief explanation of what is Decidim, a definition of the project, how the platform works, the social contract that binds the project together, a description of the community and ecosystem behind it, the model of democracy that it embodies and the three dimensions of the project: the political, the technopolitical and the technical. We next move into the context in which Decidim has been developed to explain why we thought it was necessary to initiate or join this project, why it is relevant today both in the context of a crisis of democracy as we knew it and the context of an increasing control of social digital infraestructures by a few corporations. The rest of the paper is structured along the three planes or dimensions of the project: the political plane explains the model of democracy that Decidim embodies and makes possible, contrasting it with different limitations and models of contemporary democracy (representative democracy and party politics, technocracy and neoliberal models of governance, etc.) highlighting how Decidim makes possible to strengthen new and old forms of participatory democracy, collective intelligence and multitudinous political identities in public institutions and social organizations alike. The technopolitical planefootnote:[In short, by technopolitics we mean the intersection and hybridization of technology and politics. This is a conception of politics that focuses on the technical articulation of power, its structure and exercise, highlighting and intervening on devices, interfaces, codes, protocols, networks and methods in contrast with conceptions of politics that focuses on ideas, discourses, symbols and reasons. It is a conception of technology that focuses on its political dimensions, its mutability and its construction, highlighting and intervening in the power relationships, ideologies and logics in contrasts to views that understand it as value neutral and objective matters.] explains how this is made possible through the platform, its design principles, best configuration practices and the technological articulation of the project’s internal politics through the platform: the Metadecidim community. Finally, we extend into the details of the technical articulation of the project: how the software is produced, its architectural details, organizing protocols, legal licenses, collaborative practices, training programs, etc. + +include::what-is-decidim.adoc[leveloffset=+1] + +include::why-decidim.adoc[leveloffset=+1] \ No newline at end of file From e1ade0bdb7e8ed0bc5b360079bdc775c6f217e0a Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:56:23 +0200 Subject: [PATCH 135/336] New translations what-is-decidim.adoc (French) --- .../whitepaper/pages/what-is-decidim.adoc | 51 +++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 docs/fr/modules/whitepaper/pages/what-is-decidim.adoc diff --git a/docs/fr/modules/whitepaper/pages/what-is-decidim.adoc b/docs/fr/modules/whitepaper/pages/what-is-decidim.adoc new file mode 100644 index 0000000000..e6c4a8d64a --- /dev/null +++ b/docs/fr/modules/whitepaper/pages/what-is-decidim.adoc @@ -0,0 +1,51 @@ += What is Decidim? +:experimental: +:icons: font +:page-partial: +:source-highlighter: highlightjs + +.Video: https://youtu.be/f6JMgJAQ2tc[Decidim: Free Open-Source participatory democracy for cities and organizations]. +video::f6JMgJAQ2tc[youtube, width=720, height=390] + +Decidim [http://decidim.org[http://decidim.org]], from the Catalan "let's decide" or “we decide”, is a digital platform for participatory democracy. +More specifically, Decidim is a web environment (a _framework_) produced in _Ruby on Rails_ (a programming language) that allows anybody to create and configure a website to be used in the form of a political network for democratic participation. It is built entirely and collaboratively as https://en.wikipedia.org/wiki/Free_software[free software]. + +The platform allows any organization (local city council, association, university, NGO, neighbourhood or cooperative) to create mass processes for strategic planning, participatory budgeting, public consultation, collaborative design, etc. It also makes possible to connect traditional in-person democratic meetings with the digital world: sending meeting invites, managing registrations, facilitating the publication of minutes, etc. +In addition, Decidim enables the structuring of government bodies or assemblies (councils, boards, working groups), the convening of consultations, referendums or channelling citizen or member initiatives to trigger different decision-making processes. Yet, the Decidim project is much more than that. + +*Definition*: _Decidim is a public-common’s, free and open, digital infrastructure for participatory democracy_. + +- By “participatory democracy” we mean that form of “government of the people, for the people and by the people” in which people take part as equals or peers (from latin _pars_, part, and _capere_, to take). By taking part we mean that, under the current political model, people take the part _of_ the sovereign power that belongs to them. And this should be an equal part for each. Moreover, we also mean, under an alternative model, to take part _in_ the autonomy of the social and political life, in the construction of collective potency: the capacity to coordinate and commit to collective action. +- The term “digital infrastructure” makes reference to a set of tools, resources, data-sets, documents, codes (legal, computer, etc.), interfaces and services that are digitalized or made accessible by digital means. This infrastructure is primarily a software platform for participatory democracy. ++ + Participants can create proposals, sign and support them, comment, receive notifications, attend public meetings or receive the minutes of the session. Administrators can design participatory processes, define the structure of democratic organs (like councils or committees), configure types of initiatives or set up consultations. The infrastructure also includes documentation, design (icons, images, logos, etc.), legal documents, datasets or training resources, among others. All these make possible to deploy a participatory democratic system in any organization (be it a municipality, a cooperative, an association, a union or a community). +- By “free and open” we mean that the project’s goods (the assets of the infrastructure) do no fall under the form of private property that excludes others from accessing, using, copying, modifying and re-publishing or reusing these resources but, instead, displays all the legal, technical and social means necessary to share them and open them to collaboration. +- Finally, the term “public-commons” indicates that the project is mostly financed and made possible by public institutions and is managed and designed by an open community constituted by public-servants, members of different associations, university researchers and students, activists and staff from foundations, workers from different companies or simply volunteers that commit to the principles of the project. For this infrastructure to be a common’s it is important that these partners organize democratically in relation to the project. In this sense, Decidim is a reflexive infrastructure that uses the very infrastructure to democratize itself through the MetaDecidim community. + +*Platform features and functional architecture*. Since the digital platform displays and embodies both the means of project organization and its democratic principles, it is important to explain how the platform works. Users of the platform (participants) interact through participatory mechanisms known as _components_ within different participatory _spaces_ that channel their democratic power to specific results. Participatory spaces are the frameworks that define how participation will be carried out, the _channels_ or means through which citizens or members of an organization can process requests or coordinate proposals and make decisions. _Initiatives_, _Processes_, _Assemblies_ and _Consultations_ are all participatory spaces. Specific examples of each of these include: a citizen initiative for directly changing a regulation (_Initiative_); a general assembly or workers’ council (_Assembly_); a participatory budgeting, strategic planning, or electoral process (_Processes_); a referendum or call to vote “Yes” or “No” to change the name of an organization (_Consultation_). The more notable components that are combined into spaces to deliver participatory mechanisms include in-person _meetings_, _proposals_, _blogs, debates, static information pages, surveys_, _results_ and _comments_. So, for example, the various phases of a participatory budgeting process (where members of an organization are called to decide how to spend a budget) can combine components in the following way: at an early phase, public meetings can be opened for citizens to analyze different needs classified by districts. In turn these meetings can lead to the design of a survey. The survey results can next be used to define a set of categories for projects to be proposed. The proposal component might then be activated for participants to create and publish their projects as solutions to the identified needs. These proposals can be commented on. After a period of deliberation, the voting component can be activated to select among the projects using a budget-expenditure system. Participants can then be called to a public meeting to evaluate the results and an assessment survey can then be launched for those who could not attend the meeting. Finally, the accountability component can be activated to monitor the degree of execution of the selected projects and people can comment on it. This is but one example of how components are combined in a space, but there are many other combinatorial possibilities. What makes Decidim particularly powerful is this combination of components within spaces, which provides an organization with a complete toolkit to easily design and deploy a democratic system adapted to its needs. + +*The social contract*: All members and partners of the Decidim project must endorse and follow a “https://decidim.org/contract[social contract]” that defines a set of guiding principles. The social contract can be summarized as follows: 1. _Free software and open content_: Decidim will always remain free and open to collaboration, without legal or technical obstacles for the use, copy and modification. To ensure this we use a set of licenses: https://www.gnu.org/licenses/agpl-3.0.html[Affero GPLv3] for the code, https://creativecommons.org/licenses/by-sa/4.0/[CreativeCommons By-SA] for the content (text, images, design, etc.) and https://opendatacommons.org/licenses/odbl/1-0/[Open Access Database License] for data. This means that Decidim will always remain auditable, collaborable, transparent, appropriable and trustworthy, all of which is fundamental for a democratic infrastructure. 2. _Transparency, traceability and integrity_: the content of participation will always remain transparent, traceable and integral. This means that all the content must be accessible and downloadable, it should always be known what happens with each proposal, its origin, where it was incorporated or why it was rejected, and the content needs to be displayed without been manipulated, any modification (if required) must be registered and be accessible and auditable. 3. _Equal opportunities, democratic quality and inclusiveness_: the platform must guarantee the democratic quality, the non-discrimination and equal opportunities for each participant and proposals, including objective indicators. The platform must comply with accessibility standards, its use must favour the integration of online and offline participation and organizations must deploy the means for mediation and training of participants. 4. _Privacy with verification_: participants must retain privacy of their personal data combined with verification. Personal data should never be displayed, nor sold or transferred to third parties while, at the same time, the unicity and democratic rights of participants must be preserved (meaning there cannot be two verified users corresponding to the same individual with democratic rights and all participants with such rights must be verifiable). 5. _Democratic commitment, responsibility and collaboration_: institutions using Decidim must commit to respond on time, be accountable for decisions taken through the platform, and to openly collaborate on its improvement. + +*Instances*. The best known and intensively used instance of Decidim, as a digital platform for participatory democracy, is https://decidim.barcelona[www.decidim.barcelona], with (as of December 2018) more than 30,000 registered participants, more than 1.5 million page views, over 300,000 visitors, 35 participatory processes, 1,141 public meetings channelled through the platform and 13,297 proposals, out of which over 9,196 have already become public policies grouped into 5,485 results whose implementation level can be monitored by citizens. The instance that actively explores more functionalities is http://meta.decidim.org[meta.decidim.org], the community portal that designs and supports the project. There is also a demo site with the latest version available for exploration and a training instance open to anybody to learn how to configure, administrate and use the platform. There are currently more than 70 instances of Decidim for organizations of different sorts ranging from municipalities such as https://osallistu.hel.fi/[Helsinki] or https://erabaki.pamplona.es/[Pamplona], to regional governments like the https://participa.castillalamancha.es/[Junta de Castilla la Mancha] or the https://participa.gencat.cat/[Generalitat de Catalunya], national governments like the https://monopinion.belgium.be[Belgium Federal State], NGO networks such as https://assembly.fundaction.eu[Fundaction] or https://participa.quorumglobal.org/[QuorumGlobal], cooperatives like https://participa.somenergia.coop/[Som Energia], or the https://participons.debatpublic.fr/[National Commission for Public Debate] (_Commission Nationale du Débat Public_) in France. We have an https://decidim-monitor.herokuapp.com[online monitoring tool] that captures the relevant public data of known Decidim instances around the world. + +*A sustainable ecosystem*. Developed at Barcelona’s http://ajuntament.barcelona.cat/innovaciodemocratica/en[Laboratory for Democratic Innovation], Decidim is the result of the joint effort of a network of collaborating entities and multiple participants leaded by Barcelona’s City Council. Apart from the organizations that use the platform and whose participants and administrators report bugs and suggest improvements, there is a network of 17 different collaborating entities, from software companies to institutional consortia, from research institutions to civil associations. The https://meta.decidim.barcelona/[Metadecidim] community uses an instance of the Decidim platform to organize the different dimensions of the project. As of August 7th 2018 it has 379 registered participants, it hosts minutes of 126 public meetings, details of eight assemblies or working groups, four participatory processes (welcome process, bug reporting, feature proposals, and training workshop process) together with various initiatives and two consultations aimed at defining the roadmap and software design of the platform, bug reporting, community and project governance, research and development. Official documentation and code are developed on https://github.com/decidim[Github] where the project hosts more than 20 repositories with over 50 contributors. They all together generate a sustainable ecosystem that governs, produces and provides services over the platform (deployment, adaptation, configuration, training, consultancy, administration, etc.). + +*Democracy and social empowerment*: Decidim was born in an institutional environment (that of Barcelona City Council during Ada Colau’s mandate 2015-2019 and under the impulse of Gala Pin councillor for participatory democracy), directly aiming at improving and enhancing the political and administrative impact of participatory democracy in the state (municipalities, local governments, etc.). But it also aims at empowering social processes as _a platform for massive social coordination for collective action_ independently of public administrations. Anybody can copy, modify and install Decidim for its own needs, so Decidim is by no means reduced to public institutions. There are different ways in which participatory democracy infrastructures can boost social, economic and political self-organization. Decidim is starting to be used for these purposes: for the internal organization of consumer and producer cooperatives for example, it is also helping movements organize and to design strategic planning, and it might soon be used to coordinate massive strikes or other forms of social action. The modular nature of its architecture is also enabling these organizations to develop their own components and improvements (such as crowdfunding, membership management, etc.) and to plug them back into Decidim, expanding its potential. Decidim comes to fill the gap of public and common’s platforms, providing an alternative to the way in which private platforms coordinate social action (mostly with profit-driven, data extraction and market-oriented goals). Ultimately, Decidim aims to present an alternative to the existing model of digital economy sponsored by corporate digital platforms (Amazon, AirBnB, Uber, etc). + +*The political, the technical and the technopolitical*. As we have repeatedly stressed, Decidim is more than a technological platform. It has required to assemble a variety of codes, realities and dimensions that go beyond programming code. We define it as a “technopolitical project” where legal, political, institutional, practical, social, educational, communicative, economic and epistemic codes merge together. Ultimately, Decidim is in itself a sort of crossroad of the various dimensions of networked democracy and society, a detailed practical map of their complexities and conflicts. We distinguish three general planes or dimensions of the project: the _political_ (focused on the democratic model that Decidim promotes and its impact on public policies and organizations), the _technopolitical_ (focused on how the platform is designed, the mechanisms it embodies, and the way in which it is itself democratically designed), and the _technical_ (focused on the conditions of production, operation and success of the project: the digital factory, collaborative mechanisms, licenses, etc.). The political plane is best illustrated by the use of Decidim in a city or organization, the type of democratic processes and decisions that are made through it. In other words, it covers what kind of politics can be done using Decidim: what kind of governance, conflict and power relationships can be channelled through it, thus, the kind of democracy it is capable to produce. Its model instance is decidim.barcelona, what happens within, how it alters the political space of the city. The second plane, the technopolitical, includes matters concerning the digital architectural design of Decidim: its interfaces, features, design principles, data policies, user experience, etc. It is a primarily a reflexive space of how technologies structure political processes. It is embodied in the Metadecidim platform and the community that surrounds it. Finally, the technical plane encompasses issues concerning primarily the programming and legal codes (information and legal infrastructures), but is also includes issues of education and knowledge (epistemic infrastructures), spatial and working organization. All three dimensions are part of the project. + +.Systematization footnote:[We have chosen Barcelona here as a scale of reference, but it could be the EU, or any other political territory or democratic organization. The term “scale” does not refer here to territorial extension, but to the number of agents and organizational complexity: the political involves more complexity, more agents, more conflict, more diversity and width of decision to be made, the technopolitical is a smaller community scale, the technical is a laboratory or factory that covers a subset of this community.] of various aspects of the Decidim project in the political, technopolitical and technical planes with the city of Barcelona as a reference. +[cols="\"", ,, ,", options="header"] +|=== +|Plane +|Relation +|Platform +|Mode +|Scale + +|Political |Superstructure |decidim.barcelona |Co-decision |City + +|Technopolitical |Structure |Metadecidim |Co-design |Community + +|Technical |Infrastructure |github.com/decidim |Co-production |Laboratory +|=== \ No newline at end of file From 03f6a81117ff40a04ce2b669872a2f34318e1308 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 16 Aug 2023 09:56:24 +0200 Subject: [PATCH 136/336] New translations why-decidim.adoc (French) --- .../modules/whitepaper/pages/why-decidim.adoc | 55 +++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 docs/fr/modules/whitepaper/pages/why-decidim.adoc diff --git a/docs/fr/modules/whitepaper/pages/why-decidim.adoc b/docs/fr/modules/whitepaper/pages/why-decidim.adoc new file mode 100644 index 0000000000..97722615c2 --- /dev/null +++ b/docs/fr/modules/whitepaper/pages/why-decidim.adoc @@ -0,0 +1,55 @@ += Why Decidim? + +:experimental: +:icons: font +:page-partial: +:source-highlighter: highlightjs + +The context that has given birth to Decidim is defined by two interconnected phenomena, each of which displays two poles. On the one hand, the last decades have witnessed a crisis of representative democracy (weakening of the Welfare State, subordination to market forces, inability to deal with global problems such as climate change, etc.) as well as the essay with some alternatives, such as grassroots organizations, new parties and institutional forms. On the other, the rise of cognitive capitalism, a system where the exploitation of information, knowledge, affects, and social relations has become core to the generation of economic value, is opposed by the emergence of free software, knowledge and culture. Both phenomena are deeply intertwined, and Decidim is born right at their very intersection, responding to the challenges and opportunities that they open for democracy. In this section, we briefly analyze these two phenomena, with a special focus on the way they impact contemporary democracy. + +== The contemporary crisis of democracy and its alternatives + +*Success and decline of liberal, representative democracies*. The basic structures of representative democracy have barely been updated in the last two centuries. The last three decades have seen both their success (with the multiplication of liberal democratic states all over the world) and their declinefootnote:[The decline has been ongoing for the last two decades, at least (Rosanvallon, 2008), and has been noticed across the “ideological and methodological spectrum” (Tormey 2015: 15). So much so that the crisis of liberal representative democracy has been identified with the crisis of democracy itself (Keane 2009; DellaPorta 2013). Different authors have denounced the technocratic tendencies and the neoliberal hegemony in this same period as heralding a stage of post-democracy (Crouch, 2004) or post-politics (Zizek, 1999; Rancière, 2001), while others, in a more limited way, have used the term "post-representation" to refer to the emptying of power and meaning of representative institutions by dynamics ranging from globalization and the dismantling of the welfare state to dis-affection and dis-empowerment (Brito Vieira and Runciman, 2008; Keane, 2009; Rosanvallon, 2011; Tormey, 2015). The meanings of “post-representation” are multiple, though, connected with different political readings of the crisis and the potential ways out of it, from those that give conjunctural interpretations to those that tie it to the transformations of modernity, its subjectivities and modes of sociality (Tormey, 2015).] (as diagnosed in a wide literature ranging from Pharr & Putnam, 1999 to Tormey, 2015). The decline has been expressed in various forms; we will mention two: practically, in the inability of contemporary democracies to deal with problems such as rising inequality (Piketty, 2014) or climate change (Klein, 2015); politically, in the decline of participation and trust in political parties and political representatives, as well as other political institutions (Mair, 2006; Castells, 2017). + +*Structural limits of representative democracy*: the triple challenge of complexity.footnote:[This section is a theoretical reconstruction of aspects that are historically embedded and power-laden.] The structure of modern democracies is based on representation (and, more specifically, electoral representation, Manin 1997, Van Reybrouck 2016), that is, on a series of mechanisms by which a few actors (political and administrative) are elected to manage public issues in the name of the whole of the citizenry, and are in principle accountable to it. Representation had its roots in medieval institutions, as a mechanism for nobles and knights to push their demands in exchange for consenting taxation (Pitkin, 1967). But it has proven its limits in coping with complexity and conflict: the complexity and conflictuality of society, of reality, and of organization. + +1. In social terms, it had to face the growth of the franchise, incorporating an ever more diverse constituency, and, in the last decades of the XXth century, the rise in cultural diversity, consumerism and the ideology of consumer choice in Western democracies (Laclau & Mouffe, 1985; Sennett, 1977, 1998) that generated an ever-growing variety of desires and perspectives to be listened to and articulated in government action. Furthermore, representation has proven open to systemic practices of nepotism or corruption, usually by powerful economic interests (Buchanan & Tullock, 1962; Peltzmann, 1976). In this context, representative mechanisms have ended up imposing the will of the few over the complex and conflictual wills of the people in public policy. +1. The second key challenge of complexity had to do with the reality. As the technoscientific transformation of reality accelerated, the responsibility and complexity of the problems facing public policy (f.i.: climate change) has only increased; and yet many of the systems for detecting social problems and mobilizing social knowledge to address them have remained oligarchic. The attack Friedrich Hayek (1944, 1945) launched on socialist planning can be launched against representative democracy too: reality is too complex for a centralized decision-making system. +1. The third challenge of complexity fed back into the previous two: it is the challenge (or meta-challenge) of communication and organization. Mobilizing and organizing the will, the knowledge, and the collective action of society into public policy faced numerous socio-technological limits: the millions of members composing a given social group could not express their will nor contribute their knowledge and effort to address their matters of concernfootnote:[Organization or knowledge may be insufficient to solve the problems facing democracy today. However, we there are reasons to believe they can contribute to do so.]. Still in the XXth century, the infrastructure required to bring an expression of will or knowledge of people distributed geographically or socioeconomically (f.i.: laborally) into a common problem or decision seemed out of reach. Even if they wanted, people could not gather in assemblies or other political processes: people were too many, lived far from each other, had their work schedules, and no free time at all. + +Representative democracy, where the many elect a few every four years, became a raw and oversimplified articulation of the will and knowledge of the many, in terms of the management by the few. So raw and simplified that it couldn’t solve the problems of society and became one of them: the people’s will was not represented or properly constructed but captured, the real problems were not solved by public representatives, but externalized to the market to be solved, and the problems generated by the market too often remained unsolved. + +*Social limits of representative democracy: the challenge of economic powers and the rise of neoliberalism*. The problems of representative democracy today are not of complexity only, though. They have as much to do with issues of social power. Many of the ailments of representative democracy in the last three decades can be rooted in three key shifts of power (DellaPorta, 2013: 23; Offe, 2011: 457): a shift of power from parties and parliaments to executive powers, reducing the meaning of parliamentary and party politics; from State to Market, with processes ranging from externalization and privatization of public services to the introduction of competition logics in public administration ( the process of “emptying out the State”, specially, the Welfare State, Rhodes, 1994), as well as the rise in power of global corporations; and from nation-states to international governmental organizations such as the EU, the IMF or the World Bank, frequently aligned with such corporations, emptying both States and democracies of much of their legitimacy and power (Laval & Dardot, 2017; Crouch, 2011; Sánchez Cuenca, 2014). Political parties have suffered particularly: from the mid XIXth to the mid XXth century, the mass party model was guided by clear programs and rooted in a thick social structure connected to grassroots spaces and organizations, unions, media, and so on. The catch all party model rising in the 80s, however, had pragmatic, variable programs and supported itself primarily in mass media (in particular, tv) and polls. A fragmentation of socioeconomic composition and the discourses around it, no more easily divisible into “capitalist and proletarians” (Laclau & Mouffe, 1985), as well as the rise of a mass-mediatized consumer society based on an exaggerated and depoliticising individualism (Sennett 1977, 1998) paved the way for such party transformations. The traditional mass party saw a steady decline of its grassroots in Western democracies until today. This emptying out of representative democracy was tied to the rise of neoliberalism[multiblock footnote omitted], and has brought a crisis of legitimacy and meaning of democracy itself, frequently identified with representation (Crouch, 2004; Streeck, 2016). The Great Regression of 2008 (Eichengreen & O’Rourke, 2009) and the austerity politics that followed it (Blyth, 2013) seemed to confirm this shift and its implications, with States first going into debt to save the financial sector and then applying (or being applied) austerity policies without or against citizen consultation, guaranteeing the sustenance of capital accumulation while losing more and more capacity for social provision (Jessop, 2015). + +*The alter-globalization challenge to the shift of power away from democracy*. These processes haven’t gone unchallenged. The last two decades have been a period of democratic movements of resistance. At the turn of the century, the alter-globalization movement called for an alternative to the rising neoliberal globalization, an alternative globalization tied to a radicalization of democracy, social justice, human rights, as well as economical and ecological sustainability (Klein, 1999; Stiglitz, 2002; DellaPorta & Tarrow, 2005). This “movement of movements” had socio-technical networks as a key part of its organization. It generated a “cultural politics of networking” where networks operated not only as technologies, but also as models for the definition of social norms and political forms (Juris, 2008): features such as free association and information, non-hierarchical and flexible organizations, globally distributed but synchronized, locally rooted action, or autonomous networked media were among its key features. + +*The crisis of legitimacy of the neoliberal-democracy narrative*. Beyond the work of these movements, it was the 2008 Great Regression what brought about a crisis of legitimacy of the neoliberal narrative. It opened a period of crisis of neoliberalism (Dumezil & Lévy, 2011), not so much in economics but, specially, in political and social terms (in economic terms the crisis lasted less, followed by a deepening of accumulation processes, Jessop, 2015): the discredit of narratives praising free trade, privatization, international economic institutions, and global markets, otherwise, the discredit of the ideological practice preeminent since the 80s, spread along with new social and political movements, from the progressive to the reactionary. This crisis of neoliberalism fed into the crisis of representation mentioned earlier, with a peak of distrust towards official institutions, from politicians and governments to banks. The result has been a crisis of the existing model of neoliberal representative democracy (Castells, 2012, 2017; DellaPorta, 2013; Gerbaudo, 2012, 2017). + +*The 2011 wave of networked movements of the squares*. 2011 is a key year in political terms. Progressive social movements swept the world, from the Arab Springs in the North of Africa to Occupy Wall Street in North America: they challenged the political and economic status quo and the rising inequality, while reclaiming a more radical democracy (Postill, 2017; Gerbaudo, 2012; DellaPorta, 2013, Flesher Fominaya, 2014). The 15M movement was among the key referents of this wave of networked movements of the squares, which intensively used digital networks. In Spain, 15M was at the upshot of a cycle of contention that saw the emergence of new forms of collective organization (from the networked squares of 2011 to the direct action tactics of the Platform of People Affected by Mortgages Romanos, 2014), new political parties (from Podemos to Barcelona en Comú), and the victories in dozens of cities by citizen initiatives in the Spring of 2015 (Cádiz, Barcelona, Madrid, A Coruña, etc.) (Feenstra et. al, 2017; Calleja-López & Toret, 2019). The use of digital platforms were crucial in all of these undertakings, oriented to increase the depth of participation of anyone and everyone into the political field (Aragón et al., 2017; Calleja-López, 2017; Monterde, 2016; Toret et al., 2015). Digital networks seemed to provide spaces where the disaggregating forces of neoliberal society were partially and temporarily countered and redirected to nurture collective action both online and offline. The upward extractivism of global finance and corporations was answered with democratic, locally rooted and globally connected initiatives. In the case of Spain, the struggle around the city, from the squares of 2011 to city halls in 2015, has become ever more relevant in this trajectory, in the form of municipalism (Rubio-Pueyo, 2017; Junqué & Shea, 2018; Roth, Monterde & Calleja-López, 2019). + +*The rise of right-wing populism*. But these achievements have showed limits and perils, too. At the international scale, the wave of movements tended to fizzle out. In countries such as Spain and Tunisia, the movements left new parties or constitutions, even though the general political and economic landscape remained gloomy (Castells, 2017); countries such as the US or Egypt (or Spain itself), has seen the advent of increasingly authoritarian governments. Moreover, right wing movements spread across Europe and North America (Castells, 2017). The final result has been defined as the end of the neoliberal era and the advent of a populist moment (Gerbaudo, 2017; Rodrik 2017), in which the basis of the _status quo_ loses its compelling power and is challenged by actors invoking the common people, from left and right, with recent successes for the latter such as the rise of Donald Trump to the presidency of the US or the Brexit. The various negative effects of neoliberalism, particularly accelerated after the Great Regression, such as increasing inequality, the normalized connivance between economic and political power, the dismantling of welfare structures along with rising public debt, social and political disempowerment in the face of transnational corporate and financial powers, the eclipse of the public sphere resulting from phenomena such as a rising individualism or closed multiculturalism (Sennet 1977, 1998), have generated a suspicion towards the status quo in which right wing and nationalist positions are gaining ground. In many cases, such rise was facilitated by social networks such as Facebook and Twitter, used by corporations (such as Cambridge Analytica), or political actors (such as the Trump or the Brexit communication teams). We analyze the various edges of this phenomenon in the following chapter. Resuming, in the political plane, the last decades have witnessed the tension between processes showing the limits or undermining democracy and others trying either to stop such undermining, or even calling to radicalize democracy. Decidim is firmly rooted in this last trend. + +== The rise of the network society, cognitive capitalism and knowledge commons + +*First generation digital networks: informational networks.* A similar opposition between conservative tendencies and progressive ones can be found on the moving field of the so-called digital economy. The 90s saw the rise of the Internet and the WWW to the status of phenomena of global proportions. The initial hopes for the cyberspace envisioned by figures such as John Perry Barlow (in this Declaration of Independence of Cyberspace) anticipated a time where many of the old social structures would be superseded by a new dawn of human creativity and freedom from old governments and social constraints (bodies, sexes, races, etc.). Since its origin, the construction of the internet resulted from the conflicting interests, visions, and practices of various actors (Abate, 1999; Rasmussen, 2007), specially, military and research actors. The idea of a distributed (and thereby resilient) information network was tied to the threat of possible high scale attacks to information centers by the Soviet Union (Baran, 1964), but even more so to practices and narratives of information and knowledge circulation and freedom among university researchers (Leiner et al., 1997). Already in the 1990s, a first generation of worldwide digital networks, informational networks, paradigmatically exemplified by the World Wide Web, allowed free the flow of information and users between websites. + +*Old and new communication powers: from mass communication to mass self-communication.* This seemed to be the dawn of a “networked public sphere” (Benkler, 2006), where earlier mediators of social communication receded from view. The XXth century protagonism of capital-intensive media such as radio, newspapers or TV, with their olygocratic editorial teams, seemed to give way to an explosion of uncensored digital media such as websites and blogs. Social communication was said to be in its way to de-intermediation, its power to be more equally distributed (Rushkoff, 2002; S Republic of Letters in XVIIth and XVIIIth centuries), had been shaken in the XIXth and XXth centuries by technologies that afforded one-to-many circulation of informhirky, 2009). Early modern communication ecologies, based in one-to-one interactions, either face to face or via letters (which still generated complex systems such as theation such as newspapers, radio or TV: this was the model of broadcasting, which potentiated a centralization of social communication, mass communication, where a the majority of the public played a passive role. The Internet and social media afforded new versions of these earlier communication models, and combined it with a new model, that of many-to-many communication, in which many emissors were able to generate (and react to) messages reaching many others, without having to pass through any mediating center (Kellner, 1999). This was giving way to “mass self-communication” , a model in which mass communication is “self-directed in the elaboration and sending of the message, self-selected in the reception of the message, and self-defined in terms of the formation of the communication space” (Castells, 2009). This did not imply an equal redistribution of communication power in society but rather its re-structuration, with new actors, including networked social movements, having an opportunity to play a role in a media sphere earlier controlled by big corporations. The fourth power of mass media journalism gave way to a fifth power: digital networks (or perhaps to a complex, more decentralized form of the fourth, a “hybrid media system”, Chadwick, 2008). + +*The rise of informational and cognitive capitalism.* The Internet and digital networks did not only affect the public sphere in a potentially democratizing tendency, they also greatly contributed to push globalization forward as a historical process, beginning with the acceleration of global finance (Castells, 1996). At the core of the economy behind neoliberal globalization were information and other immaterial assets, such as knowledge, affects, human relations, etc. The result was a new form of capitalism: informational and cognitive capitalism (Castells, 1996; Fumagalli, 2007; Moulier-Boutang, 2007; Vercellone, 2006). Differently from industrial capitalism, where the transformation of material resources into commodities was at the core of the process of capital accumulation, now it was information, knowledge, affects, and social relations what became key in the generation of economic value. Intellectual property is a key legal mechanism under this new paradigm, used to privately appropriate social knowledge and natural information, e.g.: strong copyrights on books and music, patents on technoscientific innovations, traditional medicines and techniques, or animal and plants DNA (Fumagalli, 2007). This in spite of the fact that information and knowledge are non-rival goods, with zero marginal cost, meaning that they can be reproduced and used without depletion. Furthermore, in most cases their value increases with use: the bigger the spread of trademark the higher its value, the more a song is listened to the higher its value. While digital networks provide the means to freely reproduce and re-distribute this kind of goods, artificial scarcity is generated via legal and technological mechanisms. This appropriation has not only the form of a “theft”, but is rather based on structures and processes (from education to entrepreneurship policies) that orient, transform and produce new personal and collective practices, desires, affects and relations sustaining the neoliberal system (Laval & Dardot, 2014). + +*From cognitive capitalism to platform & surveillance capitalism*. In time, the digital element in these processes has only gained prominence. The so called web 1.0 (O’Reilly, 2005) exhibited various limits to users’ interactions with both digital contents and other users. Differently, web 2.0 was all about interaction: the web as a platform. This exponentially increased the quantity and quality of information that could be extracted. By the late 2000s the emancipatory hopes tied to social networks were heavily in dispute (Morozov, 2011), and by the late 2010s the situation seems to be rather the opposite of the anticipated. From Amazon to Tinder, technological platforms are a way for a few corporations to extract data (going from activity, to opinions, to metadata), while leaving users with a little a say on what is gathered, how it is used or how the resulting benefits are distributed; this institutes a regime of “data extractivism” (as suggested by Evgeny Morozov). These corporations have access to more details of the lives of millions of people than any State or corporation to date. Combined with the development of new techniques of big data analysis and the always increasing rate of computing power, the infrastructural conditions were there for a socioeconomic mutation. Corporations such as Google or Facebook were heralding a specific form of informational and cognitive capitalism, which has been variously qualified as “platform”, “data” or “surveillance” capitalism. These three names speak of three connected elements: digital infrastructures, data, and social control. Digital platforms have become the basic means of production and management of a valuable resource (data) out of its source, human activities (Srnicek, 2017). Data, considered as the new “oil” (The Economist, 2017), “infrastructure” (Kawalek & Bayat, 2017; Prospect, 2017), “labor” (Arrieta et al., 2017), etc. is processed using data science methods and business intelligence (from modern statistics to Artificial Intelligence). Then, it is used in various ways in social processes of data-driven politics, science and economics (Lohr, 2015). This process of extraction, processing, and use is radically oligarchic. Corporations such as Alphabet (which includes Google), Microsoft, Amazon or Facebook have earned a monopolistic positionfootnote:[Alphabet, Microsoft (a giant from the early days of cognitive capitalism) and Amazon occupy three of the four top positions of the rankings by market capitalization. Facebook occupies the 8th place, but remains the third most visited web, with Google and Youtube (both owned by Alphabet) being the first and the second, according to Alexa and SimilarWeb, as of March 2018.]. A few actors have become the owners of both platforms and data and can thereby surveil social life in order to experiment with it: surveilling thereby appears as a first step to what we may define as “surwilling”, or willing and shaping the will of others from above; otherwise, platform corporations move from unveiling social life to orienting (or “willing”) it from above. If surveillance intrudes into privacy, into the negative freedom of people (to use Isaiah Berlin’s), into their freedom-from, surwilling shapes their positive freedom, their freedom-for. Platforms crucially influence the information people get about others and about the world, be it from friends, social actors, mass media, advertising corporations or beyond. The result is the emergence of new forms of knowing and influencing the actions of millions of people, a new techno-political power in the hands of States (such as NSA programs), corporations, or political actors (such as the Trump or the Brexit communication teams). This surveillance (Zuboff, 2015) and surwilling capitalism brings ever closer to a Big Brotherhood dystopia. + +*Towards technopolitical heteronomy? From mass self-communication to mass capture.* Social networks such as Facebook or Twitter have grown to user bases in the billions in only a decade. This has turned them into new intermediaries of social communication, if not of social life as such. Mass self-communication has risen hand in hand with mass capture, the capture of masses of data, human actions and interactions. These platforms feed from, and feed on, some dynamics already diagnosed by Guy Débord (1967) around the society of the spectacle, heralding a society of hypervisibility and exhibition tied to capitalism. Exhibition and self-exhibition (from the intimate everyday life to political opinions and actions, passed through a variety of fiction filters), are stimulated and situated at the center of the functioning of these platforms (Crogan & Kinsley, 2012; Goodwin et al., 2016), which are in turn at the center of an economy of attention. Furthermore, in social networks, surveillance and control is not only top-down but also bottom-bottom. There are two axes of surveillance, vertical and horizontal. While the first tends to be unidirectional, the second is frequently (though not always, as platform privacy settings are variable) horizontal and multidirectional: users can and do surveil each other, with playful or predatory (Albrechtslund, 2008; Tokunaga, 2011) purposes. The monopolistic concentration of power around social network corporations becomes daunting: Facebook, for instance, also owns Instagram and Whatsapp. Key rules of social relations are not produced in and decided by processes, actors or conflicts spread in space and time, but rather are increasingly decided and designed by a reduced number of people and specific interests (geostrategic, economic, etcetera). The power of social networks moves from selling advertisement (a concrete type of content) to a deeper shaping of social attention and affects (Grizzioti, 2016), and thereby, behavior. The social anomie resulting from several decades of neoliberalism had given way to a landscape in which the autonomy resulting from new forms of multitudinous self-organization in networked social movements was underlied and exposed to new forms of corporate influence via technologies, that is to say, technopolitical heteronomy. + +*How datacracy is dissolving democracy.* Democracy became exposed to datacracy, namely, to the strategic use of big data and digital platforms to gain and exercise political and cultural power (Cancellato, 2017; Gambetta, 2018). The rise of Barack Obama in 2008 and Donald Trump in 2016 to United States presidency are examples of how social networks and big data operations have a growing impact on electoral processes, affecting the networked public sphere. Trump invested 94 million dollars in expert consultants and Facebook’s paid advertising services (The Guardian, 2017). More importantly, the campaign included numerous examples of political automation: the use of chatbots, posting bots, false profiles and the automated inflation of metrics and followers (Bessi & Ferrara, 2016). These were frequently tied to the diffusion of _fake news_: biased, incomplete or spurious media stories with exaggerated and emotional adjectivation (Graves, 2018). This fed back with the activity in platforms such as 4chan, Omegle, Reddit and Tumblr, where Trump's followers formed an irregular community, self-appointed as _Alt-Right_ (Nagle, 2017a; 2017b), which showed clear manifestations of sexism, xenophobia, islamophobia, anti-feminism, intolerance and white supremacy, openly or in the form of satirical jokes and memes (Mendoza-Denton, 2018, Van-Zuylen Wood et al, 2018; Pollard, 2018). He may also has been supported by Russian espionage and communication experts, who received large financial incentives, showing the geopolitical character of these technopolitical struggles (The Guardian, 2018a). Finally, there was the hiring of London consulting company Cambridge Analytica, which extracted personal data from 87 million Facebook profiles between 2014 and 2016 to analyze their political preferences (De Llano, 2018), using a Facebook application disguised as a “personality test” (Cadwalladr, 2018; The Guardian, 2018b). This is not exceptional, though. Cambridge Analytica intervened in the last presidential campaigns of Argentina, Mexico, Brazil, Sri Lanka, Malaysia, China, Australia and South Africa, as well as the referendum that caused the separation of Britain from the European Union, known as _Brexit_ (The Guardian, 2018b). These cases have drawn public attention to issues such as the vulnerability of online personal data, the power of corporations and States that can access these databases (either legally or illegally) and use these platforms for influencing and shaping public discourse and action (Mottram, 2018; Tufekci, 2018). In words of Facebook's founder and president, Mark Zuckerberg, the platform has no affinity with any political party, and any client can access its services (Price, 2018). However, Facebook algorithms keep working as “black boxes”. Zuckerberg's company has never shared details of its technical operation or data processing software or policies besides the content of Facebook's terms of use, which still remain general, abstract, and non-negotiable. This opacity becomes ever more problematic as the role of platform algorithms, political automation and Artificial Intelligence (including machine and deep learning) systems grow (Trevathan, 2006; Manovich, 2013; Zysman & Kenney, 2015, 2016). Datacracy will pervade more aspects of people’s lives to the extent that the increasing pervasiveness of digital platforms grows and follows the current corporate and technocratic logics. + +*Free software, knowledge, culture, and internet.* However, in continuous struggle and contact with these dynamics there has also been a proliferation of actors, movements, practices and projects oriented by principles such as democracy, freedom, social justice, or commonality. For instance, as an alternative to commercial social networks, also in the second half of the 2000s, there emerged alternative social networks, from Diaspora (with more than one million users) to n-1, a platform widely used during the 15M movement, together with a self-managed network of blogs (wordpress), voice-call rooms (mumble) and collaborative real-time writing pads (etherpad). They followed in the steps of a tradition dating back, at least, to the 1980s and 1990s: the WWW and free software such as the GNU/Linux operating system, have provided free digital services (free as in “freedom” and not only as in “free beer”, as Richard Stallman put itfootnote:[The four basic freedoms are the freedom to run the program for any purpose; to access its source code, study how it works, and change it; to redistribute copies; to distribute copies of modified versions. They can be retrieved at https://www.gnu.org/philosophy/free-sw.en.html[https://www.gnu.org/philosophy/free-sw.en.html].]) to millions of people over world. Furthermore, the GNU license was a legal tool to produce and reproduce such free digital infrastructures. The Creative Commons license expanded its possibilities to cultural works. First, free software licenses and, later (as the principles and practices of free software spread to other fields, Kelty, 2008) creative commons licenses helped to outline an alternative paradigm of collective appropriation of informational and cognitive wealth. Projects such as Wikipedia brought the free software culture into knowledge. This neatly fitted with the discourse of scientific knowledge (Merton, 1942), traditionally self-proclaimed universalism, communalism, and disinterestedness, specially up to the 1980s and landmarks such as the Bay-Dohle Act, that put science into a path of closure, privatization, and corporate interestedness. By putting the classic Encyclopedia Britannica and Microsoft’s Encarta out of business Wikipedia became an example of and alternative “open knowledge” regime, from its production to its appropriation. Softer forms of this regime, such as “open access”, have gained solid ground in time. Under this alternative paradigm, platforms for digital collaboration became key in the collective production of information and knowledge out of the proprietary logics of informational and cognitive capitalism. The broad category of “digital commons” has served to encompass a variety free software, knowledge and culture products. More broadly, the term FLOK (Free/Libre Open Knowledge) includes also non-digital forms of knowledge that generate common practices and democratic communities out of the proprietary form: from education to hardware, from engineering to culture, from biology to software (Villa-Viñas & Barandiaran 2015). More recently, struggles around Net Neutrality (have brought to the front the centrality of the control of concrete aspects of a common such as the Internet (in this case, the discrimination a types of data traffic on the network by service providers and governments) for the flourishing of other basic rights such as freedom of speech or equality in the network societyfootnote:[Various reports and a history of the battle around Net Neutrality can be found at https://www.laquadrature.net/en/Net_neutrality[https://www.laquadrature.net/en/Net_neutrality].]. + +*Hacker culture, digital communities and knowledge commons*. Free/Libre and Open Knowledge does not stand simply as a commodity or a good that is accessible by means of legal and technical devices. It is followed and often preceded by certain forms of social relation, modes of production and the collaborative culture that is necessary to produce and sustain it. The hacker culture, often associated with an ethics of fun, openness and sharing (Himanen, 2003), is even so with concrete practices (Kelty, 2008) and forms of politics (Barandiaran 2003; Maxigas, 2012); crucially, it involves the attitude to transform the way in which artifacts (in its broader sense: from institutions to modems) are given to us in order to open them up to new possibilities: a practical believe on the capacity (both individual and collective) to challenge existing limits and to collaboratively explore how to break, re-assemble and build upon what is available. In doing so communities are created around technical challenges, common infrastructures, collective resources and struggles. In turn, these communities are faced with a myriad of governing problems and these are solved by a combination of recursive tools and democratic/collaborative procedures: from the mechanisms to solve disputes in Wikipedia, to the voting procedures of the Debian community, from Forks (the duplication of the content and resources of a project to create a new one, something that is made possible by the non-proprietary form of knowledge and technologies involved) to version control systems in software development. Added to the unlimited reproductive capacity of digital goods, all this provides the sphere of Free/Libre Open Knowledge with a productive power and collective management capacity that results on a knowledge commons that often parallels that of profit-driven corporations and has been the object of extensive study (Hess & Ostrom, 2007; Benkler, 2006). + +*Decidim in context.* As we have shown, democracies in the network society face the double challenge of the crisis of representative democracy and the rise of platform capitalism. The first phenomenon is tied to neoliberalism (and its periodic crises) as well as to the emergence of progressive and reactionary networked politics. The second phenomenon underlies new social conditions as well as those very forms of networked politics, while it is opposed by commons-oriented forms of production. The following image can help to understand the role of Decidim in this context. + +.Decidim model for a democratic society. +image::decidim-in-context.svg[Image, width=90%] + +Under platform capitalism, corporations extract social data in huge quantities and turn it into wealth and power over people and institutions (this is what, in the image below, we label “algorithmic governance”), challenging democracy as we know it. New forms of distributed platform capitalism (airbnb, uber, deliveroo, etc.) herald forms of capilar exploitation of social wealth. However, non-corporate, collaborative forms of digital production exist, and they make possible to find alternatives. Decidim is one such alternative. It is conceived as a commons’ digital infrastructure for participatory democracy that is publicly supported and democratically designed, using itself for such purpose. The value of Decidim stands out in a context in which democratic collective intelligence faces the challenge of corporate artificial intelligence and datacracy, where the democratic impulse of networked social movements, from alter-globalization to 15M, faces reactions by market, State and right wing forces, and where public and commons’ institutions require democratic innovative infrastructures to overtake market-driven innovation in solving the complex social challenges of our times. Whereas a dominant trend pushes the governing of infrastructures and services to the top-right of the picture, towards increasing privatization and centralization in the hands of big corporations, the socio-technical potential exists to shift this trend towards the bottom-left corner: towards decentralized and public-common’s ecosystems of services, infrastructures and goods. Decidim contributes to this transition by boosting democratic participation into the governing of public bodies, social organization, the cooperative economy as well as the joint circulation among the three. So far, public emphasis has been put into regulating consumer markets, corporate governance and economy as a means to slow down privatizing trends and its negative consequences; meanwhile, corporate interests keep exerting their lobbying influence into the public and state institutions. Instead, Decidim contributes to the strengthening of innovative forms of commons-oriented economy and participatory democracy. The next section deals with “how” this strengthening operates, explaining how Decidim explores the potential of participation at various scales. \ No newline at end of file From 538fb210592c5d37e1cdb6170a5c9390425f1bfe Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Tue, 5 Sep 2023 14:06:15 +0200 Subject: [PATCH 137/336] New translations appearance.adoc (French) --- docs/fr/modules/admin/pages/appearance.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/fr/modules/admin/pages/appearance.adoc b/docs/fr/modules/admin/pages/appearance.adoc index 3b42c76416..17b9109fc0 100644 --- a/docs/fr/modules/admin/pages/appearance.adoc +++ b/docs/fr/modules/admin/pages/appearance.adoc @@ -25,9 +25,9 @@ NOTE: These area legacy settings that will be removed in the next version. https --- -NOTE: This is a legacy setting that will be removed in the next version. There's no PR yet. +NOTE: This is a legacy setting that will be removed in the next version. Il n'y a as de demande de modifications (PR) pour l'instant. -* **Highligted content banner** +* **Bannière de contenu mis en valeur** ** *Show the highlighted content banner* ** *Title* ** *Short description* From f9bee24dc57fb53da6c0c62f646cbf5a3ceeca4a Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 16:29:40 +0200 Subject: [PATCH 138/336] New translations blog.adoc (French) --- docs/fr/modules/admin/pages/components/blog.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/fr/modules/admin/pages/components/blog.adoc b/docs/fr/modules/admin/pages/components/blog.adoc index 78febc841b..95d1c3e8ef 100644 --- a/docs/fr/modules/admin/pages/components/blog.adoc +++ b/docs/fr/modules/admin/pages/components/blog.adoc @@ -1,4 +1,4 @@ -= Blog += Actualités The Blog component allows people to read multiple posts ordered by date. From 45f21e7034b8af4b66702ac8c935b87e2691a8f9 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:38 +0200 Subject: [PATCH 139/336] New translations nav.adoc (French) --- docs/fr/modules/ROOT/nav.adoc | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/fr/modules/ROOT/nav.adoc b/docs/fr/modules/ROOT/nav.adoc index 76396bf14a..61156a22b3 100644 --- a/docs/fr/modules/ROOT/nav.adoc +++ b/docs/fr/modules/ROOT/nav.adoc @@ -1,9 +1,9 @@ -* xref:install:index.adoc[Getting started] -** xref:install:manual.adoc[Manual Installation] +* xref:install:index.adoc[Pour commencer] +** xref:install:manual.adoc[Installation Manuelle] ** xref:install:checklist.adoc[Checklist] -** xref:install:update.adoc[Update] +** xref:install:update.adoc[Mise à jour] * xref:configure:index.adoc[Configure] -** xref:configure:environment_variables.adoc[Environment Variables] +** xref:configure:environment_variables.adoc[Variables d'environnement] ** xref:configure:initializer.adoc[Initializer] *** xref:customize:authorizations.adoc[Authorizations] *** xref:customize:code.adoc[Code] @@ -46,13 +46,13 @@ **** xref:admin:participants/authorizations/code_postal_letter.adoc[Code by postal letter] **** xref:admin:participants/authorizations/census.adoc[Organization's census] ** xref:admin:spaces.adoc[Spaces] -*** xref:admin:spaces/processes.adoc[Participatory Processes] +*** xref:admin:spaces/processes.adoc[Concertations] **** xref:admin:spaces/processes/phases.adoc[Phases] **** xref:admin:spaces/processes/components.adoc[Components] **** xref:admin:spaces/processes/categories.adoc[Categories] **** xref:admin:spaces/processes/attachments.adoc[Attachments] -**** xref:admin:spaces/processes/admins.adoc[Process admins] -**** xref:admin:spaces/processes/private_participants.adoc[Private participants] +**** xref:admin:spaces/processes/admins.adoc[Administrateurs de la concertation] +**** xref:admin:spaces/processes/private_participants.adoc[Utilisateurs privés] **** xref:admin:spaces/processes/moderations.adoc[Moderations] **** xref:admin:spaces/processes/groups.adoc[Process Groups] *** xref:admin:spaces/assemblies.adoc[Assemblies] @@ -163,13 +163,13 @@ *** xref:develop:testing.adoc[Testing] *** xref:develop:guide_development_with_localhost_ssl.adoc[Testing SSL and Tenants in Development] *** xref:develop:turbolinks.adoc[Turbolinks] -*** Views +*** Vues **** xref:develop:content_blocks.adoc[Content Blocks] **** xref:develop:data-picker.adoc[Data Picker] **** xref:develop:newsletter_templates.adoc[Newsletter Templates] **** xref:develop:view_hooks.adoc[View Hooks] **** xref:develop:view_models_aka_cells.adoc[View Models (Cells)] -* Understand +* Comprendre ** xref:understand:about.adoc[About] ** xref:understand:background.adoc[Background] ** xref:features:general-description.adoc[Features] From 4cd6105d8afe5bddd1d5bb36c05dabb08d660f5a Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:39 +0200 Subject: [PATCH 140/336] New translations blog.adoc (French) --- .../modules/admin/pages/components/blog.adoc | 106 +++++++++--------- 1 file changed, 53 insertions(+), 53 deletions(-) diff --git a/docs/fr/modules/admin/pages/components/blog.adoc b/docs/fr/modules/admin/pages/components/blog.adoc index 95d1c3e8ef..13a8855a7b 100644 --- a/docs/fr/modules/admin/pages/components/blog.adoc +++ b/docs/fr/modules/admin/pages/components/blog.adoc @@ -13,48 +13,48 @@ To configure the Blog component: . Sign in as admin . Go to admin panel -. In the main sidebar, click in the button for the space that you want to configure the component for. -For instance, it could be "Processes", "Assemblies" or "Conferences". -. Go to components -. Click on "Add component" button -. Click on "Blog" -. Fill the xref:_add_component[Add component] form +. Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. +Par exemple, il peut s'agir de "Concertations", d'"Assemblées" ou de "Conférences". +. Aller dans les fonctionnalités +. Cliquez sur le bouton "Ajouter une fonctionnalité" +. Cliquez sur "Actualités" +. Remplissez le formulaire xref:_add_component[Ajouter une fonctionnalité] -== Add component +== Ajouter une fonctionnalité -image:components/blog/component.png[Add component form] +image:components/debates/component.png[Formulaire d'ajout de fonctionnalité] -.Add component: Blog form +.Ajouter une fonctionnalité : Formulaire d'Actualités |=== -|Field |Type |Description +|Champ |Type |Description -|Name -|Required -|What is the title of this component. For instance, "Blogs" +|Nom +|Obligatoire +|Quel est le titre de cette fonctionnalité. Par exemple, "Actualités" -|Order position -|Optional -|Which order will it have in relation to the other blogs. Having a lower number means a higher priority. -For instance, if you have two blogs, "Blog a" with weight "10" and "Blog b" with weight "0", then "Blog b" will be first when ordering. +|Rang d'affichage +|Facultatif +|Quel ordre aura-t-il par rapport aux autres fonctionnalités Actualités. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. +Par exemple, si vous avez deux fonctionnalités Actualités, "Actualités A" avec le rang "10" et "Actualités B" avec le rang "0", alors "Actualités B" sera la première fonctionnalité affichée. |=== .Add component: Blog form - Global settings |=== -|Field |Type |Description +|Champ |Type |Description -|Announcement -|Optional -|A general announcement that'll be visible on the general blogs landing page. +|Annonce +|Facultatif +|Une annonce générale qui sera visible sur la page générale des actualités. -|Comments enabled -|Optional -|Whether you want to have comments in the meetings. +|Commentaires activés +|Facultatif +|Si vous voulez avoir des commentaires dans les rencontres. -|Comments max length -|Optional -|What is the characters limit that participants will have when making comments. Leave 0 for default value. +|Longueur maximale des commentaires +|Facultatif +|Quelle est la limite de caractères que les participants auront quand ils feront des commentaires. Laisser 0 pour la valeur par défaut. |=== In the cases where the space that this component will be used has xref:admin:spaces/processes/phases.adoc[Phases], for instance, in @@ -63,56 +63,56 @@ xref:admin:spaces/processes.adoc[Participatory Processes], then you can also def .Add component: Blogs form - Step settings |=== -|Field |Type |Description +|Champ |Type |Description -|Announcement -|Optional -|A general announcement that'll be visible on the general blog landing page. +|Annonce +|Facultatif +|Une annonce générale qui sera visible sur la page générale des actualités. -|Comments blocked -|Optional -|Whether you want to enable comments creation for this phase. +|Commentaires désactivés +|Facultatif +|Si vous voulez activer la création de commentaires pour cette étape. -|Endorsements enabled -|Optional -|Whether you want to enable endorsements for this phase. +|Soutiens activés +|Facultatif +|Si vous voulez activer les soutiens pour cette étape. -|Endorsements blocked -|Optional +|Soutiens bloqués +|Facultatif |Whether you want to disable adding new endorsements for this phase. |=== -== Permissions +== Autorisations An administrator can choose which kind of xref:customize:authorizations.adoc[Authorizations] a participant need to have to make certain actions in the blogs: -* Comment -* Endorse +* Commenter +* Soutenir == Manage posts image:components/blog/manage_posts.png[Manage posts table] -=== New post form +=== Formulaire de création d'article d'actualités image:components/blog/new_post.png[New post form] -.New post form +.Formulaire de création d'article d'actualités |=== -|Field |Type |Description +|Champ |Type |Description -|Create post as -|Required +|Créer un article en tant que +|Obligatoire |Participant account or user group that will be the author of the post. -|Title -|Required -|What is the title of this post. +|Titre +|Obligatoire +|Quel est le titre de cet article. |Body -|Required +|Obligatoire |What is the description of this post. |=== @@ -121,7 +121,7 @@ image:components/blog/new_post.png[New post form] .Actions |=== -|Icon |Name |Definition +|Icône |Nom |Definition |image:action_edit.png[Edit icon] |Edit @@ -136,7 +136,7 @@ image:components/blog/new_post.png[New post form] |Documents that are related to the post. |image:action_permissions.png[Permissions icon] -|Permissions +|Autorisations |To handle the permissions of this post, depending on the verification a participant has. |image:action_delete.png[Delete icon] From 3749244399e07b24493950dcc8a9951a40a4be0c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:40 +0200 Subject: [PATCH 141/336] New translations appearance.adoc (French) --- docs/fr/modules/admin/pages/appearance.adoc | 46 ++++++++++----------- 1 file changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/fr/modules/admin/pages/appearance.adoc b/docs/fr/modules/admin/pages/appearance.adoc index 17b9109fc0..e352d5fb5e 100644 --- a/docs/fr/modules/admin/pages/appearance.adoc +++ b/docs/fr/modules/admin/pages/appearance.adoc @@ -30,49 +30,49 @@ NOTE: This is a legacy setting that will be removed in the next version. Il n'y * **Bannière de contenu mis en valeur** ** *Show the highlighted content banner* ** *Title* -** *Short description* -** *Action button title* -** *Action button subtitle* -** *Action button URL* +** *Brève description* +** *Titre du bouton d'action* +** *Sous-titre du bouton d'action* +** *URL du bouton d'action* ** *Image* --- -* *Edit omnipresent banner* -** **Show omnipresent banner** -** **Title** -** **Short description** +* *Modifier la bannière permanente* +** **Activer la bannière permanente** +** **Titre** +** **Brève description** ** **URL** --- -* **Edit layout appearance** +* **Modifier l’aspect de la mise en page** -This subsection defines the images for the layout that will be visible in almost all the pages. These are: +Cette sous-section définit les images de mise en page qui seront visibles dans presque toutes les pages. Il s'agit de : -** Icon +** Icône ** Logo -** Official logo header -** Official logo footer -** Official organization URL +** Logo officiel - barre de navigation +** Logo officiel - pied de page +** Url officielle de l'organisation // TODO: Add examples --- -* **Organization colors**: What are the colors for your organization. Please notice that this could generate accessibility problems, for instance with people that doesn't have a good contrast notion. You can set -** Primary -** Secondary -** Success -** Warning -** Alert -** Highlight -** Highlight, alternative +* **Couleurs de l'organisation** : Les couleurs de votre organisation. Veuillez noter que cela peut générer des problèmes d'accessibilité, par exemple pour les utilisateurs souffrant de certains types de daltonisme et d'autres particularités similaires, qui rencontrent un faible contraste et ont du mal à faire la différence entre des couleurs proches. Vous pouvez définir les couleurs suivantes : +** Couleur primaire +** Couleur secondaire +** Couleur de succès +** Couleur d'avertissement +** Couleur d'alerte +** Couleur de surbrillance +** Couleur de surbrillance alternative // TODO: Add examples --- -* **Header snippets**: Use this field to add things to the HTML head. The most common use is to integrate third-party services that require some extra JavaScript or CSS. Also, you can use it to add extra meta tags to the HTML. Note that this will only be rendered in public pages, not in the admin section. +* **Header snippets**: Utilisez ce champ pour ajouter des éléments à la HTML head. L’utilisation la plus courante est d’intégrer des services tiers qui nécessitent du JavaScript ou du CSS supplémentaires. De plus, vous pouvez l'utiliser pour ajouter des balises méta supplémentaires au HTML. Notez que cela ne sera rendu que dans les pages publiques, pas dans la section admin. // TODO: reference to HTML snippet setting \ No newline at end of file From 1bb71b042fb5f6273300d9faa31154130457e9b0 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:41 +0200 Subject: [PATCH 142/336] New translations areas.adoc (French) --- docs/fr/modules/admin/pages/areas.adoc | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/fr/modules/admin/pages/areas.adoc b/docs/fr/modules/admin/pages/areas.adoc index b25b26c414..1099cee464 100644 --- a/docs/fr/modules/admin/pages/areas.adoc +++ b/docs/fr/modules/admin/pages/areas.adoc @@ -1,11 +1,11 @@ -= Areas += Périmètres d'assemblée include::partial$deprecated.adoc[] -Areas are all the sectors that an Organization can have. +Les périmètres d'assemblée sont tous les périmètres qu'une organisation peut avoir. -They are pretty similar to xref:admin:scopes.adoc[scopes], meaning that they are a way of allowing a better navigation and filtering in the spaces and components. +Ils sont assez similaires aux xref:admin:scopes.adoc[scopes], ce qui signifie qu'ils sont un moyen de permettre une meilleure navigation et un meilleur filtrage dans les espaces et les fonctionnalités. -We don't recommend using them, as probably in the future they will be removed. +Nous ne recommandons pas de les utiliser, car dans le futur elles seront probablement supprimées. -You can read more information about the history of Areas in this https://github.com/decidim/decidim/issues/3540#issuecomment-427324532[GitHub comment]. \ No newline at end of file +Vous pouvez lire plus d'informations sur l'histoire des périmètres d'assemblée dans ce https://github.com/decidim/decidim/issues/3540#issuecomment-427324532[commentaire GitHub]. \ No newline at end of file From d24134a11c7ea84a935d42aae129320df6ee04e2 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:42 +0200 Subject: [PATCH 143/336] New translations components.adoc (French) --- docs/fr/modules/admin/pages/components.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/fr/modules/admin/pages/components.adoc b/docs/fr/modules/admin/pages/components.adoc index 602089c849..35f9f16229 100644 --- a/docs/fr/modules/admin/pages/components.adoc +++ b/docs/fr/modules/admin/pages/components.adoc @@ -1,5 +1,5 @@ -= Components += Fonctionnalités -Through components an administrator can enable and configure different participatory mechanisms. +Grâce aux fonctionnalités, un administrateur peut activer et configurer différents mécanismes de participation. include::partial$components_list.adoc[] \ No newline at end of file From 5368e17e42d6cf921c12cf33c19b434209d33260 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:43 +0200 Subject: [PATCH 144/336] New translations budgets.adoc (French) --- .../admin/pages/components/budgets.adoc | 208 +++++++++--------- 1 file changed, 103 insertions(+), 105 deletions(-) diff --git a/docs/fr/modules/admin/pages/components/budgets.adoc b/docs/fr/modules/admin/pages/components/budgets.adoc index e2f4d81332..96a7e7c29e 100644 --- a/docs/fr/modules/admin/pages/components/budgets.adoc +++ b/docs/fr/modules/admin/pages/components/budgets.adoc @@ -33,62 +33,62 @@ To configure the Budgets component: . Sign in as admin . Go to admin panel -. In the main sidebar, click in the button for the space that you want to configure the component for. -For instance, it could be "Processes", "Assemblies" or "Conferences". -. Go to components -. Click on "Add component" button +. Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. +Par exemple, il peut s'agir de "Concertations", d'"Assemblées" ou de "Conférences". +. Aller dans les fonctionnalités +. Cliquez sur le bouton "Ajouter une fonctionnalité" . Click on "Budgets" -. Fill the xref:_add_component[Add component] form +. Remplissez le formulaire xref:_add_component[Ajouter une fonctionnalité] -== Add component +== Ajouter une fonctionnalité image:components/budgets/component.png[Add component form] .Add component: Budgets form |=== -|Field |Type |Description +|Champ |Type |Description -|Name -|Required -|What is the title of this component. For instance, "Budgets" +|Nom +|Obligatoire +|Quel est le titre de cette fonctionnalité. For instance, "Budgets" -|Order position -|Optional -|Which order will it have in relation to the other budgets. Having a lower number means a higher priority. +|Rang d'affichage +|Facultatif +|Which order will it have in relation to the other budgets. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two budgets, "Budget a" with weight "10" and "Budget b" with weight "0", then "Budget b" will be first when ordering. |=== .Add component: Budgets form - Global settings |=== -|Field |Type |Description +|Champ |Type |Description |Scopes enabled -|Optional +|Facultatif |Check if you want to have Scopes filtering in this component. -|Scope -|Optional +|Secteur +|Facultatif |Which xref:admin:scopes.adoc[Scope] does this component belongs to. -|Global scope -|Optional +|Portée générale +|Facultatif | |xref:_workflows[Workflow] -|Required +|Obligatoire |How the participants can vote if there are multiple budget sets. You can define your own xref:_workflows[Workflow] or use one of the availables. -|Projects per page -|Required -|How many projects are displayed per page. +|Projets par page +|Obligatoire +|Combien de projets sont affichés par page. -|Enable rule: Minimum budget percentage +|Activer la règle : Pourcentage de budget minimum |Optional, but incompatible with "Minimum number of projects to be voted on" and "Selected projects with minimum and maximum number of projects to be voted on" |Allows to define a "Vote threshold percent", a percent of the total budget that participants must reach to be able to vote. -|Enable rule: Minimum number of projects to be voted on +|Activer la règle : Nombre minimum de projets à voter |Optional, but incompatible with "Minimum budget percentage" and "Selected projects with minimum and maximum number of projects to be voted on" |Allows to define a "Minimum number of projects to vote", a number of projects that participants must reach to be able to vote. @@ -97,28 +97,28 @@ For instance, if you have two budgets, "Budget a" with weight "10" and "Budget b |Allows to define a "Minimum amount of projects to be selected" and a "Maximum amount of projects to be selected", the number of projects that participants will need to vote as a minimum and maximum. -|Comments enabled -|Optional -|Whether you want to have comments in the meetings. +|Commentaires activés +|Facultatif +|Si vous voulez avoir des commentaires dans les rencontres. -|Comments max length -|Optional -|What is the characters limit that participants will have when making comments. Leave 0 for default value. +|Longueur maximale des commentaires +|Facultatif +|Quelle est la limite de caractères que les participants auront quand ils feront des commentaires. Laisser 0 pour la valeur par défaut. |Actions permissions can be set for each project -|Optional +|Facultatif |Whether you want to be able to set permissions for every one of the projects. Most of the time you will want to leave this option disabled. -|Announcement -|Optional +|Annonce +|Facultatif |A general announcement that'll be visible on the general budgets landing page. |Budgets landing page -|Optional +|Facultatif |What message will be shown in the Budgets landing page when there are multiple budgets. |More information modal -|Optional +|Facultatif |What message will be shown when clicking on the "More information" link. |=== @@ -128,39 +128,39 @@ xref:admin:spaces/processes.adoc[Participatory Processes], then you can also def .Add component: Budgets form - Step settings |=== -|Field |Type |Description +|Champ |Type |Description -|Comments blocked -|Optional +|Commentaires désactivés +|Facultatif |Whether you want to enable comments for this phase. |Voting -|Required +|Obligatoire |Choose one of the following options depending in the moment of the process: Voting disabled, Voting enabled or Voting finished. |Show votes -|Optional +|Facultatif |Wheter the votes will be shown. We strongly recommend that you only check this option after the voting is finished. -|Announcement -|Optional +|Annonce +|Facultatif |A general announcement that'll be visible on the general budgets landing page. |Budgets landing page -|Optional +|Facultatif |What message will be shown in the Budgets landing page when there are multiple budgets. |More information modal -|Optional +|Facultatif |What message will be shown when clicking on the "More information" link. |=== -== Permissions +== Autorisations Edit permissions * Vote -* Comment +* Commenter == Workflows @@ -204,23 +204,23 @@ image:components/budgets/new_budget.png[New budget form] .New budget form |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |What is the title of this budget. For instance, "District A" -|Order position -|Optional -|Which order will it have in relation to the other budgets. Having a lower number means a higher priority. +|Rang d'affichage +|Facultatif +|Which order will it have in relation to the other budgets. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two budgets, "Budget a" with weight "10" and "Budget b" with weight "0", then "Budget b" will be first when ordering. |Description -|Optional +|Facultatif |What is the description of this budget. |Total budget -|Required +|Obligatoire |What is the total amount of money that people will have for assigning. |=== @@ -229,45 +229,43 @@ For instance, if you have two budgets, "Budget a" with weight "10" and "Budget b .Actions |=== -|Icon |Name |Definition +|Icône |Nom |Definition |image:action_preview.png[Preview icon] |Preview -|To see how it's shown in the frontend to participants. +|Pour voir comment il est montré dans le frontend aux participants. -|image:action_list.png[Manage projects icon] -|xref:_manage_projects[Manage projects] -|Allows you to manage the projects of a budget. +|image:action_list.png[Gérer l'icône des projets] +|xref:_manage_projects[Gérer les projets] +|Vous permet de gérer les projets d'un budget. |image:action_edit.png[Edit icon] |Edit -|Edit form for a budget. It's the same form as "New budget". +|Modifier un budget. C'est le même formulaire que "Nouveau budget". |image:action_delete.png[Delete icon] |Delete -|To delete this budget. Only can be done when there aren't any projects. +|Pour supprimer le budget. Peut être fait unquement quand il n'y a pas de projets dans ce budget. |=== -==== Manage projects +==== Gérer les projets -===== Import proposals to projects +===== Importer des propositions dans des projets -Depending in the normative, you could want to have a first phase where participants -make proposals, and those proposals are selected (by voting or by technical review), -then you can import those proposals and convert them to projects. +Selon votre concertation, vous pourriez vouloir avoir une première étape pendant laquelle les participants créent des propositions, puis ces propositions sont sélectionnés (par le vote ou par une revue technique), enfin vous pouvez importer ces propositions et les convertir en projets. -For this to work: +Pour que cela fonctionne : -. The following settings in the proposals component need to be enabled: -.. Proposal answering enabled -.. Enable costs on proposal answers -. A valuator or administrator need to Answer proposals: -.. Review the proposals -.. Accept or reject them according to your normative -.. Add costs to the proposals if were accepted -. An administrator can Import proposals to projects +. Les paramètres suivants doivent être activés dans la fonctionnalité de propositions : +.. Réponses aux propositions activées +.. Activer les coûts sur les réponses aux propositions +. Un évaluateur ou un administrateur doit répondre aux propositions : +.. Relire les propositions +.. Acceptez ou rejetez les en fonction de votre règlement +.. Ajouter des coûts aux propositions si elles ont été acceptées +. Un administrateur peut importer des propositions vers des projets -image:components/budgets/import_proposals.png[Import proposals to projects] +image:components/budgets/import_proposals.png[Importer des propositions dans les projets] ===== Export all @@ -277,38 +275,38 @@ Allows to export the projects for this budget in different formats. * Projects as JSON * Projects as Excel -===== New project form +===== Formulaire de création d'un projet -image:components/budgets/new_project.png[New project form for a Budget] +image:components/budgets/new_project.png[Nouveau formulaire de projet pour un budget] -.New project form +.Formulaire de création d'un projet |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required -|The title for this project. +|Titre +|Obligatoire +|Le titre pour ce projet. |Description -|Required -|A description of what this project is about. +|Obligatoire +|Une description de l'objet de ce projet. -|Budget amount -|Required -|What's the budget amount for this project. How much money will it cost to implement this project? +|Montant du budget +|Obligatoire +|Le montant du budget pour ce projet. Combien coûte la mise en œuvre de ce projet ? -|Category -|Optional -|Which Category has the project. Used for filtering in the budgets list. +|Catégorie +|Facultatif +|La catégorie du projet. Utilisé pour les filtres dans la liste des projets. -|Proposals -|Optional -|Choose related proposals for this project. Automatic assingned when importing proposals. +|Propositions +|Facultatif +|Choisissez des propositions liées à ce projet. Auto-assignation lors de l'importation des propositions. -|Add an image gallery -|Optional -|Add multiple images illustrating what this project is about, or where it will be implemented. +|Ajouter une galerie d'images +|Facultatif +|Ajoutez plusieurs images illustrant en quoi consiste ce projet, ou où il sera implémenté. |=== ===== Actions @@ -316,27 +314,27 @@ image:components/budgets/new_project.png[New project form for a Budget] .Actions |=== -|Icon |Name |Definition +|Icône |Nom |Definition |image:action_preview.png[Preview icon] |Preview -|To see how it's shown in the frontend to participants. +|Pour voir comment il est montré dans le frontend aux participants. |image:action_edit.png[Edit icon] |Edit -|Edit form for a project. It's the same form as "New project". +|Modifier un projet. C'est le même formulaire que "Nouveau projet". -|image:action_folder.png[Folders icon] -|Folders +|image:action_folder.png[Icône des dossiers] +|Dossiers |For classifying Attachments. |image:action_attachments.png[Attachments icon] |Attachments -|Documents that are related to the project. +|Documents liés au projet. |image:action_delete.png[Delete icon] |Delete -|To delete this project. +|Pour supprimer le projet. |=== == Results From 8245d44a6faccc40134de68792fd9c3599ac2005 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:45 +0200 Subject: [PATCH 145/336] New translations debates.adoc (French) --- .../admin/pages/components/debates.adoc | 135 +++++++++--------- 1 file changed, 67 insertions(+), 68 deletions(-) diff --git a/docs/fr/modules/admin/pages/components/debates.adoc b/docs/fr/modules/admin/pages/components/debates.adoc index 6f62a9f8b5..b1df1fed93 100644 --- a/docs/fr/modules/admin/pages/components/debates.adoc +++ b/docs/fr/modules/admin/pages/components/debates.adoc @@ -1,78 +1,77 @@ -= Debate += Débat -The Debate component allows people to have discussions, without voting nor prioritzation. It also allows to close them, -by adding conclusions or a summary of what the discussion was about. +Le composant Débat permet aux participants d'avoir des discussions, sans vote ni prioritisation. Cela permet également de les conclure, en ajoutant des conclusions ou un résumé de ce qui a été discuté. From this starting point, there could be other configurations, such as: -* To allow debates creation by participants -* To have debates with a fixed started and ending date or open -* To show endorsements (public supports) or not +* Permettre la création de débats par les participants +* Avoir des débats avec une date de début et de fin fixe ou ouvert +* Montrer les soutiens (support public) ou non Some examples of where this component was used: -* https://meta.decidim.org/processes/roadmap/f/219/[Propose new functionalities for Decidim software in Metadecidim] +* https://meta.decidim.org/processes/roadmap/f/219/[Proposer de nouvelles fonctionnalités pour le logiciel Decidim dans Metadecidim] -image:components/debates/example01.png[Debates listing example] -image:components/debates/example02.png[Debate example] +image:components/debates/example01.png[Exemple de liste des débats] +image:components/debates/example02.png[Exemple de débat] -To configure the Debate component: +Pour configurer le fonctionnalité Débat: . Sign in as admin . Go to admin panel -. In the main sidebar, click in the button for the space that you want to configure the component for. -For instance, it could be "Processes", "Assemblies" or "Conferences". -. Go to components -. Click on "Add component" button -. Click on "Debate" -. Fill the xref:_add_component[Add component] form +. Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. +Par exemple, il peut s'agir de "Concertations", d'"Assemblées" ou de "Conférences". +. Aller dans les fonctionnalités +. Cliquez sur le bouton "Ajouter une fonctionnalité" +. Cliquez sur "Débattre" +. Remplissez le formulaire xref:_add_component[Ajouter une fonctionnalité] -== Add component +== Ajouter une fonctionnalité -image:components/debates/component.png[Add component form] +image:components/debates/component.png[Ajouter un formulaire de composant] -.Add component: Debate form +.Ajouter un composant : Formulaire de débat |=== -|Field |Type |Description +|Champ |Type |Description -|Name -|Required -|What is the title of this component. For instance, "Debates" +|Nom +|Obligatoire +|Quel est le titre de cette fonctionnalité. Par exemple, "Debates" -|Order position -|Optional -|Which order will it have in relation to the other debates. Having a lower number means a higher priority. -For instance, if you have two debates, "Debate a" with weight "10" and "Debate b" with weight "0", then "Debate b" will be first when ordering. +|Rang d'affichage +|Facultatif +|Quel ordre aura-t-il par rapport aux autres débats. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. +Par exemple, si vous avez deux débats, "Débat A" avec le poids "10" et "Débat B" avec le poids "0", alors "Débat B" sera le premier lors de l'affichage. |=== -.Add component: Debate form - Global settings +.Ajouter une fonctionnalité : Formulaire de débat - Paramètres globaux |=== -|Field |Type |Description +|Champ |Type |Description |Scopes enabled -|Optional +|Facultatif |Check if you want to have Scopes filtering in this component. -|Scope -|Optional +|Secteur +|Facultatif |Which xref:admin:scopes.adoc[Scope] does this component belongs to. -|Global scope -|Optional +|Portée générale +|Facultatif | -|Comments enabled -|Optional -|Whether you want to have comments in the meetings. +|Commentaires activés +|Facultatif +|Si vous voulez avoir des commentaires dans les rencontres. -|Comments max length -|Optional -|What is the characters limit that participants will have when making comments. Leave 0 for default value. +|Longueur maximale des commentaires +|Facultatif +|Quelle est la limite de caractères que les participants auront quand ils feront des commentaires. Laisser 0 pour la valeur par défaut. -|Announcement -|Optional +|Annonce +|Facultatif |A general announcement that'll be visible on the general debates landing page. |=== @@ -82,36 +81,36 @@ xref:admin:spaces/processes.adoc[Participatory Processes], then you can also def .Add component: Debates form - Step settings |=== -|Field |Type |Description +|Champ |Type |Description -|Endorsements enabled -|Optional +|Soutiens activés +|Facultatif |Check if you want that participants show public support for these debates. -|Endorsements blocked -|Optional +|Soutiens bloqués +|Facultatif | |Debate creation by participants enabled -|Optional +|Facultatif |Check if you want to allow the creation of new debates by participants. -|Comments blocked -|Optional +|Commentaires désactivés +|Facultatif |Whether you want to enable comments for this phase. -|Announcement -|Optional +|Annonce +|Facultatif |A general announcement that'll be visible on the general debate landing page. |=== -== Permissions +== Autorisations An administrator can choose which kind of xref:customize:authorizations.adoc[Authorizations] a participant need to have to make certain actions in the debates: * Create -* Endorse +* Soutenir == Manage debates @@ -132,26 +131,26 @@ image:components/debates/new_debate_backend.png[New debate backend form] .New debate form |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |What is the title of this debate. For instance, "How can we improve this process?" |Description -|Required +|Obligatoire |What is the description of this debate. |Instructions to participate -|Required +|Obligatoire |Add a message for the participants. |Information updates -|Optional +|Facultatif |Add a message for the participants. |xref:_debate_types[Debate type] -|Required +|Obligatoire |Choose between Finite and Open. Finite means that the debate has a starting and ending date and time, Open means that there isn't any timeframe. @@ -163,8 +162,8 @@ there isn't any timeframe. |Required if the debate type is Finite |Expected format: dd/mm/yyyy hh:ii -|Category -|Optional +|Catégorie +|Facultatif |Which category has the debate. Used for filtering in the debates list. |=== @@ -185,7 +184,7 @@ image:components/debates/debate_finite.png[Finite debate] .Actions |=== -|Icon |Name |Definition +|Icône |Nom |Definition |image:action_edit.png[Edit icon] |Edit @@ -196,12 +195,12 @@ image:components/debates/debate_finite.png[Finite debate] |Close form for a debate. For adding conclusions. |image:action_permissions.png[Permissions icon] -|Permissions +|Autorisations |To handle the permissions of this debate, depending on the verification a participant has. |image:action_delete.png[Delete icon] |Delete -|To delete this debate. Only can be done when there aren't any projects. +|To delete this debate. Peut être fait unquement quand il n'y a pas de projets dans ce budget. |=== === Close debate form @@ -218,10 +217,10 @@ image:components/debates/close_debate_frontend.png[Close debate frontend form] .Close debate form |=== -|Field |Type |Description +|Champ |Type |Description |Conclusions -|Required +|Obligatoire |What is the conclusion for this debate. |=== From 2199064663440ef9c7bfbd131de80582a9f2673b Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:46 +0200 Subject: [PATCH 146/336] New translations meetings.adoc (French) --- .../admin/pages/components/meetings.adoc | 156 +++++++++--------- 1 file changed, 78 insertions(+), 78 deletions(-) diff --git a/docs/fr/modules/admin/pages/components/meetings.adoc b/docs/fr/modules/admin/pages/components/meetings.adoc index 96b29fa84e..6b316405a1 100644 --- a/docs/fr/modules/admin/pages/components/meetings.adoc +++ b/docs/fr/modules/admin/pages/components/meetings.adoc @@ -34,94 +34,94 @@ For adding the component, you need to: . Sign in as admin . Go to admin panel -. In the main sidebar, click in the button for the space that you want to configure the component for. +. Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. For instance, it could be "Processes", "Assemblies", or "Conferences" -. Go to components -. Click on "Add component" button +. Aller dans les fonctionnalités +. Cliquez sur le bouton "Ajouter une fonctionnalité" . Click on "Meetings" -. Fill the xref:_add_component[Add component] form +. Remplissez le formulaire xref:_add_component[Ajouter une fonctionnalité] -== Add component +== Ajouter une fonctionnalité For configuring the meeting component you have these settings: .Add component - Meetings form |=== -|Field |Type |Description +|Champ |Type |Description -|Name -|Required +|Nom +|Obligatoire |What is the name of this component. -|Order position -|Optional -|Which order will it have in relation with the other components. Having a lower number means a higher priority. For instance, +|Rang d'affichage +|Facultatif +|Which order will it have in relation with the other components. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two components, "Proposals" with weight "10" and "Meetiings" with weight "0", then "Meetings" will be first when ordering. |=== .Add component - Meetings form: Global settings |=== -|Field |Type |Description +|Champ |Type |Description |Scopes enabled -|Optional +|Facultatif |Check if you want to have Scopes filtering in this process. -|Scope -|Optional +|Secteur +|Facultatif |Which scope will be used for this component. -|Announcement -|Optional +|Annonce +|Facultatif |A general announcement that'll be visible in the general meetings list. |Default registration terms -|Optional +|Facultatif |What'll be the registration terms of service that the participant would need to accept when registering. -|Comments enabled -|Optional -|Whether you want to have comments in the meetings. +|Commentaires activés +|Facultatif +|Si vous voulez avoir des commentaires dans les rencontres. -|Comments max length -|Optional -|What is the characters limit that participants will have when making comments. Leave 0 for default value. +|Longueur maximale des commentaires +|Facultatif +|Quelle est la limite de caractères que les participants auront quand ils feront des commentaires. Laisser 0 pour la valeur par défaut. |Registration code enabled -|Optional +|Facultatif |Check if you want to give registration codes to participants. Learn more in xref:components/meetings/registrations.adoc[Registrations]. |Actions permissions can be set for each meeting -|Optional +|Facultatif |If you want more granular permissions inside of every one of the Meetings. |Enable pads creation -|Optional +|Facultatif |If you want an Etherpad embedded in your meetings. Must have the xref:services:etherpad.adoc[Etherpad] integration configurated. |Participants can create meetings -|Optional +|Facultatif |Allows participants to create new meetings. See xref:_citizens_meetings[Citizens meetings] |Maps enabled -|Optional +|Facultatif |Wheter you want to show a map in the meetings in the meeting detail. |=== .Add component - Meetings form: Step settings |=== -|Field |Type |Description +|Champ |Type |Description -|Announcement -|Optional +|Annonce +|Facultatif |A general announcement that'll be visible in the general meetings list. -|Comments enabled -|Optional -|Whether you want to have comments in the meetings. +|Commentaires activés +|Facultatif +|Si vous voulez avoir des commentaires dans les rencontres. |=== == Create a new meeting @@ -138,18 +138,18 @@ image:components/meetings/new_meeting_form_frontend02.png[Create a new meeting f .Create meeting - Frontend form |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |What is the title for this meeting. |Description -|Required +|Obligatoire |A description of what will be discussed in this meeting, like the topics. |Type -|Required +|Obligatoire |Choose one option between "In person", "Online" or "Booth" |Address @@ -157,35 +157,35 @@ image:components/meetings/new_meeting_form_frontend02.png[Create a new meeting f |Address: used by Geocoder to find the location |Location -|Required +|Obligatoire |Location: message directed to the users implying the spot to meet at |Location hints -|Optional +|Facultatif |Location hints: additional info. Example: the floor of the building |Online meeting URL -|Optional +|Facultatif |Which URL will the meeting be held. |Show embedded iframe for this URL -|Optional +|Facultatif |Whether or not embed the iframe for this videoconference URL. Only a few services allow embedding (i.e. YouTube, Twitch...) |Start Time -|Required +|Obligatoire |Which day and time will the meeting start. Expected format: dd/mm/yyyy hh:ii |End Time -|Required +|Obligatoire |Which day and time will the meeting start. Expected format: dd/mm/yyyy hh:ii -|Category -|Optional +|Catégorie +|Facultatif |Which Category has the meeting. Used for filtering in the meetings list. |Registration type -|Required +|Obligatoire |Choose one option between "Registration disabled", "On this platform", or "On a different platform" |Available slots for this meeting @@ -214,18 +214,18 @@ image:components/meetings/new_meeting_form_backend.png[Create a new meeting form .Create meeting - Backend form |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |What is the title for this meeting. |Description -|Required +|Obligatoire |A description of what will be discussed in this meeting, like the topics. |Type -|Required +|Obligatoire |Choose one option between "In person", "Online" or "Booth" |Address @@ -233,35 +233,35 @@ image:components/meetings/new_meeting_form_backend.png[Create a new meeting form |Address: used by Geocoder to find the location |Location -|Required +|Obligatoire |Location: message directed to the users implying the spot to meet at |Location hints -|Optional +|Facultatif |Location hints: additional info. Example: the floor of the building |Online meeting URL -|Optional +|Facultatif |Which URL will the meeting be held. |Show embedded iframe for this URL -|Optional +|Facultatif |Whether or not embed the iframe for this videoconference URL. Only a few services allow embedding (i.e. YouTube, Twitch...) |Start Time -|Required +|Obligatoire |Which day and time will the meeting start. Expected format: dd/mm/yyyy hh:ii |End Time -|Required +|Obligatoire |Which day and time will the meeting start. Expected format: dd/mm/yyyy hh:ii -|Category -|Optional +|Catégorie +|Facultatif |Which Category has the meeting. Used for filtering in the meetings list. |Registration type -|Required +|Obligatoire |Choose one option between "Registration disabled", "On this platform", or "On a different platform" |Available slots for this meeting @@ -273,16 +273,16 @@ image:components/meetings/new_meeting_form_backend.png[Create a new meeting form |Must be an URL. Link to go on the external service that you are using for registrations. |Private meeting -|Optional +|Facultatif |Check if the meeting shouldn't be visible for all the visitors. Specific to "Official meetings". |Transparent -|Optional +|Facultatif |Related to "Private meeting", check if the meeting should be visible for all the visitors but they shouldn't be able to participate in. Specific to "Official meetings". Specific to "Official meetings". |Customize registration email -|Optional +|Facultatif |Wheter you want to add a message in the registration email. Specific to "Official meetings". |Registration email custom content @@ -297,14 +297,14 @@ a place for children, deaf assistance, translations, etc. You can have multiple .Create meeting - Services |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |Title of the service. |Description -|Optional +|Facultatif |Description of the service. |=== @@ -315,14 +315,14 @@ a place for children, deaf assistance, translations, etc. You can have multiple .Actions - Citizens meetings |=== -|Icon |Name |Definition +|Icône |Nom |Definition |image:action_preview.png[Preview icon] |Preview -|To see how it's shown in the frontend to participants. +|Pour voir comment il est montré dans le frontend aux participants. |image:action_permissions.png[Permissions icon] -|Permissions +|Autorisations |To handle the permissions of this meeting, depending on the verification a participant has. Allows an admin to configure who can *Join* a meeting. |=== @@ -332,7 +332,7 @@ who can *Join* a meeting. .Actions - Official meetings |=== -|Icon |Name |Definition +|Icône |Nom |Definition |image:action_publish.png[Publish icon] |Publish @@ -344,7 +344,7 @@ who can *Join* a meeting. |image:action_preview.png[Preview icon] |Preview -|To see how it's shown in the frontend to participants. +|Pour voir comment il est montré dans le frontend aux participants. |image:action_duplicate.png[Duplicate icon] |Duplicate @@ -370,8 +370,8 @@ who can *Join* a meeting. |xref:admin:components/meetings/close.adoc[Close] |Allows and admin to Close the meeting and add extra information. -|image:action_folder.png[Folders icon] -|Folders +|image:action_folder.png[Icône des dossiers] +|Dossiers |For classifying Attachments. |image:action_attachments.png[Attachments icon] @@ -379,7 +379,7 @@ who can *Join* a meeting. |Documents that are related to the meeting. |image:action_permissions.png[Permissions icon] -|Permissions +|Autorisations |To handle the permissions of this meeting, depending on the verification a participant has. Allows an admin to configure who can *Join* a meeting. From 6916c7dcb2fae20fb9be742106c184db2a9b5024 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:48 +0200 Subject: [PATCH 147/336] New translations agenda.adoc (French) --- .../pages/components/meetings/agenda.adoc | 111 +++++++++--------- 1 file changed, 54 insertions(+), 57 deletions(-) diff --git a/docs/fr/modules/admin/pages/components/meetings/agenda.adoc b/docs/fr/modules/admin/pages/components/meetings/agenda.adoc index 5ec6d771ab..75b77c8a46 100644 --- a/docs/fr/modules/admin/pages/components/meetings/agenda.adoc +++ b/docs/fr/modules/admin/pages/components/meetings/agenda.adoc @@ -1,91 +1,88 @@ -= Agenda += Ordre du jour -The agenda feature allows an administrator to define the schedule for a meeting. It's possible to define agenda items and -sub-items, with every one of the topics that will be discussed in the meeting, along with a description and the duration -of every item and sub-item. +La fonctionnalité ordre du jour permet à une administratrice de définir le calendrier d'une rencontre. Il est possible de définir des éléments et des sous-éléments dans un ordre du jour, avec chacun des sujets qui seront discutés lors de la réunion, accompagnés d'une description et de la durée de chaque élément et sous-élément. -image:components/meetings/agenda/agenda_frontend.png[Agenda in the frontend] +image:components/meetings/agenda/agenda_frontend.png[Image de la fonctionnalité ordre du jour] -== New agenda form +== Formulaire de création d'ordre du jour -To define an agenda for a meeting: +Définir l'ordre du jour d'une rencontre : . Sign in as admin . Go to admin panel -. In the main sidebar, click in the button for the space that you want to configure the component for. +. Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. For instance, it could be "Processes", "Assemblies", or "Conferences" . Click on "Meetings" -. Search the meeting that you want to add the agenda to -. Click on the "Agenda" button image:action_agenda.png[Agenda button] -. Fill the form +. Recherchez la rencontre pour laquelle vous souhaitez ajouter l'ordre du jour +. Cliquez sur le bouton "Ordre du jour" image:action_agenda.png[Bouton ordre du jour] +. Remplissez le formulaire -image:components/meetings/agenda/new_agenda_form.png[New agenda form in the backend] +image:components/meetings/agenda/new_agenda_form.png[Formulaire de création d'ordre du jour dans le backoffice] -.New agenda form +.Formulaire de création d'ordre du jour |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required -|Title for the agenda. For instance, "Schedule" +|Titre +|Obligatoire +|Titre de l'ordre du jour. Par exemple, "Calendrier" |Visible -|Optional -|Check if you want to publish the agenda. +|Facultatif +|Cochez cette case si vous souhaitez publier l'ordre du jour. -|Agenda items -|Required -|List of agenda items. +|Points de l'ordre du jour +|Obligatoire +|Liste des points de l'ordre du jour. |=== -It's possible to create any number of Agenda items and sub-items. You can up or down the hierarchy of the agenda items. -It's also possible to remove and edit the agenda items. +Il est possible de créer autant de points et de sous-points de l'ordre du jour que souhaité. Vous pouvez monter ou descendre la hiérarchie des points de l'ordre du jour. +Il est également possible de supprimer et de modifier les éléments de l'ordre du jour. -.Agenda item form +.Formulaire d'élément de l'ordre du jour |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required -|Title for the agenda item +|Titre +|Obligatoire +|Titre du point de l'ordre du jour -|Duration -|Required -|How many minutes will the agenda item last. For instance, "15". +|Durée +|Obligatoire +|Combien de minutes durera le point de l'ordre du jour. Par exemple, "15". |Description -|Optional -|Title for the agenda item +|Facultatif +|Titre du point de l'ordre du jour -|Agenda sub-items -|Optional -|List of agenda sub-items. +|Sous-points de l’ordre du jour +|Facultatif +|Liste des sous-points de l'ordre du jour. |=== -The only limitation that agenda items and sub-items have is that they have to respect the duration of the parent. For instance, -if there's an Item that lasts 60 minutes, you can't create a sub-item that lasts 90 minutes. +La seule limite des points et des sous-points de l'ordre du jour est qu'ils doivent avoir une durée inférieure à celle du parent. Par exemple, si un point dure 60 minutes, vous ne pouvez pas créer un sous-point d'une durée de 90 minutes. -As an example, this agenda: +À titre d'exemple, cet ordre du jour : -image:components/meetings/agenda/agenda_frontend.png[Agenda in the frontend] +image:components/meetings/agenda/agenda_frontend.png[Image de la fonctionnalité ordre du jour] -Has the following configuration: +Pour la configuration suivante : -* Title: "Schedule" +* Titre: "Calendrier" * Visible: true -* Agenda item #1: -** Title: Diagnosis -** Duration: 60 -* Agenda item #2: -** Title: Ideation -** Duration: 120 -** Agenda sub-item #2.1: -*** Title: Future thinking -*** Duration: 60 -*** Description: Imagining how we can solve the problem -** Agenda sub-item #2.2: -*** Title: Creating proposals -*** Duration: 60 -*** Description: In the platform \ No newline at end of file +* Point d'ordre du jour #1 : +** Titre: Diagnostic +** Durée: 60 +* Point d'ordre du jour #2 : +** Titre: Idéation +** Durée: 120 +** Sous-point de l'ordre du jour #2.1 : +*** Titre: Pensée future +*** Durée: 60 +*** Description: Imaginez comment nous pouvons résoudre le problème +** Sous-point de l'ordre du jour #2.2 : +*** Titre: Création de propositions +*** Durée: 60 +*** Description: Sur la plateforme \ No newline at end of file From bfb1d374869b33ff1035ce25757f565e4b783e33 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:49 +0200 Subject: [PATCH 148/336] New translations close.adoc (French) --- .../pages/components/meetings/close.adoc | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/fr/modules/admin/pages/components/meetings/close.adoc b/docs/fr/modules/admin/pages/components/meetings/close.adoc index f598ec1e90..bb6cd6fb8e 100644 --- a/docs/fr/modules/admin/pages/components/meetings/close.adoc +++ b/docs/fr/modules/admin/pages/components/meetings/close.adoc @@ -18,50 +18,50 @@ To close a meeting: . Sign in as admin . Go to admin panel -. In the main sidebar, click in the button for the space that you want to configure the component for. +. Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. For instance, it could be "Processes", "Assemblies", or "Conferences" . Click on "Meetings" . Search the meeting that you want to close . Click on the "Close" button image:action_close.png[Close button] -. Fill the form +. Remplissez le formulaire image:components/meetings/close/form_backend.png[Close meeting form in the backend] .Close meeting form (backend) |=== -|Field |Type |Description +|Champ |Type |Description |Minutes -|Required +|Obligatoire |Description of what happened in the meeting. |List of organizations that attended -|Optional +|Facultatif |Metadata that gets shown in the sidebar of the meeting. |Number of attendees -|Required +|Obligatoire |Metadata that gets shown in the sidebar of the meeting. Must be a number. |Number of contributions -|Optional +|Facultatif |Metadata that gets shown in the sidebar of the meeting. Must be a number. -|Proposals -|Optional +|Propositions +|Facultatif |Choose proposals from this space that were discussed in this meeting |Video URL -|Optional +|Facultatif |It's not used for anything. It will be removed in the future. |Audio URL -|Optional +|Facultatif |It's not used for anything. It will be removed in the future. |Is visible -|Optional +|Facultatif |Check if you want to publish the close report |=== @@ -74,29 +74,29 @@ To close a a meeting: . Sign in as the participant that created the meeting . Go to the meeting page . Click on "Close". This will only be visible after the meeting has passed -. Fill the form +. Remplissez le formulaire image:components/meetings/close/form_frontend.png[Close meeting form in the frontend] .Close meeting form (frontend) |=== -|Field |Type |Description +|Champ |Type |Description |Minutes -|Required +|Obligatoire |Description of what happened in the meeting. |Number of attendees -|Required +|Obligatoire |Metadata that gets shown in the sidebar of the meeting. Must be a number. -|Proposals -|Optional +|Propositions +|Facultatif |Choose proposals from this space that were discussed in this meeting |=== -== Proposals +== Propositions If you relate a proposal to a meeting, the meeting also will be shown in the proposal. From e0dd409f5bced30ed2da8350eccd284710652076 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:50 +0200 Subject: [PATCH 149/336] New translations polls.adoc (French) --- docs/fr/modules/admin/pages/components/meetings/polls.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/fr/modules/admin/pages/components/meetings/polls.adoc b/docs/fr/modules/admin/pages/components/meetings/polls.adoc index 99c7b70291..46584e523a 100644 --- a/docs/fr/modules/admin/pages/components/meetings/polls.adoc +++ b/docs/fr/modules/admin/pages/components/meetings/polls.adoc @@ -15,12 +15,12 @@ To enable polls for a meeting: . Sign in as admin . Go to admin panel -. In the main sidebar, click in the button for the space that you want to configure the component for. +. Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. For instance, it could be "Processes", "Assemblies", or "Conferences" . Click on "Meetings" . Search the meeting that you want to define polls for . Click on the "Manage polls" button image:action_list.png[Manage polls button] -. Fill the form +. Remplissez le formulaire The form is pretty much the Decidim form builder, with one caveat: you can only define Single and Multiple option questions. From ce6a9d5cf4bcb8b6e6f0ed9365763fb47e00bec1 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:51 +0200 Subject: [PATCH 150/336] New translations registrations.adoc (French) --- .../pages/components/meetings/registrations.adoc | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/fr/modules/admin/pages/components/meetings/registrations.adoc b/docs/fr/modules/admin/pages/components/meetings/registrations.adoc index 71f3b3adb2..49466995d5 100644 --- a/docs/fr/modules/admin/pages/components/meetings/registrations.adoc +++ b/docs/fr/modules/admin/pages/components/meetings/registrations.adoc @@ -24,7 +24,7 @@ To enable registrations for a meeting: . Sign in as admin . Go to admin panel -. In the main sidebar, click in the button for the space that you want to configure the component for. +. Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. For instance, it could be "Processes", "Assemblies", or "Conferences" . Click on "Meetings" . Search the meeting that you want to enable registrations for @@ -34,7 +34,7 @@ For instance, it could be "Processes", "Assemblies", or "Conferences" . Click on the "Update" button . Click on the "Registrations" button image:action_registrations.png[Registrations button] . Check the "Registrations enabled" checkbox -. Fill the form +. Remplissez le formulaire == Registrations settings form @@ -43,26 +43,26 @@ image:components/meetings/registrations/backend.png[Registrations settings in a .Registrations settings form |=== -|Field |Type |Description +|Champ |Type |Description |Registrations enabled -|Required +|Obligatoire |Check to enable the registration for this meeting. |Registration form enabled -|Optional +|Facultatif |Check if you want to enable the registration form |Available slots for this meeting -|Required +|Obligatoire |How many slots are available. Leave it to 0 if you have unlimited slots available. |Reserved slots -|Required +|Obligatoire |How many slots are already reserved. Leave it to 0 if you don't have reserved slots |Registration terms -|Required +|Obligatoire |What terms of services participants need to accept to register or join the meeting. |=== From 3c0f4a9710e55dbad6d2e343ceba028b6964a2d7 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:52 +0200 Subject: [PATCH 151/336] New translations pages.adoc (French) --- .../modules/admin/pages/components/pages.adoc | 46 +++++++++---------- 1 file changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/fr/modules/admin/pages/components/pages.adoc b/docs/fr/modules/admin/pages/components/pages.adoc index 6739927552..2d3862899d 100644 --- a/docs/fr/modules/admin/pages/components/pages.adoc +++ b/docs/fr/modules/admin/pages/components/pages.adoc @@ -1,6 +1,6 @@ = Page -The Page component allows people to get information about a space. It's similar to the general xref:admin:pages.adoc[Pages] admin section, with +La fonctionnalité Page permet aux participants d'avoir plus d'information sur un espace. It's similar to the general xref:admin:pages.adoc[Pages] admin section, with the main difference is that this component allows to define pages in a space, and the general Pages admin section allows to define pages for all the platform (for instance, help pages, terms of services, or FAQs), that aren't associated to a space. @@ -13,43 +13,43 @@ Some examples of where this component was used: image:components/page/example01.png[More information page in 2020 Participatory Budgeting process in Decidim Barcelona - Frontend] image:components/page/example02.png[More information page in 2020 Participatory Budgeting process in Decidim Barcelona - Backend] -To configure the Page component: +Pour configurer la fonctionnalité Page : . Sign in as admin . Go to admin panel -. In the main sidebar, click in the button for the space that you want to configure the component for. +. Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. For instance, it could be "Processes", "Assemblies", or "Conferences" -. Go to components -. Click on "Add component" button +. Aller dans les fonctionnalités +. Cliquez sur le bouton "Ajouter une fonctionnalité" . Click on "Page" -. Fill the xref:_add_component[Add component] form +. Remplissez le formulaire xref:_add_component[Ajouter une fonctionnalité] -== Add component +== Ajouter une fonctionnalité image:components/page/component.png[Add component form] .Add component: Page form |=== -|Field |Type |Description +|Champ |Type |Description -|Name -|Required -|What is the title of this component. For instance, "More information". +|Nom +|Obligatoire +|Quel est le titre de cette fonctionnalité. For instance, "More information". -|Order position -|Optional -|Which order will it have in relation to the other pages. Having a lower number means a higher priority. +|Rang d'affichage +|Facultatif +|Which order will it have in relation to the other pages. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two pages, "Page a" with weight "10" and "Page b" with weight "0", then "Page b" will be first when ordering. |=== .Add component: Page form - Global settings |=== -|Field |Type |Description +|Champ |Type |Description -|Announcement -|Optional +|Annonce +|Facultatif |A general announcement that'll be visible on the general pages landing page. |=== @@ -59,14 +59,14 @@ xref:admin:spaces/processes.adoc[Participatory Processes], then you can also def .Add component: Pages form - Step settings |=== -|Field |Type |Description +|Champ |Type |Description -|Announcement -|Optional +|Annonce +|Facultatif |A general announcement that'll be visible on the general page landing page. |=== -== Permissions +== Autorisations As this component doesn't allow to do anything, there are no permissions to set up. @@ -77,9 +77,9 @@ image:components/page/new_page.png[New page form] .New page form |=== -|Field |Type |Description +|Champ |Type |Description |Body -|Required +|Obligatoire |What is the body for the page. |=== \ No newline at end of file From 08893d2f660a6f487aa0c96a6099f9a16338c957 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:54 +0200 Subject: [PATCH 152/336] New translations proposals.adoc (French) --- .../admin/pages/components/proposals.adoc | 214 +++++++++--------- 1 file changed, 107 insertions(+), 107 deletions(-) diff --git a/docs/fr/modules/admin/pages/components/proposals.adoc b/docs/fr/modules/admin/pages/components/proposals.adoc index 5d2b652324..545ea49aad 100644 --- a/docs/fr/modules/admin/pages/components/proposals.adoc +++ b/docs/fr/modules/admin/pages/components/proposals.adoc @@ -1,11 +1,11 @@ -= Proposals += Propositions The Proposals component allows people to create, comment, endorse, and give support to proposals. From this starting point, there could be other configurations, such as: -* how many proposals a participant can create -* how many supports as a maximum a participant can give to proposals +* combien de propositions un participant peut créer +* le nombre maximum de votes qu'un participant peut attribuer aux propositions * how many supports as a minimum a participant must give to proposals so their supports are valid * whether you want to enable that participants comment on proposals * whether you want that proposals have images, attachments, WYSIWYG editor, geolocated address, scopes, etc. @@ -19,160 +19,160 @@ image:components/proposals/example01.png[Proposals list example in COFE] image:components/proposals/example02.png[Proposals list example in Metadecidim] image:components/proposals/example03.png[Proposal detail example in Metadecidim] -To configure the Proposals component: +Pour configurer la fonctionnalité Propositions : . Sign in as admin . Go to admin panel -. In the main sidebar, click in the button for the space that you want to configure the component for. +. Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. For instance, it could be "Processes", "Assemblies", or "Conferences" -. Go to components -. Click on "Add component" button -. Click on "Proposals" -. Fill the xref:_add_component[Add component] form +. Aller dans les fonctionnalités +. Cliquez sur le bouton "Ajouter une fonctionnalité" +. Cliquer sur "Propositions" +. Remplissez le formulaire xref:_add_component[Ajouter une fonctionnalité] -== Add component +== Ajouter une fonctionnalité image:components/proposals/component.png[Add component form] .Add component: Proposals form |=== -|Field |Type |Description +|Champ |Type |Description -|Name -|Required -|What is the title of this component. For instance, "Proposals" +|Nom +|Obligatoire +|Quel est le titre de cette fonctionnalité. Par exemple, "Proposions" -|Order position -|Optional -|Which order will it have in relation to the other components. Having a lower number means a higher priority. +|Rang d'affichage +|Facultatif +|Which order will it have in relation to the other components. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two components, "Proposals" with weight "10" and "Meetings" with weight "0", then "Meetings" will be first when ordering. |=== .Add component: Proposals form - Global settings |=== -|Field |Type |Description +|Champ |Type |Description |Scopes enabled -|Optional +|Facultatif |Check if you want to have Scopes filtering in this component. -|Scope -|Optional +|Secteur +|Facultatif |Which xref:admin:scopes.adoc[Scope] does this component belongs to. -|Support limit per participant -|Optional +|Limite de votes par utilisateur +|Facultatif |Must be a number. How much supports a participant can give to proposals. -|Minimum supports per user -|Optional +|Nombre minimum de votes par utilisateur +|Facultatif |Must be a number. How many supports does a participant needs to give to proposals so their supports are counted. If she doesn't reach this number, her supports will not be taken in account. -|Proposal limit per participant -|Optional -|Must be a number. How many proposals a participant can create. +|Limite de proposition par participant +|Facultatif +|Must be a number. Combien de propositions un participant peut créer. -|Maximum proposal body length -|Optional +|Longueur maximale du corps de la proposition +|Facultatif |Must be a number. How many characters a proposal body can have as maximum. |Proposal editing -|Required +|Obligatoire |Choose one of these two options: "Allow editing of proposals within a specific timeframe" or "Allow editing proposals for an infinite amount of time". In case it's within a specific timeframe, you must specify the time in "Proposals can be edited by authors before this many minutes passes". Note that if you xref:components/proposals/answers.adoc[answer a proposal] then it can't be edited anymore. -|Proposals can be edited by authors before this many minutes passes +|Délai (en minutes) après lequel les auteurs ne peuvent plus modifier leurs propositions |Required if "Proposal editing" is "Allow editing of proposals within a specific timeframe" |Must be a number. How many minutes after the creation of a proposal it can be edited by its author. -|Threshold per proposal -|Optional -|Must be a number. How many supports a proposal needs to have to be considered as "validated". See <>. +|Seuil par proposition +|Facultatif +|Must be a number. Combien de votes une proposition doit avoir pour être considérée comme "acceptée". See <>. -|Can accumulate supports beyond threshold -|Optional. Only applies if "Threshold per proposal" is configured. +|Peut accumuler des supports au-delà du seuil +|Facultatif. Ne s'applique que si "Seuil par proposition" est configuré. |Whether the proposal can accumulate more supports than the threshold. -|Proposal answering enabled -|Optional +|Réponses aux propositions activées +|Facultatif |Whether administrators or valuators can answer proposals. -|Official proposals enabled -|Optional +|Propositions officielles activées +|Facultatif |Wheter administrators can create official proposals. -|Comments enabled -|Optional -|Whether you want to have comments in the meetings. +|Commentaires activés +|Facultatif +|Si vous voulez avoir des commentaires dans les rencontres. -|Comments max length -|Optional +|Longueur maximale des commentaires +|Facultatif |What are the characters limit that participants will have when making comments. Leave 0 for the default value. -|Geocoding enabled -|Optional +|Géocodage activé +|Facultatif |Wheter participants can define a geocoding address for their proposals. Need to have xref:configure:geocoding[Geocoding] enabled. See <>. |Allow attachments -|Optional +|Facultatif |Check to allow participants to attach files to their proposals. |Allow card image -|Optional +|Facultatif |Check to show a card image when participants attach images to their proposals. See <>. |Actions permissions can be set for each proposal -|Optional +|Facultatif |Whether you want to be able to set permissions for every one of the proposals. Most of the time you will want to leave this option disabled. |Collaborative drafts enabled -|Optional +|Facultatif |Check to enable xref:components/proposals/collaborative_drafts.adoc[collaborative drafts] in proposals. |Participatory texts enabled -|Optional +|Facultatif |Check to enable xref:components/proposals/participatory_texts.adoc[participatory texts] in proposals. |Amendments enabled -|Optional +|Facultatif |Check to enable xref:components/proposals/amendments.adoc[amendments] in proposals. If active, configure Amendment features for each step. |Amendments Wizard help text -|Optional. Visible if the "Amendments enabled" option is checked. +|Facultatif. Visible if the "Amendments enabled" option is checked. |What's the help text visible when creating new amendments. -|Announcement -|Optional +|Annonce +|Facultatif |A general announcement that'll be visible on the general proposals landing page. |New proposal body template -|Optional +|Facultatif |A pre-defined text that will be used when creating new proposals. Useful if you want to define a format that participants need to follow when creating new proposals. |New proposal help text -|Optional +|Facultatif |What's the help text visible when creating new proposals. |Proposal wizard "Create" step help text -|Optional +|Facultatif |What's the help text visible when creating new proposals in the "Create" step. |Proposal wizard "Compare" step help text -|Optional +|Facultatif |What's the help text visible when creating new proposals in the "Compare" step. |Proposal wizard "Complete" step help text -|Optional +|Facultatif |What's the help text visible when creating new proposals in the "Complete" step. |Proposal wizard "Publish" step help text -|Optional +|Facultatif |What's the help text visible when creating new proposals in the "Publish" step. |=== @@ -201,78 +201,78 @@ xref:admin:spaces/processes.adoc[Participatory Processes], then you can also def .Add component: Proposals form - Step settings |=== -|Field |Type |Description +|Champ |Type |Description -|Announcement -|Optional +|Annonce +|Facultatif |A general announcement that'll be visible on the general proposal landing page. -|Endorsements enabled -|Optional +|Soutiens activés +|Facultatif |Check if you want that participants show public support for these proposals. -|Endorsements blocked -|Optional +|Soutiens bloqués +|Facultatif |Whether participants will be able to see the endorsments but don't make any. -|Supports enabled -|Optional +|Activer le module de vote simple +|Facultatif |Whether participants will be able to support proposals in this step. -|Supports blocked -|Optional +|Bloquer les votes +|Facultatif |Whether participants will be able to support proposals in this step. |Supports hidden -|Optional +|Facultatif |If supports are enabled, checking this will hide the number of supports. -|Comments blocked -|Optional +|Commentaires désactivés +|Facultatif |Whether you want to enable comments for this phase. |Proposal creation enabled -|Optional +|Facultatif |Whether you want to enable proposal creation by participants for this phase. See xref:_new_proposal_form[New proposal form] -|Proposal answering enabled -|Optional +|Réponses aux propositions activées +|Facultatif |Whether you want to enable xref:components/proposals/answers.adoc[proposal answering]. |Publish proposal answers immediately -|Optional +|Facultatif |Wheter you want that the answers of proposals are published at the same time that you're xref:components/proposals/answers.adoc[answering] them or you want to control when to publish the answers. -|Enable costs on proposal answers -|Optional +|Activer les coûts sur les réponses aux propositions +|Facultatif |Wheter you want to add economical costs to proposal answers. Useful for importing to xref:components/budgets.adoc[budgets]. -|Amendment creation enabled -|Optional. Visible if "Amendments enabled" option is checked. +|Création d'amendement activée +|Facultatif. Visible si l'option "Amendements activés" est cochée. |Participant can amend proposals. See xref:components/proposals/amendments.adoc[Amendments]. |Amendment reaction enabled -|Optional. Visible if "Amendments enabled" option is checked. +|Facultatif. Visible si l'option "Amendements activés" est cochée. |Proposal's authors will be able to accept or reject Participant's emendations. |Amendment promotion enabled -|Optional. Visible if "Amendments enabled" option is checked. +|Facultatif. Visible si l'option "Amendements activés" est cochée. |Emandation authors will be able to promote to Proposal the rejected emendation. |Amendments visibility -|Required. Visible if "Amendments enabled" option is checked. +|Required. Visible si l'option "Amendements activés" est cochée. |Choose one of "Amendments are visible to all" or "Amendments are visible only to their authors" -|Announcement -|Optional +|Annonce +|Facultatif |A general announcement that'll be visible on the general proposals landing page. |Hashtags added to all proposals -|Optional +|Facultatif |Automatically add a hashtag to every proposal. See <>. |Hashtags suggested to participants for new proposals -|Optional +|Facultatif |Suggest hashtags to participants for new proposals. Participants can select more than one hashtag. See <>. |=== @@ -281,17 +281,17 @@ xref:admin:spaces/processes.adoc[Participatory Processes], then you can also def image::components/proposals/setting_hashtag.png[Example of hashtag setting] -== Permissions +== Autorisations An administrator can choose which kind of xref:customize:authorizations.adoc[Authorizations] a participant need to have to make certain actions in the proposals: -* Endorse +* Soutenir * Support * Create * Withdraw * Amend -* Comment +* Commenter * Vote comment == Manage proposals @@ -330,15 +330,15 @@ Body by default) or very long (Title, Body, Hashtags, Address, Scope, Category, .New proposal form - default (by a participant) |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |What is the title of this proposal. For instance, "Bike lane in Main Street". Must have at least 15 characters as minimum and 150 characters as maximum. Must start with a capital letter. |Body -|Optional +|Facultatif |What is the full description for this proposal. Must have at least 15 characters as minimum and 450 characters as maximum by default but can be changed with the setting "Maximum proposal body length". |=== @@ -370,20 +370,20 @@ image:components/proposals/new_proposal_backend01.png[New proposal form - defaul .New proposal form - default (official proposals) |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |What is the title of this proposal. For instance, "Bike lane in Main Street". Must have at least 15 characters as minimum and 150 characters as maximum. Must start with a capital letter. |Body -|Optional +|Facultatif |What is the full description of this proposal. Must have at least 15 characters as minimum and 450 characters as maximum by default but can be changed with the setting "Maximum proposal body length". |This proposal comes from a meeting -|Optional +|Facultatif |Check if this proposal comes from a meeting. |Select a meeting @@ -402,7 +402,7 @@ image:components/proposals/new_proposal_backend02.png[New proposal form - with m .Actions |=== -|Icon |Name |Definition +|Icône |Nom |Definition |image:action_edit.png[Edit icon] |Edit @@ -413,12 +413,12 @@ image:components/proposals/new_proposal_backend02.png[New proposal form - with m |Allows you to answer a proposal. |image:action_permissions.png[Permissions icon] -|Permissions +|Autorisations | |image:action_preview.png[Preview icon] |Preview -|To see how it's shown in the frontend to participants. +|Pour voir comment il est montré dans le frontend aux participants. |=== == Origin filter From 2cb672b8575d868a4d25d1c6ccbf2236326b6d33 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:55 +0200 Subject: [PATCH 153/336] New translations amendments.adoc (French) --- .../components/proposals/amendments.adoc | 123 +++++++++--------- 1 file changed, 61 insertions(+), 62 deletions(-) diff --git a/docs/fr/modules/admin/pages/components/proposals/amendments.adoc b/docs/fr/modules/admin/pages/components/proposals/amendments.adoc index be89e58eb5..e39b209d94 100644 --- a/docs/fr/modules/admin/pages/components/proposals/amendments.adoc +++ b/docs/fr/modules/admin/pages/components/proposals/amendments.adoc @@ -1,94 +1,93 @@ -= Amendments += Amendements -With the amendment feature, participants can propose changes to an already published proposal. +Grâce à la fonctionnalité d'amendement, les participants peuvent proposer des modifications à une proposition déjà publiée. -It's useful to propose improvements or corrections, specially useful when redacting laws or normatives with xref:components/proposals/participatory_texts.adoc[Participatory Texts]. +Il est utile de proposer des améliorations ou des corrections, particulièrement utile lors de la rédaction de lois ou autre avec xref:components/propositions/participatory_texts.adoc[Textes participatifs]. -It has similarities with xref:components/proposals/collaborative_drafts.adoc[Collaborative Drafts], but the main difference -is that with amendments there is no need to trust the other authors intentions, as every change is reviewed and must be -approved by the author of the original proposal. +Il y a des similitudes avec les xref:components/proposals/collaborative_drafts. doc[Brouillons collaboratifs], mais la principale différence +est qu'avec les amendements chaque changement est relu et doit être +approuvé par l'auteur de la proposition. -image:components/proposals/amendments/amendment.png[Amendment of a proposal] +image:composents/propositions/amendements/amendement.png[Amendement d'une proposition] -To configure "Amendments" in proposals component: +Pour configurer les "Amendements" dans le module de propositions: . Sign in as admin . Go to admin panel -. In the main sidebar, click in the button for the space that you want to configure the component for. +. Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. For instance, it could be "Processes", "Assemblies", or "Conferences" -. Go to components -. Click on "Add component" button -. Click on "Proposals" -. Check the "Amendments enabled" setting -. Review and configure the following related settings: "Amendments Wizard help text" in global component settings and "Amendment creation enabled", "Amendment reaction enabled", "Amendment promotion enabled", and "Amendments visibility" in the step component settings. -. Save the component - -== How it works - -. A participant (Alice) has created a proposal -. Another participant (Bob) has seen the proposal and wants to make some changes -image:components/proposals/amendments/proposal_to_amend.png[] -. Bob click on the "Amend proposal" button -. Bob makes the changes in the "Create amendment draft" form -image:components/proposals/amendments/create_amendment_draft.png[] -. Bob checks if there is any similar amendment -. Bob edits the amendment draft -image:components/proposals/amendments/edit_amendment_draft.png[] -. Bob publishes the amendment draft -image:components/proposals/amendments/publish_amendment_draft.png[] -. Anyone can see the amendment draft -image:components/proposals/amendments/proposal_amendmed.png[] -image:components/proposals/amendments/amendment_list.png[] -image:components/proposals/amendments/amendment_view_side_by_side.png[] -. It's also possible to filter the amended proposals -image:components/proposals/amendments/amendment_list_filter.png[] -. Alice receives a notification that Bob has proposed an amendment to her original proposal -image:components/proposals/amendments/proposal_amendmed_notification.png[] -. Alice can see the amendment proposal -image:components/proposals/amendments/proposal_amendmed_to_review.png[] -. Alice can review the amendment proposal -image:components/proposals/amendments/proposal_amendmed_review.png[] -. Alice can approve the amendment proposal -image:components/proposals/amendments/proposal_amendmed_accepted.png[] -. Anyone can see the final proposal -image:components/proposals/amendments/proposal_amendmed_final.png[] -image:components/proposals/amendments/proposal_amendmed_amendment_list.png[] -. Anyone can see the versions history of the proposal -image:components/proposals/amendments/proposal_amendmed_versions.png[] - -== Relevant component settings - - -.Proposals component form - Settings related to amendments +. Aller dans les fonctionnalités +. Cliquez sur le bouton "Ajouter une fonctionnalité" +. Cliquer sur "Propositions" +. Cochez la case de configuration "Amendements activés" +. Examinez et configurez les paramètres de configuration suivants : "Texte d'aide de l'assistant" dans les paramètres globaux des composants et "Création d'amendement activée","Réaction aux amendements activée", "Promotion d'amendement activée" et "Visibilité des amendements" dans les paramètres du composant d'étape. +. Enregistrez le composant + +== Comment ça marche + +. Une participante (Alice) a créé une proposition +. Un autre participant (Bob) a vu la proposition et veut apporter des modifications +image:composents/propositions/amendements/proposal_to_amende.png[Proposition à amender] +. Bob clique sur le bouton "Amender" +. Bob fait les modifications dans le formulaire "Créer un brouillon d'amendement" +image:composents/propositions/amendements/create_amendement_draft.png[] +. Bob vérifie qu'il n'y ait pas d'amendement similaire +. Bob modifie le brouillon d'amendement +image:components/proposs/amendements/edit_amendement_draft.png[] +. Bob publie le brouillon d'amendement +image:components/proposs/amendements/publish_amendement_draft.png[] +. Tout le monde peut voir la proposition d'amendement +image:components/proposals/amendements/amendements/amendemed.png[] +image:components/proposals/amendements/amendements/amendement_list.png[] +image:components/proposals/amendements/amendements/amendement_view_side_by_side.png[] +. Il est également possible de filtrer les propositions amendées +image:composents/propositions/amendements/amendement_list_filter.png[] +. Alice reçoit une notification que Bob a proposé un amendement à sa proposition originale +image:components/propositions/amendements/proposal_amendemed_notification.png[] +. Alice peut voir la proposition d'amendement +image:components/proposs/amendements/proposal_amendemed_to_review.png[] +. Alice peut examiner la proposition d'amendement +image:components/proposs/amendements/proposal_amendemed_review.png[] +. Alice peut approuver la proposition d'amendement +image:components/proposs/amendements/proposal_amendemed_accepted.png[] +. Tout le monde peut voir la proposition finale +image:components/proposs/amendements/amendements/proposal_amendemed_final.png[] +image:components/proposals/amendements/amendement_amendement_list.png[] +. Tout le monde peut voir l'historique des versions de la proposition +image:composents/propositions/amendements/proposal_amendemed_versions.png[] + +== Paramètres pertinents du composant + + +.Formulaire du module Propositions - Paramètres liés aux amendements |=== -|Field |Type |Description +|Champ |Type |Description |Amendments enabled |Global -|Check to enable xref:components/proposals/amendments.adoc[amendments] in proposals. Other settings visible when enabling one. +|Check to enable xref:components/proposals/amendments.adoc[amendments] in proposals. Autres paramètres visibles en activant un. |Amendments Wizard help text |Global |What's the help text visible when creating new amendments. -|Amendment creation enabled -|Step +|Création d'amendement activée +|Étape |Participant can amend proposals. See xref:components/proposals/amendments.adoc[Amendments]. |Amendment reaction enabled -|Step +|Étape |Proposal's authors will be able to accept or reject Participant's emendations. |Amendment promotion enabled -|Step +|Étape |Emandation authors will be able to promote to Proposal the rejected emendation. |Amendments visibility -|Step +|Étape |Choose one of "Amendments are visible to all" or "Amendments are visible only to their authors" |=== == Promotion -If a proposal is rejected and the "Amendment promotion enabled" is enabled, then the author that have made the rejected -amendment will be able to promote to a new proposal the rejected emendation. \ No newline at end of file +Si une proposition est rejetée et que la fonction "Promotion d'amendements activée" est activée, alors l'auteur de l'amendement rejeté pourra le promouvoir en tant que nouvelle proposition. \ No newline at end of file From 63af482071eddcc7f9503888a854505219651bf8 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:56 +0200 Subject: [PATCH 154/336] New translations answers.adoc (French) --- .../admin/pages/components/proposals/answers.adoc | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/fr/modules/admin/pages/components/proposals/answers.adoc b/docs/fr/modules/admin/pages/components/proposals/answers.adoc index 8e1d8238b1..78c5d6c9fa 100644 --- a/docs/fr/modules/admin/pages/components/proposals/answers.adoc +++ b/docs/fr/modules/admin/pages/components/proposals/answers.adoc @@ -8,19 +8,19 @@ For answering a proposal: . Sign in as admin or valuator . Go to admin panel -. In the main sidebar, click in the button for the space that you want to configure the component for. +. Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. For instance, it could be "Processes", "Assemblies", or "Conferences" . Click in the "Proposals" component . Search the proposal you want to answer . Click in the "Proposal answer" button image:action_answer.png[Answer proposal icon] -. Fill the form +. Remplissez le formulaire Alternatively, you could also: . Sign in as admin or valuator . Navigate to the proposal you want to answer . Click in the proposal answer button in the header image:components/proposals/answer_button_header.png[Answer proposal button] -. Fill the form +. Remplissez le formulaire == Answer page @@ -43,14 +43,14 @@ image:components/proposals/proposal_answer.png[Proposal answer form] .Answer for proposal form |=== -|Field |Type |Description +|Champ |Type |Description |Internal state -|Required +|Obligatoire |Choose one of the following: Accepted, Rejected, or Evaluating |Answer -|Optional +|Facultatif |An explanation on why the proposal was accepted, rejected, or evaluated |Cost @@ -98,7 +98,7 @@ On the other hand, if you want to control when to publish the answer a proposal . Sign in as admin or valuator . Go to admin panel -. In the main sidebar, click in the button for the space that you want to configure the component for. +. Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. For instance, it could be "Processes", "Assemblies", or "Conferences" . Click in the "Proposals" component . Search the proposal you want to answer From 20d6e933ff005af8378b3240b683128864f65540 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:57 +0200 Subject: [PATCH 155/336] New translations collaborative_drafts.adoc (French) --- .../components/proposals/collaborative_drafts.adoc | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/fr/modules/admin/pages/components/proposals/collaborative_drafts.adoc b/docs/fr/modules/admin/pages/components/proposals/collaborative_drafts.adoc index 9c26ef25e2..5a79206c3f 100644 --- a/docs/fr/modules/admin/pages/components/proposals/collaborative_drafts.adoc +++ b/docs/fr/modules/admin/pages/components/proposals/collaborative_drafts.adoc @@ -14,15 +14,15 @@ To configure "Collaborative Drafts" in Proposals component: . Sign in as admin . Go to admin panel -. In the main sidebar, click in the button for the space that you want to configure the component for. +. Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. For instance, it could be "Processes", "Assemblies", or "Conferences" -. Go to components -. Click on "Add component" button -. Click on "Proposals" +. Aller dans les fonctionnalités +. Cliquez sur le bouton "Ajouter une fonctionnalité" +. Cliquer sur "Propositions" . Check the "Collaborative drafts enabled" setting -. Save the component +. Enregistrez le composant -== How it works +== Comment ça marche . A participant (Alice) wants to create a collaborative draft. For that, she goes to the proposals list page. . Alice clicks in the "Access collaborative drafts" button From e643514fcb819b43f3dd3db100ed148ae41bd24f Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:58 +0200 Subject: [PATCH 156/336] New translations participatory_texts.adoc (French) --- .../proposals/participatory_texts.adoc | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/fr/modules/admin/pages/components/proposals/participatory_texts.adoc b/docs/fr/modules/admin/pages/components/proposals/participatory_texts.adoc index c5573a6e6d..113212a8e5 100644 --- a/docs/fr/modules/admin/pages/components/proposals/participatory_texts.adoc +++ b/docs/fr/modules/admin/pages/components/proposals/participatory_texts.adoc @@ -17,13 +17,13 @@ To configure the "Participatory texts" in proposals component: . Sign in as admin . Go to admin panel -. In the main sidebar, click in the button for the space that you want to configure the component for. +. Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. For instance, it could be "Processes", "Assemblies", or "Conferences" -. Go to components -. Click on "Add component" button -. Click on "Proposals" +. Aller dans les fonctionnalités +. Cliquez sur le bouton "Ajouter une fonctionnalité" +. Cliquer sur "Propositions" . Check the "Participatory texts enabled" setting -. Save the component +. Enregistrez le composant . Click in the "Participatory texts" button in the empty proposals component image:components/proposals/participatory_texts/manage_proposals.png[Manage proposals] . Click in the "Import document" button in the empty Preview participatory text panel @@ -56,18 +56,18 @@ image:components/proposals/participatory_texts/add_document_form.png[Add documen .Add document form |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |What's the title of the document? |Description -|Optional +|Facultatif |Description for the document |Document -|Required +|Obligatoire |File. Add a document lesser than 2MB, each section until 3 levels deep will be parsed into proposals. Supported formats are: Markdown, ODT |=== From 37ea857cb1f5d57b5ec5def093557edd150c22bd Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:58:59 +0200 Subject: [PATCH 157/336] New translations skeleton.adoc (French) --- .../admin/pages/components/skeleton.adoc | 94 +++++++++---------- 1 file changed, 47 insertions(+), 47 deletions(-) diff --git a/docs/fr/modules/admin/pages/components/skeleton.adoc b/docs/fr/modules/admin/pages/components/skeleton.adoc index a0bbfcdb51..7d7fb98012 100644 --- a/docs/fr/modules/admin/pages/components/skeleton.adoc +++ b/docs/fr/modules/admin/pages/components/skeleton.adoc @@ -19,63 +19,63 @@ To configure the Skeleton component: . Sign in as admin . Go to admin panel -. In the main sidebar, click in the button for the space that you want to configure the component for. -For instance, it could be "Processes", "Assemblies" or "Conferences". -. Go to components -. Click on "Add component" button +. Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. +Par exemple, il peut s'agir de "Concertations", d'"Assemblées" ou de "Conférences". +. Aller dans les fonctionnalités +. Cliquez sur le bouton "Ajouter une fonctionnalité" . Click on "Skeleton" -. Fill the xref:_add_component[Add component] form +. Remplissez le formulaire xref:_add_component[Ajouter une fonctionnalité] -== Add component +== Ajouter une fonctionnalité image:components/skeleton/component.png[Add component form] .Add component: Skeleton form |=== -|Field |Type |Description +|Champ |Type |Description -|Name -|Required -|What is the title of this component. For instance, "Skeletons" +|Nom +|Obligatoire +|Quel est le titre de cette fonctionnalité. For instance, "Skeletons" -|Order position -|Optional -|Which order will it have in relation to the other skeletons. Having a lower number means a higher priority. +|Rang d'affichage +|Facultatif +|Which order will it have in relation to the other skeletons. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two skeletons, "Skeleton a" with weight "10" and "Skeleton b" with weight "0", then "Skeleton b" will be first when ordering. |=== .Add component: Skeleton form - Global settings |=== -|Field |Type |Description +|Champ |Type |Description |Scopes enabled -|Optional +|Facultatif |Check if you want to have Scopes filtering in this component. -|Scope -|Optional +|Secteur +|Facultatif |Which xref:admin:scopes.adoc[Scope] does this component belongs to. -|Global scope -|Optional +|Portée générale +|Facultatif | -|Comments enabled -|Optional -|Whether you want to have comments in the meetings. +|Commentaires activés +|Facultatif +|Si vous voulez avoir des commentaires dans les rencontres. -|Comments max length -|Optional -|What is the characters limit that participants will have when making comments. Leave 0 for default value. +|Longueur maximale des commentaires +|Facultatif +|Quelle est la limite de caractères que les participants auront quand ils feront des commentaires. Laisser 0 pour la valeur par défaut. |Actions permissions can be set for each skeleton -|Optional +|Facultatif |Whether you want to be able to set permissions for every one of the skeletons. Most of the time you will want to leave this option disabled. -|Announcement -|Optional +|Annonce +|Facultatif |A general announcement that'll be visible on the general skeletons landing page. |=== @@ -85,24 +85,24 @@ xref:admin:spaces/processes.adoc[Participatory Processes], then you can also def .Add component: Skeletons form - Step settings |=== -|Field |Type |Description +|Champ |Type |Description -|Comments blocked -|Optional +|Commentaires désactivés +|Facultatif |Whether you want to enable comments for this phase. -|Announcement -|Optional +|Annonce +|Facultatif |A general announcement that'll be visible on the general skeleton landing page. |=== -== Permissions +== Autorisations An administrator can choose which kind of xref:customize:authorizations.adoc[Authorizations] a participant need to have to make certain actions in the skeletons: * Create -* Endorse +* Soutenir == Manage skeletons @@ -126,19 +126,19 @@ image:components/skeleton/new_skeleton.png[New skeleton form] .New skeleton form |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |What is the title of this skeleton. For instance, "District A" -|Order position -|Optional -|Which order will it have in relation to the other skeletons. Having a lower number means a higher priority. +|Rang d'affichage +|Facultatif +|Which order will it have in relation to the other skeletons. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two skeletons, "Skeleton a" with weight "10" and "Skeleton b" with weight "0", then "Skeleton b" will be first when ordering. |Description -|Optional +|Facultatif |What is the description of this skeleton. |=== @@ -147,14 +147,14 @@ For instance, if you have two skeletons, "Skeleton a" with weight "10" and "Skel .Actions |=== -|Icon |Name |Definition +|Icône |Nom |Definition |image:action_preview.png[Preview icon] |Preview -|To see how it's shown in the frontend to participants. +|Pour voir comment il est montré dans le frontend aux participants. -|image:action_list.png[Manage projects icon] -|xref:_manage_projects[Manage projects] +|image:action_list.png[Gérer l'icône des projets] +|xref:_manage_projects[Gérer les projets] |Allows you to manage the projects of a skeleton. |image:action_edit.png[Edit icon] @@ -163,5 +163,5 @@ For instance, if you have two skeletons, "Skeleton a" with weight "10" and "Skel |image:action_delete.png[Delete icon] |Delete -|To delete this skeleton. Only can be done when there aren't any projects. +|To delete this skeleton. Peut être fait unquement quand il n'y a pas de projets dans ce budget. |=== \ No newline at end of file From 45275a33e1d1bd2317da00581a57eeb5888840bd Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:00 +0200 Subject: [PATCH 158/336] New translations surveys.adoc (French) --- .../admin/pages/components/surveys.adoc | 74 +++++++++---------- 1 file changed, 37 insertions(+), 37 deletions(-) diff --git a/docs/fr/modules/admin/pages/components/surveys.adoc b/docs/fr/modules/admin/pages/components/surveys.adoc index 2b4fc6689a..a30679d2e5 100644 --- a/docs/fr/modules/admin/pages/components/surveys.adoc +++ b/docs/fr/modules/admin/pages/components/surveys.adoc @@ -22,57 +22,57 @@ To configure the Survey component: . Sign in as admin . Go to admin panel -. In the main sidebar, click in the button for the space that you want to configure the component for. -For instance, it could be "Processes", "Assemblies" or "Conferences". -. Go to components -. Click on "Add component" button +. Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. +Par exemple, il peut s'agir de "Concertations", d'"Assemblées" ou de "Conférences". +. Aller dans les fonctionnalités +. Cliquez sur le bouton "Ajouter une fonctionnalité" . Click on "Survey" -. Fill the xref:_add_component[Add component] form +. Remplissez le formulaire xref:_add_component[Ajouter une fonctionnalité] Once a survey is already answered by some users it's not possible to modify its questions, as that would affect the integrity of the answers. If it's needed to modify the questions, then it's needed to create a new survey and unpublish the original one. -== Add component +== Ajouter une fonctionnalité image:components/surveys/component.png[Add component form] .Add component: Survey form |=== -|Field |Type |Description +|Champ |Type |Description -|Name -|Required -|What is the title of this component. For instance, "Surveys" +|Nom +|Obligatoire +|Quel est le titre de cette fonctionnalité. For instance, "Surveys" -|Order position -|Optional -|Which order will it have in relation to the other surveys. Having a lower number means a higher priority. +|Rang d'affichage +|Facultatif +|Which order will it have in relation to the other surveys. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two surveys, "Survey a" with weight "10" and "Survey b" with weight "0", then "Survey b" will be first when ordering. |=== .Add component: Survey form - Global settings |=== -|Field |Type |Description +|Champ |Type |Description |Scopes enabled -|Optional +|Facultatif |Check if you want to have Scopes filtering in this component. -|Scope -|Optional +|Secteur +|Facultatif |Which xref:admin:scopes.adoc[Scope] does this component belongs to. |Answers accepted from -|Optional +|Facultatif |Start date when you want to receive answers. Leave blank for no specific date. Expected format: dd/mm/yyyy hh:ii |Answers accepted until |End date when you want to stop receiving answers. Leave blank for no specific date. Expected format: dd/mm/yyyy hh:ii -|Announcement +|Annonce -|Optional +|Facultatif |A general announcement that'll be visible on the general surveys landing page. |Delete answers when publishing the survey |=== @@ -83,24 +83,24 @@ xref:admin:spaces/processes.adoc[Participatory Processes], then you can also def .Add component: Surveys form - Step settings |=== -|Field |Type |Description +|Champ |Type |Description |Allow answers -|Optional +|Facultatif |Check if you want to receive answers in this survey. |Allow unregistered users to answer the survey -|Optional +|Facultatif |If active, no login will be required in order to answer the survey. This may lead to poor or unreliable data and it will be more vulnerable to automated attacks. Use with caution! Mind that this option only allows an answer by browser session, but participants can use the Private navigation option and make multiple answers with the same device. -|Announcement -|Optional +|Annonce +|Facultatif |A general announcement that'll be visible on the general survey landing page. |=== -== Permissions +== Autorisations An administrator can choose which kind of xref:customize:authorizations.adoc[Authorizations] a participant need to have to make certain actions in the surveys: @@ -120,18 +120,18 @@ about xref:_templates[Templates]. .New survey form |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |What is the title of this survey. For instance, "Feedback" |Description -|Optional +|Facultatif |What is the description of this survey. |Terms of service -|Required +|Obligatoire |Legal conditions that the participants must agree to in order to answer the survey. |=== @@ -148,26 +148,26 @@ image:components/surveys/question_form.png[] .Add question form |=== -|Field |Type |Description +|Champ |Type |Description |Statement -|Required +|Obligatoire |The question itself. For instance, "What is your age category?" |Description -|Optional +|Facultatif |Explanation of the question being made. |Mandatory -|Optional +|Facultatif |Check if this question is required to respond to submit the answer. |Character limit -|Optional +|Facultatif |How many characters has as a maxim the answer to this question. Leave to 0 if no limit. Compatible with Short and Long answer question types. |Type -|Required +|Obligatoire |One of the following: Short answer, Long answer, Single option, Multiple option, Sorting, Files, Matrix (Single option) or Matrix (Multiple option). See xref:_question_types[Question types] for more information. |=== From 5295d5fa9dd860403f1fad01875c70da7c634ade Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:01 +0200 Subject: [PATCH 159/336] New translations configuration.adoc (French) --- docs/fr/modules/admin/pages/configuration.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/fr/modules/admin/pages/configuration.adoc b/docs/fr/modules/admin/pages/configuration.adoc index eae6e6a6e3..591110e30e 100644 --- a/docs/fr/modules/admin/pages/configuration.adoc +++ b/docs/fr/modules/admin/pages/configuration.adoc @@ -4,7 +4,7 @@ In this page you can configure general settings from Decidim. image::admin_configuration.png[Decidim Admin Configuration] -These are: +Il s'agit de : * **Name**. Required. The name that the platform has. Visible at title, emails, etc. * **Social**. Social handlers for different social networks. Visible at the footer in every page. This are: From 89afa26875f0637a1a15eecf09fd38ab40622cc2 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:02 +0200 Subject: [PATCH 160/336] New translations dashboard.adoc (French) --- docs/fr/modules/admin/pages/dashboard.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/fr/modules/admin/pages/dashboard.adoc b/docs/fr/modules/admin/pages/dashboard.adoc index bf2fc64564..f1f10650c0 100644 --- a/docs/fr/modules/admin/pages/dashboard.adoc +++ b/docs/fr/modules/admin/pages/dashboard.adoc @@ -15,7 +15,7 @@ You'll have three blocks: 1. Activity: participants and admins that had logged in in last month, last week and last day. 1. Metrics: the graphics for the evolution of multiple things inside of Decidim: * Participants -* Proposals +* Propositions * Comments * Meetings * Accepted proposals From 2e8f456f9adde2c15b5d843c39e17eacca3e35e8 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:04 +0200 Subject: [PATCH 161/336] New translations badges.adoc (French) --- docs/fr/modules/admin/pages/features/badges.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/fr/modules/admin/pages/features/badges.adoc b/docs/fr/modules/admin/pages/features/badges.adoc index 6cf9a138d3..d488caac7d 100644 --- a/docs/fr/modules/admin/pages/features/badges.adoc +++ b/docs/fr/modules/admin/pages/features/badges.adoc @@ -20,7 +20,7 @@ the fourth level at 60 and the fifth level at 100. .Badges |=== -|Image |Title |Description |How it's earned |Levels +|Image |Titre |Description |How it's earned |Levels |image:features/badges/accepted_proposals_badge.png[Accepted proposals badge] |Accepted proposals @@ -69,7 +69,7 @@ and this badge is not available, so it'll be removed in the future. |5, 15, 50, 100, 500 |image:features/badges/proposals_badge.png[Proposals badge] -|Proposals +|Propositions |Granted when participants actively participate with new proposals. |The participant needs to choose the participation space of her interest with submission for proposals enabled and create a new proposal. |1, 5, 10, 30, 60 From 82b2c92b2dc1c02074bd216c169c34c96c744f70 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:05 +0200 Subject: [PATCH 162/336] New translations conversations.adoc (French) --- docs/fr/modules/admin/pages/features/conversations.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/fr/modules/admin/pages/features/conversations.adoc b/docs/fr/modules/admin/pages/features/conversations.adoc index 4165c50e1d..a30384c5e4 100644 --- a/docs/fr/modules/admin/pages/features/conversations.adoc +++ b/docs/fr/modules/admin/pages/features/conversations.adoc @@ -22,7 +22,7 @@ Alternatively, you could also: . Click on the conversation icon in the header image:icon_envelope_off.png[Conversations icon] . Click on the "Start conversation" button . Search the participant or group that you want to start a conversation with -. Fill the form +. Remplissez le formulaire If there are new messages in a conversation, then the participant will see the icon with a color image:icon_envelope_on.png[Conversation icon with color] @@ -38,7 +38,7 @@ For this, you need to: . Click on the conversation icon in the header image:icon_envelope_off.png[Conversations icon] . Click on the "Start conversation" button . Search the participants or groups that you want to start a conversation with -. Fill the form +. Remplissez le formulaire image:features/conversations/new_conversation_modal.png[New conversation modal] From caaed8f84735758b1d00fd79965d16cd3b81b560 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:06 +0200 Subject: [PATCH 163/336] New translations account.adoc (French) --- .../admin/pages/features/my_account/account.adoc | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/fr/modules/admin/pages/features/my_account/account.adoc b/docs/fr/modules/admin/pages/features/my_account/account.adoc index f1352a9738..ae32dca82c 100644 --- a/docs/fr/modules/admin/pages/features/my_account/account.adoc +++ b/docs/fr/modules/admin/pages/features/my_account/account.adoc @@ -11,36 +11,36 @@ image:features/my_account/account.png[My account form] .Participant settings - My account form |=== -|Field |Type |Description +|Champ |Type |Description |Avatar -|Optional +|Facultatif |Avatar or picture for the participant. Guidance for image: Preferrably a landscape image that does not have any text. The service crops the image. Maximum file size: 5MB |Your name -|Required +|Obligatoire |The name of the participant. |Nickname -|Required +|Obligatoire |The nickname of the participant. |Your email -|Required +|Obligatoire |The email of the participant, where she'll receive notifications, password recovery, etc. If it's changed it needs to be confirmed. |Personal URL -|Optional +|Facultatif |Metadata that is displayed in the participant's profile. |About -|Optional +|Facultatif |Metadata that is displayed in the participant's profile. |Locale -|Required +|Obligatoire |Choose the language you want to use to browse and receive notifications in Decidim |=== From d0bcfde8e5d5e9530d99b62634b986dd73452b5d Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:07 +0200 Subject: [PATCH 164/336] New translations global_moderations.adoc (French) --- docs/fr/modules/admin/pages/global_moderations.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/fr/modules/admin/pages/global_moderations.adoc b/docs/fr/modules/admin/pages/global_moderations.adoc index bb3d553310..33459c1375 100644 --- a/docs/fr/modules/admin/pages/global_moderations.adoc +++ b/docs/fr/modules/admin/pages/global_moderations.adoc @@ -79,7 +79,7 @@ information it's possible to see it by hovering it. == Actions (when the report wasn't accepted yet) |=== -|Icon |Name |Definition +|Icône |Nom |Definition |image:action_expand.png[Expand icon] |Expand @@ -97,7 +97,7 @@ information it's possible to see it by hovering it. == Actions (after the content is hidden) |=== -|Icon |Name |Definition +|Icône |Nom |Definition |image:action_expand.png[Expand icon] |Expand From cf30c83359cab4ba8680ce9d20bc88e02fef64ac Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:09 +0200 Subject: [PATCH 165/336] New translations newsletters.adoc (French) --- docs/fr/modules/admin/pages/newsletters.adoc | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/fr/modules/admin/pages/newsletters.adoc b/docs/fr/modules/admin/pages/newsletters.adoc index 7c3c069551..d214ce58e3 100644 --- a/docs/fr/modules/admin/pages/newsletters.adoc +++ b/docs/fr/modules/admin/pages/newsletters.adoc @@ -74,10 +74,10 @@ replaced by the recipient's name. .New Newsletter "basic (only text)" form |=== -|Field |Type |Description +|Champ |Type |Description |Subject -|Required +|Obligatoire |Subject of the email. |Body @@ -94,10 +94,10 @@ image::newsletter_new_cta02.png[Newsletter new template text, image and CTA form .New Newsletter "Image, text and Call To Action button" form |=== -|Field |Type |Description +|Champ |Type |Description |Subject -|Required +|Obligatoire |Subject of the email. |Introduction From 3f6e1febde076795d6fa5bb490da3e6ae88140ff Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:10 +0200 Subject: [PATCH 166/336] New translations pages.adoc (French) --- docs/fr/modules/admin/pages/pages.adoc | 32 +++++++++++++------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/fr/modules/admin/pages/pages.adoc b/docs/fr/modules/admin/pages/pages.adoc index 70e77220cd..5e4448b532 100644 --- a/docs/fr/modules/admin/pages/pages.adoc +++ b/docs/fr/modules/admin/pages/pages.adoc @@ -26,30 +26,30 @@ image::pages_backend_form.png[Backend: new page form] .New page form |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |Title of this page. For instance: "How to participate?" |URL Slug -|Required +|Obligatoire |String that will be used on the URL. Use partial paths, not full URLs here. Accepts letters, numbers, dashes and slashes, and must start with a letter. For instance if the slug is "hello-world" and your domain is "https://example.org", your page will be at "https://example.org/hello-world" |Content -|Required +|Obligatoire |All the text of the page. |Topic -|Optional +|Facultatif |In which Topic it'll be in. |Weight -|Optional -|Which order will it have in relation with the other pages. Having a lower number means a higher priority. For instance, if you have two pages, "Page a" with weight "10" and "Page b" with weight "0", then "Page b" will be first when ordering. +|Facultatif +|Which order will it have in relation with the other pages. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two pages, "Page a" with weight "10" and "Page b" with weight "0", then "Page b" will be first when ordering. |Show in the footer -|Optional +|Facultatif |Wether you want to show this page in the general footer (available in every page). |=== @@ -68,22 +68,22 @@ image::pages_backend_topic_form.png[Backend: new topic form] .New topic form |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |Title of this topic. For instance: "Help" |Description -|Optional +|Facultatif |What's this topic is about. |Weight -|Optional -|Which order will it have in relation with the other topics. Having a lower number means a higher priority. For instance, if you have two topics, "Topic a" with weight "10" and "Topic b" with weight "0", then "Topic b" will be first when ordering. +|Facultatif +|Which order will it have in relation with the other topics. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two topics, "Topic a" with weight "10" and "Topic b" with weight "0", then "Topic b" will be first when ordering. |Show in the footer -|Optional +|Facultatif |Wether you want to show this topic in the general footer (available in every page). |=== From 1f8d5798cb8b7c2afb7dd0e16898b309bd438133 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:11 +0200 Subject: [PATCH 167/336] New translations identity_documents.adoc (French) --- .../authorizations/identity_documents.adoc | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/fr/modules/admin/pages/participants/authorizations/identity_documents.adoc b/docs/fr/modules/admin/pages/participants/authorizations/identity_documents.adoc index 2502903d6a..5b4527360a 100644 --- a/docs/fr/modules/admin/pages/participants/authorizations/identity_documents.adoc +++ b/docs/fr/modules/admin/pages/participants/authorizations/identity_documents.adoc @@ -22,10 +22,10 @@ so it's possible to configure this. .ID Documents authorization configuration |=== -|Field |Type |Description +|Champ |Type |Description |Available methods -|Required +|Obligatoire |At least one method must be selected. Options: Online and/or Offline. |Instructions for offline verification @@ -112,18 +112,18 @@ image:authorizations_id_document_offline_confirm.png[ID document authorization o .ID Documents authorization offline flow |=== -|Field |Type |Description +|Champ |Type |Description |Participant email -|Required +|Obligatoire |Email of the registered participant |Type of the document -|Required +|Obligatoire |Can be: DNI, NIE or Passport |Document number (with letter) -|Required +|Obligatoire |Document number of the participant. For instance, "12345678Z" |=== From 17ffac211f3c2a34c1b768a8909164ea2bed6086 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:12 +0200 Subject: [PATCH 168/336] New translations groups.adoc (French) --- .../admin/pages/participants/groups.adoc | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/fr/modules/admin/pages/participants/groups.adoc b/docs/fr/modules/admin/pages/participants/groups.adoc index 3201f6fac9..de06202d06 100644 --- a/docs/fr/modules/admin/pages/participants/groups.adoc +++ b/docs/fr/modules/admin/pages/participants/groups.adoc @@ -15,34 +15,34 @@ image:user_group_new_form.png[New user group form] .New group form |=== -|Field |Type |Description +|Champ |Type |Description -|Name -|Required +|Nom +|Obligatoire |Name of your organization, association, collective, group, etc. |Nickname -|Required +|Obligatoire |Nickname of your organization, association, collective, group, etc. Do not use spaces nor accents. 20 characters maximum. |Email -|Required +|Obligatoire |Email of your organization, association, collective, group, etc. |Avatar -|Optional +|Facultatif |Guidance for image: Preferably a landscape image that does not have any text. The service crops the image. Maximum file size: 5MB. Allowed file extensions: jpg jpeg gif png bmp ico |About -|Optional +|Facultatif |Description of what's this group. |Document number -|Optional +|Facultatif |Used for verifications. Do not use dashes nor spaces. |Phone -|Optional +|Facultatif |Used for verifications. Do not use dashes nor spaces. |=== @@ -103,7 +103,7 @@ There's a dropdown in the form when making a comment: image:user_group_make_comment.png[User group: make a comment] -=== Endorse +=== Soutenir When making an Endorse there's a modal window asking who do you want to make the endorse with: From 91d0b328b26031b6da51ec9259782821e7277564 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:14 +0200 Subject: [PATCH 169/336] New translations participants.adoc (French) --- docs/fr/modules/admin/pages/participants/participants.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/fr/modules/admin/pages/participants/participants.adoc b/docs/fr/modules/admin/pages/participants/participants.adoc index e76ab358b4..0b305f7eda 100644 --- a/docs/fr/modules/admin/pages/participants/participants.adoc +++ b/docs/fr/modules/admin/pages/participants/participants.adoc @@ -14,7 +14,7 @@ image:participants_participants.png[Participants list] image:participants_participants_actions.png[Participants actions] |=== -|Icon |Name |Definition +|Icône |Nom |Definition |image:action_block.png[Block user] |xref:_block_user[Block user] From f95cb3a405f84d236790dd7e22fefeb0ee4c6531 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:15 +0200 Subject: [PATCH 170/336] New translations verifications_conflicts.adoc (French) --- .../admin/pages/participants/verifications_conflicts.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/fr/modules/admin/pages/participants/verifications_conflicts.adoc b/docs/fr/modules/admin/pages/participants/verifications_conflicts.adoc index 1e14b977f6..2b43de75fa 100644 --- a/docs/fr/modules/admin/pages/participants/verifications_conflicts.adoc +++ b/docs/fr/modules/admin/pages/participants/verifications_conflicts.adoc @@ -24,14 +24,14 @@ image:verifications_conflicts_transfer_user.png[] .Transfer user form |=== -|Field |Type |Description +|Champ |Type |Description |Reason -|Required +|Obligatoire |Why you want to transfer the user |Email -|Required +|Obligatoire |The email of the user to transfer |=== From b1a8f835aa564657559e347be2b67bb125e2f7a2 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:16 +0200 Subject: [PATCH 171/336] New translations scopes.adoc (French) --- docs/fr/modules/admin/pages/scopes.adoc | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/fr/modules/admin/pages/scopes.adoc b/docs/fr/modules/admin/pages/scopes.adoc index e189ca92cb..84e6e4ffb1 100644 --- a/docs/fr/modules/admin/pages/scopes.adoc +++ b/docs/fr/modules/admin/pages/scopes.adoc @@ -19,14 +19,14 @@ image:scopes_types_new_form.png[New scope type form] .Admin New Scope Type form |=== -|Field |Type |Description +|Champ |Type |Description |Singular -|Required +|Obligatoire |Name of the scope type in singular. |Plural -|Required +|Obligatoire |Name of the scope type in plural. |=== @@ -35,18 +35,18 @@ image:scopes_new_form.png[New scope form] .Admin New Scope Form |=== -|Field |Type |Description +|Champ |Type |Description -|Name -|Required +|Nom +|Obligatoire |Name of the scope. |Code -|Required +|Obligatoire |(Internal) name of the scope. |Scope type -|Required +|Obligatoire |Which type of scope it's. |=== @@ -55,7 +55,7 @@ image:scopes_new_form.png[New scope form] You have 3 possible actions in this list after a Scope is created: |=== -|Icon |Name |Definition +|Icône |Nom |Definition |image:action_browse.png[Browse icon] |Browse From 1caf64c1d3ca5aee1d2ac13b4e25f6d9417e453e Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:17 +0200 Subject: [PATCH 172/336] New translations assemblies.adoc (French) --- .../admin/pages/spaces/assemblies.adoc | 106 +++++++++--------- 1 file changed, 53 insertions(+), 53 deletions(-) diff --git a/docs/fr/modules/admin/pages/spaces/assemblies.adoc b/docs/fr/modules/admin/pages/spaces/assemblies.adoc index 82c7e1d8a0..5509087f22 100644 --- a/docs/fr/modules/admin/pages/spaces/assemblies.adoc +++ b/docs/fr/modules/admin/pages/spaces/assemblies.adoc @@ -51,97 +51,97 @@ image:assemblies_new_form.png[New assembly form] .New assembly form: General information |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |Title of the assembly. For instance, "General Committee". |Subtitle -|Required +|Obligatoire |Subtitle. For instance, "Let's decide our priorities together" -|Order position -|Required -|Which order will it have in relation with the other assemblies. Having a lower number means a higher priority. For instance, +|Rang d'affichage +|Obligatoire +|Which order will it have in relation with the other assemblies. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two assemblies, "Assembly a" with weight "10" and "Assembly b" with weight "0", then "Assembly b" will be first when ordering. |URL slug -|Required +|Obligatoire |URL slugs are used to generate the URLs that point to this assembly. Only accepts letters, numbers and dashes, and must start with a letter. Example: if your domain is 'example.org' and your slug 'general-committee' then your URL will be https://example.org/assemblies/general-committee |Hashtag -|Optional +|Facultatif |Hashtag for Twitter |Short description -|Required +|Obligatoire |A short explanation of what's your participatory process about. |Description -|Required +|Obligatoire |A long explanation of what's your assembly about. |Purpose of action -|Optional +|Facultatif |Internal field that doesn't get shown publicly. To be removed in a future version. |Composition -|Optional +|Facultatif |Internal field that doesn't get shown publicly. To be removed in a future version. |Internal organisation -|Optional +|Facultatif |Internal field that doesn't get shown publicly. To be removed in a future version. -|Announcement -|Optional +|Annonce +|Facultatif |The text you enter here will be shown to the user right below the assembly information. |=== .New assembly form: Duration |=== -|Field |Type |Description +|Champ |Type |Description |Date created -|Optional +|Facultatif |Information that's displayed in the assembly metadata sidebar. Expected format: dd/mm/yyyy |Included at -|Optional +|Facultatif |Information that's displayed in the assembly metadata sidebar. The date when this assembly was added to Decidim. It does not necessarily have to be the same as the creation date. Expected format: dd/mm/yyyy -|Duration -|Optional +|Durée +|Facultatif |Information that's displayed in the assembly metadata sidebar. If the duration of this assembly is limited, select the end date. Otherwise, it will appear as indefinite. Expected format: dd/mm/yyyy |Closing date -|Optional +|Facultatif |Information that's displayed in the assembly metadata sidebar. When this assembly closed. Expected format: dd/mm/yyyy |Closing date reason -|Optional +|Facultatif |Information that's displayed in the assembly metadata sidebar. Why this assembly closed. |=== .New assembly form: Images |=== -|Field |Type |Description +|Champ |Type |Description |Home image -|Optional +|Facultatif |Image that will be used in presentation cards of this assembly. Guidance for file: Has to be an image or a document. For images, use preferably landscape images that does not have any text, the service crops the image. Maximum file size: 10MB Allowed file extensions: jpeg jpg png |Banner image -|Optional +|Facultatif |Image that will be used inside of the assembly. Guidance for file: Has to be an image or a document. For images, use preferably landscape images that does not have any text, the service crops the image. Maximum file size: 10MB Allowed file extensions: jpeg jpg png @@ -150,72 +150,72 @@ Allowed file extensions: jpeg jpg png .New assembly form: Filters |=== -|Field |Type |Description +|Champ |Type |Description |Scopes enabled -|Optional +|Facultatif |Check if you want to have Scopes filtering in this assembly. -|Scope -|Optional +|Secteur +|Facultatif |Which xref:admin:scopes.adoc[Scope] does this assembly belongs to. |Area -|Optional +|Facultatif |Which xref:admin:areas.adoc[Area] does this assembly belongs to. |=== .New assembly form: Metadata |=== -|Field |Type |Description +|Champ |Type |Description |What is decided -|Optional +|Facultatif |Information that's displayed in the assembly metadata sidebar. |How is it decided -|Optional +|Facultatif |Information that's displayed in the assembly metadata sidebar. |Scope metadata -|Optional +|Facultatif |Information that's displayed in the assembly metadata sidebar. |Promoter group -|Optional +|Facultatif |Information that's displayed in the assembly metadata sidebar. |Organization area -|Optional +|Facultatif |Information that's displayed in the assembly metadata sidebar. |Who participates -|Optional +|Facultatif |Information that's displayed in the assembly metadata sidebar. |=== .New assembly form: Visibility |=== -|Field |Type |Description +|Champ |Type |Description |Parent assembly -|Optional +|Facultatif |What is the assembly that this assembly belongs to. For instance in Metadecidim, the https://meta.decidim.org/assemblies/coordination-committee[Coordination Committee] has the parent assembly of the https://meta.decidim.org/assemblies/general-assembly-association[General%20Assembly%20of%20the%20Decidim%20Association]. |Highlighted -|Optional +|Facultatif |Check if you want the assembly to have more visibility in the Assemblies public list. It'll also be visible in the Assembly Content Block in the xref:admin:homepage.adoc[Homepage] configuration. |Private space -|Optional +|Facultatif |Check if this assembly should only be accessible by xref:admin:spaces/assemblies/private_participants.adoc[Private Participants] |Is transparent -|Optional +|Facultatif |Check if this assembly is private but should be visible to all the rest of participants. This means that other participants or visitors will see it but they won't be able to interact with it. |=== @@ -223,28 +223,28 @@ or visitors will see it but they won't be able to interact with it. .New assembly form: Other |=== -|Field |Type |Description +|Champ |Type |Description |Created by -|Optional +|Facultatif |Choose one of "City Council", "Public" or "Other". If it's Other, you can specify the name of the organization that created this assembly. |Assembly type -|Optional +|Facultatif |Which xref:_assemblies_types[assembly type] is this assembly. |Related processes -|Optional +|Facultatif |Select other participatory processes that are related to this assembly. |Social -|Optional +|Facultatif |Which social networks profile does this assembly has. Can be Twitter, Facebook, Instagram, YouTube and/or GitHub. It's displayed in the assembly metadata sidebar. |Show statistics -|Optional +|Facultatif |Check if you want to show the Statistics section. |=== @@ -276,10 +276,10 @@ image:assemblies_new_type_form.png[New assembly type form] .New assembly type form |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |Title of the this assembly type. For instance, "Consultative". |=== @@ -292,7 +292,7 @@ image:assemblies_settings.png[Assemblies settings] .Settings for assemblies form |=== -|Field |Type |Description +|Champ |Type |Description |Enable organization chart |Checkbox From e546ef56f3db5b549ffba6da4dc52d7a833a00ee Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:18 +0200 Subject: [PATCH 173/336] New translations members.adoc (French) --- .../pages/spaces/assemblies/members.adoc | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/fr/modules/admin/pages/spaces/assemblies/members.adoc b/docs/fr/modules/admin/pages/spaces/assemblies/members.adoc index 64a7159a8f..1b92a79948 100644 --- a/docs/fr/modules/admin/pages/spaces/assemblies/members.adoc +++ b/docs/fr/modules/admin/pages/spaces/assemblies/members.adoc @@ -17,17 +17,17 @@ For creating a new phase of a participatory process: . Click on the assembly Edit action . Click on the Members link in the sidebar . Click on the "New member" button -. Fill the form +. Remplissez le formulaire image:assembly_members_new_form.png[Assembly members new form] .New assembly member form |=== -|Field |Type |Description +|Champ |Type |Description |Participant type -|Required +|Obligatoire |Wheter this assembly member is non-participant or existing participant. Does she already have an account created on the platform? |Full name @@ -39,34 +39,34 @@ image:assembly_members_new_form.png[Assembly members new form] |Type at least three characters to search. |Position -|Required +|Obligatoire |Choose one of President, Vice president, Secretary, or Other. In case it's other, you can fill in the position title. |Weight -|Optional -|Which order will it have in relation to the other members. Having a lower number means a higher priority. For instance, if you have two members, "Member a" with weight "10" and "Member b" with weight "0", then "Member b" will be first when ordering. +|Facultatif +|Which order will it have in relation to the other members. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two members, "Member a" with weight "10" and "Member b" with weight "0", then "Member b" will be first when ordering. |Designation date -|Required +|Obligatoire |When was this person or group assigned as a member of this assembly. Expected format: dd/mm/yyyy |Designation mode -|Optional +|Facultatif |How was this person designed. |Ceased date -|Optional +|Facultatif |When was this person or group ceased to be a member of this assembly. Expected format: dd/mm/yyyy |Gender -|Optional +|Facultatif |Which gender does this person most identify with. |Birthday -|Optional +|Facultatif |When was this person born. Expected format: dd/mm/yyyy |Birthplace -|Optional +|Facultatif |Where was this person born. |=== \ No newline at end of file From f56e092d6357e56b9fd47f7fff27c6536e8ffbef Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:20 +0200 Subject: [PATCH 174/336] New translations conferences.adoc (French) --- .../admin/pages/spaces/conferences.adoc | 48 +++++++++---------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/fr/modules/admin/pages/spaces/conferences.adoc b/docs/fr/modules/admin/pages/spaces/conferences.adoc index 405be42fa8..d2ae80dbdd 100644 --- a/docs/fr/modules/admin/pages/spaces/conferences.adoc +++ b/docs/fr/modules/admin/pages/spaces/conferences.adoc @@ -35,82 +35,82 @@ image:spaces/conferences/new_conference.png[Create a new conference form] .Create a new conference |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |What is the title of this conference. For instance "Decidim Fest 2021" |Slogan -|Required +|Obligatoire |A subtitle for this conference. For instance, "Democracy, Technology and Global Justice" |URL slug -|Required +|Obligatoire |URL slugs are used to generate the URLs that point to this conference. Only accepts letters, numbers, and dashes, and must start with a letter. Example: if your domain is 'example.org' and your slug 'DecidimFest21' then your URL will be https://example.org/conferences/DecidimFest21 |Hashtag -|Optional +|Facultatif |Hashtag for Twitter |Highlighted -|Optional +|Facultatif |Should this conference be more prominent than others? For instance, is this an ongoing or a conference that has happened years ago? |Short description -|Required +|Obligatoire |A short explanation of what's your conference about. |Description -|Required +|Obligatoire |A long explanation of what's your conference about. |Objectives -|Optional +|Facultatif |What are the objectives or goals for this conference? |Location -|Optional +|Facultatif |Where will this conference take place? |Home image -|Optional +|Facultatif |Preferrably a landscape image that does not have any text. The service crops the image. Maximum file size: 10MB. Allowed file extensions: jpeg jpg png |Banner image -|Optional +|Facultatif |Preferrably a landscape image that does not have any text. The service crops the image. Maximum file size: 10MB. Allowed file extensions: jpeg jpg png |Scopes enabled -|Optional +|Facultatif |Check if you want to have Scopes filtering in this conference -|Scope -|Optional +|Secteur +|Facultatif |Which xref:admin:scopes.adoc[Scope] does this conference belongs to. |Show statistics -|Optional +|Facultatif |Check if you want to show the Statistics section. |Start date -|Required +|Obligatoire |When will this conference start. Expected format: dd/mm/yyyy |End date -|Required +|Obligatoire |When will this conference end. Expected format: dd/mm/yyyy |Registrations enabled -|Optional +|Facultatif |Check if you want to handle registrations on the platform. |Available slots -|Optional +|Facultatif |Leave it to 0 if you have unlimited slots available. |Registration terms @@ -118,15 +118,15 @@ the image. Maximum file size: 10MB. Allowed file extensions: jpeg jpg png |What are the terms of service or conditions that a participant must accept for registering in this conference? |Related participatory processes -|Optional +|Facultatif |Select the processes that are related to this conference. Use the *ctrl* function to select more than one option. |Related Assemblies -|Optional +|Facultatif |Select the assemblies that are related to this conference. Use the *ctrl* function to select more than one option. |Related Consultations -|Optional +|Facultatif |Select the consultations that are related to this conference. Use the *ctrl* function to select more than one option. |=== From 0a034155567c00f9c2bbe867081b4fe742c8d5ee Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:21 +0200 Subject: [PATCH 175/336] New translations attachments.adoc (French) --- .../pages/spaces/conferences/attachments.adoc | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/fr/modules/admin/pages/spaces/conferences/attachments.adoc b/docs/fr/modules/admin/pages/spaces/conferences/attachments.adoc index d36f3e32d1..64807105d2 100644 --- a/docs/fr/modules/admin/pages/spaces/conferences/attachments.adoc +++ b/docs/fr/modules/admin/pages/spaces/conferences/attachments.adoc @@ -33,26 +33,26 @@ image:spaces/attachments_new_form.png[Create a new attachment form] .Create attachment |=== -|Field |Type |Description +|Champ |Type |Description |Attachment or image name -|Required +|Obligatoire |What is the title for this attachment. |Weight -|Optional -|Which order will it have in relation to the other attachments. Having a lower number means a higher priority. For instance, if you have two categories, "Attachment a" with weight "10" and "Attachment b" with weight "0", then "Attachment b" will be first when ordering. +|Facultatif +|Which order will it have in relation to the other attachments. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two categories, "Attachment a" with weight "10" and "Attachment b" with weight "0", then "Attachment b" will be first when ordering. |Description -|Required +|Obligatoire |A long description explaining what this file is about. |Folder -|Optional +|Facultatif |Which folder this attachment belongs to. |File -|Required +|Obligatoire |Upload the file. Guidance for file: Has to be an image or a document. For images, use preferrably landscape images, the service crops the image. For CSV files, the separator between columns must be a comma (","). Maximum file size: 10MB. Allowed file extensions depends in your server configuration. @@ -65,17 +65,17 @@ image:spaces/attachments_new_folder_form.png[Create a new folder for attachments .Create folder |=== -|Field |Type |Description +|Champ |Type |Description -|Name -|Required +|Nom +|Obligatoire |Name of the folder |Weight -|Optional -|Which order will it have in relation to the other folders. Having a lower number means a higher priority. For instance, if you have two folders, "Folder a" with weight "10" and "Folder b" with weight "0", then "Folder b" will be first when ordering. +|Facultatif +|Which order will it have in relation to the other folders. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two folders, "Folder a" with weight "10" and "Folder b" with weight "0", then "Folder b" will be first when ordering. |Description -|Required +|Obligatoire |A long description explaining what this folder is about. |=== \ No newline at end of file From 4a854b50e57e566c9741d3c7b1b8eb97d9f224f6 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:22 +0200 Subject: [PATCH 176/336] New translations media_links.adoc (French) --- .../pages/spaces/conferences/media_links.adoc | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/fr/modules/admin/pages/spaces/conferences/media_links.adoc b/docs/fr/modules/admin/pages/spaces/conferences/media_links.adoc index d39ad23e1d..f5e92ddc85 100644 --- a/docs/fr/modules/admin/pages/spaces/conferences/media_links.adoc +++ b/docs/fr/modules/admin/pages/spaces/conferences/media_links.adoc @@ -18,28 +18,28 @@ For creating a new media link of a conference: . Click on the conference Edit action . Click on the "Media links" link in the sidebar . Click on the "New Media Link" button -. Fill the form +. Remplissez le formulaire image:spaces/conferences/new_media_link.png[Create a new conferences media link] .New media link form |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |The title of the link |Link -|Required +|Obligatoire |URL of the link |Date -|Required +|Obligatoire |Published date of the link |Weight -|Optional -|Which order will it have in relation to the other links. Having a lower number means a higher priority. For instance, if you have two links, "Link a" with weight "10" and "Link b" with weight "0", then "Link b" will be first when ordering. +|Facultatif +|Which order will it have in relation to the other links. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two links, "Link a" with weight "10" and "Link b" with weight "0", then "Link b" will be first when ordering. |=== \ No newline at end of file From e2c77064fc960fc333d771a517b95115db6b135e Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:23 +0200 Subject: [PATCH 177/336] New translations partners.adoc (French) --- .../admin/pages/spaces/conferences/partners.adoc | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/fr/modules/admin/pages/spaces/conferences/partners.adoc b/docs/fr/modules/admin/pages/spaces/conferences/partners.adoc index e9d5fd13d6..b8a7ef8f4c 100644 --- a/docs/fr/modules/admin/pages/spaces/conferences/partners.adoc +++ b/docs/fr/modules/admin/pages/spaces/conferences/partners.adoc @@ -15,33 +15,33 @@ For creating a new partner of a conference: . Click on the conference Edit action . Click on the Partners link in the sidebar . Click on the "New partner" button -. Fill the form +. Remplissez le formulaire image:spaces/conferences/new_partner.png[Conferences partners form] .New partner form |=== -|Field |Type |Description +|Champ |Type |Description -|Name -|Required +|Nom +|Obligatoire |What is the name of this partner. |Partner type -|Required +|Obligatoire |Choose one of these options: Main promotor or Collaborator |Weight -|Optional -|Which order will it have in relation to the other partners. Having a lower number means a higher priority. For instance, if you have two partners, "Partner a" with weight "10" and "Partner b" with weight "0", then "Partner b" will be first when ordering. +|Facultatif +|Which order will it have in relation to the other partners. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two partners, "Partner a" with weight "10" and "Partner b" with weight "0", then "Partner b" will be first when ordering. |Link | | |Logo -|Required +|Obligatoire |Guidance for image: Preferably a landscape image that does not have any text. The service crops the image. Maximum file size: 5MB Allowed file extensions: jpg jpeg gif png bmp ico |=== \ No newline at end of file From e4b11c88ad20148232ecbfe4bf00f0652f760575 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:24 +0200 Subject: [PATCH 178/336] New translations certificates.adoc (French) --- .../spaces/conferences/registrations/certificates.adoc | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/fr/modules/admin/pages/spaces/conferences/registrations/certificates.adoc b/docs/fr/modules/admin/pages/spaces/conferences/registrations/certificates.adoc index 2e526c32a2..e4711583dd 100644 --- a/docs/fr/modules/admin/pages/spaces/conferences/registrations/certificates.adoc +++ b/docs/fr/modules/admin/pages/spaces/conferences/registrations/certificates.adoc @@ -7,22 +7,22 @@ image:spaces/conferences/certificates_of_attendance.png[Conferences Certificate .Certificate of Attendance form |=== -|Field |Type |Description +|Champ |Type |Description |Main logo -|Required +|Obligatoire |Logo of the conference of the organization that makes the certificate of attendance. |Signature -|Required +|Obligatoire |Image of the person that signs the certificate. |Sign date -|Required +|Obligatoire |Date of the signature. Expected format: dd/mm/yyyy |Signature name -|Required +|Obligatoire |Name of the person that signs the certificate. |=== From 49799c699dcc9b8c4c047126dbfe5c6f2a45be51 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:26 +0200 Subject: [PATCH 179/336] New translations invites.adoc (French) --- .../pages/spaces/conferences/registrations/invites.adoc | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/fr/modules/admin/pages/spaces/conferences/registrations/invites.adoc b/docs/fr/modules/admin/pages/spaces/conferences/registrations/invites.adoc index bd02c5da95..dab1ad716e 100644 --- a/docs/fr/modules/admin/pages/spaces/conferences/registrations/invites.adoc +++ b/docs/fr/modules/admin/pages/spaces/conferences/registrations/invites.adoc @@ -14,13 +14,13 @@ image:spaces/conferences/invite_participant_form.png[Invite a participant form] .Invite participant form |=== -|Field |Type |Description +|Champ |Type |Description |Attendee type -|Required +|Obligatoire |Wheter this invited person is a non-existing or existing participant. Does she already have an account created on the platform? -|Name +|Nom |Required if it's a non-existing participant. |Name of the invited person. @@ -33,6 +33,6 @@ image:spaces/conferences/invite_participant_form.png[Invite a participant form] |Type at least three characters to search. |xref:admin:spaces/conferences/registrations/types.adoc[Registration type] -|Required +|Obligatoire |What xref:admin:spaces/conferences/registrations/types.adoc[registration type] does this participant will have. |=== \ No newline at end of file From e53c23d86d5927f3cb3f75d83c5e0b1adb01890e Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:27 +0200 Subject: [PATCH 180/336] New translations types.adoc (French) --- .../spaces/conferences/registrations/types.adoc | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/fr/modules/admin/pages/spaces/conferences/registrations/types.adoc b/docs/fr/modules/admin/pages/spaces/conferences/registrations/types.adoc index 1625887826..5d943bab07 100644 --- a/docs/fr/modules/admin/pages/spaces/conferences/registrations/types.adoc +++ b/docs/fr/modules/admin/pages/spaces/conferences/registrations/types.adoc @@ -22,7 +22,7 @@ For adding a new registration type, you need to: . Click on the conference Edit action . Click on the "Registration types" link in the sidebar . Click on the "New Registration type" button -. Fill the form +. Remplissez le formulaire . Publish the registration type image:spaces/conferences/new_registration_type.png[Create a new registration type form] @@ -32,21 +32,21 @@ image:spaces/conferences/registration_types_backend.png[Manage registration type .Create a new registration type |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |What is the title of this registration type. |Weight -|Which order will it have in relation to the other types. Having a lower number means a higher priority. For instance, if you have two types, "Day 1" with weight "10" and "Day 2" with weight "0", then "Day 2" will be first when ordering. +|Which order will it have in relation to the other types. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two types, "Day 1" with weight "10" and "Day 2" with weight "0", then "Day 2" will be first when ordering. |Description -|Required +|Obligatoire |Description for this registration type |Price -|Optional +|Facultatif |Define a price for this registration type. If you don't define a price, the price will be "Free". |Select conference meetings |=== From 48ed5e6a34505ecdee54036173a1b04e8df7f2e1 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:28 +0200 Subject: [PATCH 181/336] New translations speakers.adoc (French) --- .../pages/spaces/conferences/speakers.adoc | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/fr/modules/admin/pages/spaces/conferences/speakers.adoc b/docs/fr/modules/admin/pages/spaces/conferences/speakers.adoc index f62160a3e8..01fdd30e12 100644 --- a/docs/fr/modules/admin/pages/spaces/conferences/speakers.adoc +++ b/docs/fr/modules/admin/pages/spaces/conferences/speakers.adoc @@ -15,17 +15,17 @@ For creating a new speaker of a conference: . Click on the conference Edit action . Click on the Speakers link in the sidebar . Click on the "New Conference Speaker" button -. Fill the form +. Remplissez le formulaire image:spaces/conferences/new_speaker.png[Conferences speakers] .New conference speaker form |=== -|Field |Type |Description +|Champ |Type |Description |Participant type -|Required +|Obligatoire |Wheter this speaker is a non-participant or existing participant. Does she already have an account created on the platform? |Full name @@ -37,31 +37,31 @@ image:spaces/conferences/new_speaker.png[Conferences speakers] |Type at least three characters to search. |Related meetings -|Optional +|Facultatif |Which meetings does this speaker attend and participates actively? |Position -|Required +|Obligatoire |Metadata for showing extra information about the speaker. |Affiliation -|Required +|Obligatoire |Metadata for showing extra information about the speaker. |Short Bio -|Optional +|Facultatif |Metadata for showing extra information about the speaker. |Twitter handle -|Optional +|Facultatif |Metadata for showing extra information about the speaker. |Personal URL -|Optional +|Facultatif |Metadata for showing extra information about the speaker. |Avatar -|Optional +|Facultatif |Metadata for showing extra information about the speaker. Default image From 4ea961b0b5222f019769fd39ebbc848415491f49 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:30 +0200 Subject: [PATCH 182/336] New translations initiatives.adoc (French) --- .../admin/pages/spaces/initiatives.adoc | 48 +++++++++---------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/fr/modules/admin/pages/spaces/initiatives.adoc b/docs/fr/modules/admin/pages/spaces/initiatives.adoc index 46f1682500..7b07fc9c80 100644 --- a/docs/fr/modules/admin/pages/spaces/initiatives.adoc +++ b/docs/fr/modules/admin/pages/spaces/initiatives.adoc @@ -32,64 +32,64 @@ image:admin_initiative_type.png[New initiative type form] .Admin new initiative type form: General information |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |Title of the initiative type. For instance, "New park at city center". |Description -|Required +|Obligatoire |Explanation of what can be done with this initiative type. |Banner image -|Required +|Obligatoire |An image for this initiative type. NOTE: At the moment this is not used. |=== .Admin new initiative type form: Options |=== -|Field |Type |Description +|Champ |Type |Description |Signature type -|Optional +|Facultatif |Which kind of signature type will be allowed. Options are: Online, In-person and Mixed. The Mixed option allows a participant to choose which signature type will have the initiative. |Enable attachments -|Optional +|Facultatif |Whether it'll allow to upload attachments to initiatives. |Enable participants to undo their online signatures -|Optional +|Facultatif |Can a participant undo its signature when they already signed? |Enable authors to choose the end of the signature collection period -|Optional +|Facultatif |Can the authors of an initiative change the end of the signature collection period? |Enable authors to choose the area for their initiative -|Optional +|Facultatif |Can the authors choose the area of their initiative? |Enable child scope signatures -|Optional +|Facultatif |This config flag doesn't support offline votes, it enables sub-scopes and works with an authorization handler that associates a scope to the user, make sure you select that authorization, bellow in authorization settings. For it to work, scopes need to be configured in a hierarchical way : 1 Parent - N Child. |Only allow global scope initiatives creation -|Optional +|Facultatif |Tick this flag if you enabled "Child scope signature" and configured the global scope as your parent scope. By enabling this, scope selection will be skipped in the initiative creation wizard. |Enable promoting committee -|Optional +|Facultatif |Whether it will only allow individual initiatives (made by only one person) or allow collective initiatives (multiple promoters, being multiple individuals or a user group). |Minimum of committee members -|Optional +|Facultatif |When "Enable promoting committee" option is checked, defines the minimum number of promoter's committee member to send the initiative to technical validation |Collect participant personal data on signature -|Optional +|Facultatif |Adds a step to the signature process. When a participant clicks on the signature button, she'll be redirected to a form asking for some personal data. This will be used with the PDF export action after the recollection period has ended. |Legal information about the collection of personal data @@ -100,10 +100,10 @@ image:admin_initiative_type.png[New initiative type form] .Admin new initiative type form: Authorization settings |=== -|Field |Type |Description +|Champ |Type |Description |Authorization to verify document number on signatures -|Optional +|Facultatif |When a participant is making the signature process, will she be asked for an authorization? |Add SMS code validation step to the signature process @@ -120,14 +120,14 @@ image:admin_initiative_type_scope.png[New initiative type form] .Admin new initiative type scope form |=== -|Field |Type |Description +|Champ |Type |Description |Scopes -|Required +|Obligatoire |A Scope. An author can choose this scope in the creation of the initiative. |Signatures required -|Required +|Obligatoire |Number of signatures the initiative need to have before the end period so it can be accepted. |=== @@ -237,11 +237,11 @@ Regarding the actions in an initiative, an administrator can "Preview", "Edit", image:initiative_admin_list_actions.png[Initiative admin list actions] |=== -|Icon |Name |Definition +|Icône |Nom |Definition |image:action_preview.png[Preview icon] |Preview -|To see how it's shown in the frontend to participants. +|Pour voir comment il est montré dans le frontend aux participants. |image:action_edit.png[Edit icon] |Edit @@ -256,7 +256,7 @@ image:initiative_admin_list_actions.png[Initiative admin list actions] |Allows to print. |=== -=== Components +=== Fonctionnalités Once an initiative has been created it gets the Meetings and Page component enabled by default. The initiative author has no control over these - an admin will need to manage From 2393c54ea5d709da9c3bb03fa6f06ab03a069241 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:32 +0200 Subject: [PATCH 183/336] New translations processes.adoc (French) --- .../modules/admin/pages/spaces/processes.adoc | 80 +++++++++---------- 1 file changed, 40 insertions(+), 40 deletions(-) diff --git a/docs/fr/modules/admin/pages/spaces/processes.adoc b/docs/fr/modules/admin/pages/spaces/processes.adoc index f833ec1522..08ca95d1ce 100644 --- a/docs/fr/modules/admin/pages/spaces/processes.adoc +++ b/docs/fr/modules/admin/pages/spaces/processes.adoc @@ -58,65 +58,65 @@ image::processes_new_form.png[New participatory process form] .New participatory process form: General information |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |Title of the participatory process. For instance, "Participatory Budgeting 2020". |Subtitle -|Required +|Obligatoire |Subtitle. For instance, "Let's decide our priorities together" |URL slug -|Required +|Obligatoire |URL slugs are used to generate the URLs that point to this process. Only accepts letters, numbers and dashes, and must start with a letter. Example: if your domain is 'example.org' and your slug 'participatory-budget-2020' then your URL will be https://example.org/processes/participatory-budget-2020 |Hashtag -|Optional +|Facultatif |Hashtag for Twitter |Short description -|Required +|Obligatoire |A short explanation of what's your participatory process about. |Description -|Required +|Obligatoire |A long explanation of what's your participatory process about. -|Announcement -|Optional +|Annonce +|Facultatif |The text you enter here will be shown to the user right below the process information. |=== .New participatory process form: Duration |=== -|Field |Type |Description +|Champ |Type |Description |Start date -|Optional +|Facultatif |When this process start. You have a calendar widget to choose the day. Expected format: dd/mm/yyyy |End date -|Optional +|Facultatif |When this process start. You have a calendar widget to choose the day. Expected format: dd/mm/yyyy |=== .New participatory process form: Images |=== -|Field |Type |Description +|Champ |Type |Description |Home image -|Optional +|Facultatif |Image that will be used in presentation cards of this process. Guidance for file: Has to be an image or a document. For images, use preferably landscape images, the service crops the image. Maximum file size: 10MB |Banner image -|Optional +|Facultatif |Image that will be used inside of the process. Guidance for file: Has to be an image or a document. For images, use preferably landscape images, the service crops the image. Maximum file size: 10MB |=== @@ -124,30 +124,30 @@ For images, use preferably landscape images, the service crops the image. Maximu .New participatory process form: Metadata |=== -|Field |Type |Description +|Champ |Type |Description |Promoter group -|Optional +|Facultatif |Information that's displayed in the process metadata sidebar. |Organization area -|Optional +|Facultatif |Information that's displayed in the process metadata sidebar. |Scope metadata -|Optional +|Facultatif |Information that's displayed in the process metadata sidebar. |Who participates -|Optional +|Facultatif |Information that's displayed in the process metadata sidebar. |What is decided -|Optional +|Facultatif |Information that's displayed in the process metadata sidebar. |How is it decided -|Optional +|Facultatif |Information that's displayed in the process metadata sidebar. |=== @@ -158,44 +158,44 @@ image::process_backend_metadata.png[Process backend metadata] .New participatory process form: Filters |=== -|Field |Type |Description +|Champ |Type |Description |Scopes enabled -|Optional +|Facultatif |Check if you want to have Scopes filtering in this process. -|Scope -|Optional +|Secteur +|Facultatif |Which xref:admin:scopes.adoc[Scope] does this process belongs to. |Scope filter depth -|Optional +|Facultatif |Restrict the scope filter depth; The filter will show from general to the selected scope type. This is only relevant if you have complex relations in Scopes children (like a Russian Doll). For instance if you have a Grandmother -> Mother -> Child, this setting allows you to choose the Mother, so the participants can only choose the Child. This would be the case for instance if you have Provinces -> Cities -> Districts, and the process is about a particular City. |Area -|Optional +|Facultatif |Which xref:admin:areas.adoc[Area] does this process belongs to. |=== .New participatory process form: Visibility |=== -|Field |Type |Description +|Champ |Type |Description |Processes group -|Optional +|Facultatif |Enables to make groups of multiple participatory processes. Ideally for processes that are related between them, for instance multiple squares in a City or multiple documents using the same participatory rules. |Private space -|Optional +|Facultatif |Check if this process should only be accessible by xref:admin:spaces/processes/private_participants.adoc[Private Participants] |Promoted -|Optional +|Facultatif |Check if you want the process to have more visibility in the Process public list. It'll also be visible in the Participatory Process Content Block in the xref:admin:homepage.adoc[Homepage] configuration. This is accessible in the btn:[Edit] action in a Process. @@ -204,24 +204,24 @@ btn:[Edit] action in a Process. .New participatory process form: Filters |=== -|Field |Type |Description +|Champ |Type |Description |Related processes -|Optional +|Facultatif |Select other participatory processes that are related to this one. |=== .New participatory process form: Filters |=== -|Field |Type |Description +|Champ |Type |Description |Show statistics -|Optional +|Facultatif |Check if you want to show the Statistics section. |Show metrics -|Optional +|Facultatif |Check if you want to show the Metrics section. |=== @@ -237,6 +237,6 @@ Here you can keep configuring your process: . xref:admin:spaces/processes/components.adoc[Components] . xref:admin:spaces/processes/categories.adoc[Categories] . xref:admin:spaces/processes/attachments.adoc[Attachments] -. xref:admin:spaces/processes/admins.adoc[Process admins] -. xref:admin:spaces/processes/private_participants.adoc[Private participants] +. xref:admin:spaces/processes/admins.adoc[Administrateurs de la concertation] +. xref:admin:spaces/processes/private_participants.adoc[Utilisateurs privés] . xref:admin:spaces/processes/moderations.adoc[Moderations] \ No newline at end of file From 5ea2629234d59813c84459f01e74db22a424fb40 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:33 +0200 Subject: [PATCH 184/336] New translations groups.adoc (French) --- .../admin/pages/spaces/processes/groups.adoc | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/fr/modules/admin/pages/spaces/processes/groups.adoc b/docs/fr/modules/admin/pages/spaces/processes/groups.adoc index 315bedeaa7..fa7c36a365 100644 --- a/docs/fr/modules/admin/pages/spaces/processes/groups.adoc +++ b/docs/fr/modules/admin/pages/spaces/processes/groups.adoc @@ -25,24 +25,24 @@ image::processes_group_new_form.png[New participatory process group form] .New participatory process group form: General information |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |Title of the participatory process group. For instance, "Participatory Budgeting". |Description -|Required +|Obligatoire |A long explanation of what's your participatory process about. |Related processes -|Optional +|Facultatif |Which are the processes that are related to this one? They will be used for populating the Content Blocks in the Landing page of this Process group. For selecting multiple you'll need to use the *ctrl* function. |Image -|Optional +|Facultatif |Image that will be used in presentation cards of this process group. Guidance for image: Preferably a landscape image that does not have any text. The service crops the image. Maximum file size: 10MB. Allowed file extensions: jpeg jpg png @@ -51,43 +51,43 @@ Maximum file size: 10MB. Allowed file extensions: jpeg jpg png .New participatory process group form: Metadata |=== -|Field |Type |Description +|Champ |Type |Description Hashtag Website |Promoter group -|Optional +|Facultatif |Information that's displayed in the process metadata content block. |Organization area -|Optional +|Facultatif |Information that's displayed in the process metadata content block. |Scope metadata -|Optional +|Facultatif |Information that's displayed in the process metadata content block. |Who participates -|Optional +|Facultatif |Information that's displayed in the process metadata content block. |What is decided -|Optional +|Facultatif |Information that's displayed in the process metadata content block. |How is it decided -|Optional +|Facultatif |Information that's displayed in the process metadata content block. |=== .New participatory process group form: Visibility |=== -|Field |Type |Description +|Champ |Type |Description |Promoted -|Optional +|Facultatif |Check if you want the process to have more visibility in the Process public list. It'll also be visible in the ParticpipatoryProcess Content Block in the xref:admin:homepage.adoc[Homepage] configuration. This is accessible in the btn:[Edit] action in a Process. |=== From d60efc76747274aa80dcd301312c8489028418dc Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:34 +0200 Subject: [PATCH 185/336] New translations phases.adoc (French) --- docs/fr/modules/admin/pages/spaces/processes/phases.adoc | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/fr/modules/admin/pages/spaces/processes/phases.adoc b/docs/fr/modules/admin/pages/spaces/processes/phases.adoc index c9c58c5173..b050acea21 100644 --- a/docs/fr/modules/admin/pages/spaces/processes/phases.adoc +++ b/docs/fr/modules/admin/pages/spaces/processes/phases.adoc @@ -40,10 +40,10 @@ image:process_phases_new_form.png[Create a new participatory process phase form] .Create meeting |=== -|Field |Type |Description +|Champ |Type |Description -|Title -|Required +|Titre +|Obligatoire |What is the title for this phase. |Description @@ -73,7 +73,7 @@ URLs here. Accepts letters, numbers, dashes, and, slashes, and must start with a After a phase was created you have these actions: |=== -|Icon |Name |Definition +|Icône |Nom |Definition |image:action_activate.png[Activate icon] |Activate From 7e5cca2690d524c7a97f08832098ed052ca68e09 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:35 +0200 Subject: [PATCH 186/336] New translations system.adoc (French) --- docs/fr/modules/admin/pages/system.adoc | 28 ++++++++++++------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/fr/modules/admin/pages/system.adoc b/docs/fr/modules/admin/pages/system.adoc index b52b8da96d..f4c40722ed 100644 --- a/docs/fr/modules/admin/pages/system.adoc +++ b/docs/fr/modules/admin/pages/system.adoc @@ -52,54 +52,54 @@ TIP: Please mind that some of these fields can't change through the System Form, .System New Organization form |=== -|Field |Type |Description +|Champ |Type |Description -|Name -|Required +|Nom +|Obligatoire |Name of your organization. For instance, "Decidim Barcelona". |Reference prefix -|Required +|Obligatoire |The reference prefix is used to uniquely identify resources across all organizations. It's for identifying different resources inside of Decidim. For instance, "BCN". You can change how it's created this reference through xref:configure:initializer.adoc[Decidim's initializer] (see **Custom resource reference**). |Host -|Required +|Obligatoire |Fully qualified domain name. For instance, "example.org" or "decidim.barcelona". |Secondary hosts -|Optional +|Facultatif |Others domains or subdomains that point to this same installation. Normally this shouldn't be used. Enter each one of them in a new line. For instance, "example.com" |Organization admin name -|Required +|Obligatoire |Name of the admin account. For instance, "Admin" |Organization admin email -|Required +|Obligatoire |Email for the admin account. For instance, "admin@example.org" |Organization locales -|Required +|Obligatoire |You'll need to configure at least one language. Decidim is multilanguage, meaning that you can have most of the admin contents with any number of languages. For seeing other languages you'll need to configure first the xref:configure:initializer.adoc[Decidim's initializer]. |Force authentication -|Optional +|Facultatif |Check if you want to **Force users to authenticate before access organization**. That means that they don't see any published content and they only have access to the log-in form. |Users registration mode -|Optional +|Facultatif |Control how you want the login / participant register or signup to work. See below. |Available authorizations -|Optional +|Facultatif |How you want to authorize and verify that your participants are who they say they are. It depends a lot on your Organization, country, etc. See xref:customize:authorizations.adoc[Authorizations customization]. |SMTP settings -|Optional +|Facultatif |Allows you to configure different SMTP servers for every Organzation in this installation. See xref:services:smtp.adoc[SMTP configuration]. |Omniauth settings -|Optional +|Facultatif |Allows you to configure through external OAUTH providers for every Organization in this installation. See xref:services:social_providers.adoc[Social providers configuration]. |=== From ff2752cf6a3f8e47e06e37a6ab7fedd6c1b23c87 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:36 +0200 Subject: [PATCH 187/336] New translations page_admins.adoc (French) --- docs/fr/modules/admin/partials/page_admins.adoc | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/fr/modules/admin/partials/page_admins.adoc b/docs/fr/modules/admin/partials/page_admins.adoc index e4527970ba..3de709b52a 100644 --- a/docs/fr/modules/admin/partials/page_admins.adoc +++ b/docs/fr/modules/admin/partials/page_admins.adoc @@ -20,18 +20,18 @@ image:spaces/admins_form.png[New space admin form] .New space admin form |=== -|Field |Type |Description +|Champ |Type |Description -|Name -|Required +|Nom +|Obligatoire |What is the name of the new admin. |Email -|Required +|Obligatoire |What is the email of the new admin, so she can receive the invitation. |Role -|Required +|Obligatoire |Which role does this admin will have in the participatory process? Can be any of Administrator, Collaborator, Moderator, or Valuator. |=== From d7ed0cb1eb0c18e0f0376cdc5b24e5e86930e0a7 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:38 +0200 Subject: [PATCH 188/336] New translations page_attachments.adoc (French) --- .../admin/partials/page_attachments.adoc | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/fr/modules/admin/partials/page_attachments.adoc b/docs/fr/modules/admin/partials/page_attachments.adoc index 0b7fab6042..aa966eb4ec 100644 --- a/docs/fr/modules/admin/partials/page_attachments.adoc +++ b/docs/fr/modules/admin/partials/page_attachments.adoc @@ -29,26 +29,26 @@ image:spaces/attachments_new_form.png[Create a new attachment form] .Create attachment |=== -|Field |Type |Description +|Champ |Type |Description |Attachment or image name -|Required +|Obligatoire |What is the title for this attachment. |Weight -|Optional -|Which order will it have in relation to the other attachments. Having a lower number means a higher priority. For instance, if you have two categories, "Attachment a" with weight "10" and "Attachment b" with weight "0", then "Attachment b" will be first when ordering. +|Facultatif +|Which order will it have in relation to the other attachments. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two categories, "Attachment a" with weight "10" and "Attachment b" with weight "0", then "Attachment b" will be first when ordering. |Description -|Required +|Obligatoire |A long description explaining what this file is about. |Folder -|Optional +|Facultatif |Which folder this attachment belongs to. |File -|Required +|Obligatoire |Upload the file. Guidance for file: Has to be an image or a document. For images, use preferrably landscape images, the service crops the image. For CSV files, the separator between columns must be a comma (","). Maximum file size: 10MB. Allowed file extensions depends in your server configuration. @@ -61,17 +61,17 @@ image:spaces/attachments_new_folder_form.png[Create a new folder for attachments .Create folder |=== -|Field |Type |Description +|Champ |Type |Description -|Name -|Required +|Nom +|Obligatoire |Name of the folder |Weight -|Optional -|Which order will it have in relation to the other folders. Having a lower number means a higher priority. For instance, if you have two folders, "Folder a" with weight "10" and "Folder b" with weight "0", then "Folder b" will be first when ordering. +|Facultatif +|Which order will it have in relation to the other folders. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two folders, "Folder a" with weight "10" and "Folder b" with weight "0", then "Folder b" will be first when ordering. |Description -|Required +|Obligatoire |A long description explaining what this folder is about. |=== \ No newline at end of file From 719d3bbda0208f715d56023b8935eeaf8e161293 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:39 +0200 Subject: [PATCH 189/336] New translations page_categories.adoc (French) --- .../fr/modules/admin/partials/page_categories.adoc | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/fr/modules/admin/partials/page_categories.adoc b/docs/fr/modules/admin/partials/page_categories.adoc index 67571c88bd..b18e4622f0 100644 --- a/docs/fr/modules/admin/partials/page_categories.adoc +++ b/docs/fr/modules/admin/partials/page_categories.adoc @@ -36,21 +36,21 @@ image:spaces/categories_new_form.png[Create a new category form] .Create category |=== -|Field |Type |Description +|Champ |Type |Description -|Name -|Required +|Nom +|Obligatoire |What is the name for this category. |Weight -|Optional -|Which order will it have in relation to the other categories. Having a lower number means a higher priority. For instance, if you have two categories, "Category a" with weight "10" and "Category b" with weight "0", then "Category b" will be first when ordering. +|Facultatif +|Which order will it have in relation to the other categories. Avoir un nombre inférieur signifie un rang d'affichage plus élevé. For instance, if you have two categories, "Category a" with weight "10" and "Category b" with weight "0", then "Category b" will be first when ordering. |Description -|Required +|Obligatoire |A long description explaining what this category is about. |Parent -|Optional +|Facultatif |What is the parent category. |=== \ No newline at end of file From 414daa9df95a4f63a33d8ff7ea8d6b2904ab8db3 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:40 +0200 Subject: [PATCH 190/336] New translations page_components.adoc (French) --- docs/fr/modules/admin/partials/page_components.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/fr/modules/admin/partials/page_components.adoc b/docs/fr/modules/admin/partials/page_components.adoc index 5544cc7a1e..b4b3a09bc8 100644 --- a/docs/fr/modules/admin/partials/page_components.adoc +++ b/docs/fr/modules/admin/partials/page_components.adoc @@ -1,4 +1,4 @@ -= Components += Fonctionnalités include::partial$components_list.adoc[] @@ -15,7 +15,7 @@ image::spaces/components_new_dropdown.png[Add a component in a space] == Actions |=== -|Icon |Name |Definition +|Icône |Nom |Definition |image:action_manage.png[Manage icon] |Manage @@ -36,7 +36,7 @@ in a Meeting component, etc. are comments enabled, participants can create meetings, etc. |image:action_permissions.png[Permissions icon] -|Permissions +|Autorisations |To configure which xref:customize:authorizations.adoc[Authorization] will be necessary to make certain actions in this component. For instance, in the case of Proposals, which Verification will be necessary to create a new proposal or to give supports. From 0a36f9ce64fdb7cfd88a3f196044590753222fc3 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:41 +0200 Subject: [PATCH 191/336] New translations page_private_participants.adoc (French) --- .../admin/partials/page_private_participants.adoc | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/fr/modules/admin/partials/page_private_participants.adoc b/docs/fr/modules/admin/partials/page_private_participants.adoc index 90580396be..d0f0c01f94 100644 --- a/docs/fr/modules/admin/partials/page_private_participants.adoc +++ b/docs/fr/modules/admin/partials/page_private_participants.adoc @@ -21,14 +21,14 @@ image:spaces/private_participants_new_form.png[New private participant form] .New participatory space private user form |=== -|Field |Type |Description +|Champ |Type |Description -|Name -|Required +|Nom +|Obligatoire |What is the name of the new participant. |Email -|Required +|Obligatoire |What is the email of the new participant. |=== @@ -52,7 +52,7 @@ After the participants has been invited, you can resend or delete the invitation image:spaces/private_participants_actions.png[Private participants actions] |=== -|Icon |Name |Definition +|Icône |Nom |Definition |image:action_resend_invitation.png[Resend invitation] |Resend invitation From c796ca7b65eb6bec2ee392a63a45870ec58c2129 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:42 +0200 Subject: [PATCH 192/336] New translations translations.adoc (French) --- docs/fr/modules/contribute/pages/translations.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/fr/modules/contribute/pages/translations.adoc b/docs/fr/modules/contribute/pages/translations.adoc index a06acc9fb4..e2cd36f223 100644 --- a/docs/fr/modules/contribute/pages/translations.adoc +++ b/docs/fr/modules/contribute/pages/translations.adoc @@ -19,7 +19,7 @@ image::translation-join-02.png[Message in Join Decidim Translations] If your language isn't created yet, then we need to do it as it's necessary to make some adjustments. You need to contact us by the https://decidim.org/contact[contact form]. -== How it works +== Comment ça marche If you're curios, in the technical level we have a bot (the great decidim-bot) that periodically makes a PR to the relevant branches (last releases and develop). From fdd453993f582ff9e94dc827fe34d9ad6c5c0663 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:43 +0200 Subject: [PATCH 193/336] New translations components.adoc (French) --- docs/fr/modules/features/pages/components.adoc | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/fr/modules/features/pages/components.adoc b/docs/fr/modules/features/pages/components.adoc index 2e847c7acf..118d0b6de0 100644 --- a/docs/fr/modules/features/pages/components.adoc +++ b/docs/fr/modules/features/pages/components.adoc @@ -1,10 +1,10 @@ -= Components += Fonctionnalités :page-partial: *Components* are participatory mechanisms that allow interactions among the platform Participants within each of the Participatory Spaces. -== Proposals +== Propositions *Proposals* are Decidim's most important component. They can be defined as the minimum decision unit. @@ -135,15 +135,15 @@ Participatory texts are defined as an ordered collection of proposals that make * *Composition of proposals in a unified text*: based on a series of proposals, these may be ordered and generate a unified and downloadable text. * *Viewing and interacting* with documents composed of proposals: A collection of proposals will be shown as a unified text and may be amended or comments can be added in the margin. -=== Accountability +=== Suivi des réalisations The *accountability* component works like a project management system built into the platform. . It offers the possibility of: -* subdividing results into projects or sub-projects -* defining and applying progress in implementation statuses (0% to 100% implemented) around their implementation -* displaying the extent of the results’ implementation grouped by categories and scopes +* subdiviser les réalisations en projets ou sous-projets +* définir et appliquer les mesures des progrès dans la mise en œuvre (de 0 % à 100 % mis en œuvre) des réalisations +* afficher l'avancement de l'implémentation des réalisations regroupées par catégories et secteurs -Results, projects and statuses can be updated through a CVS, or manually by the administration interface. +Les réalisations, les projets et les statuts peuvent être mis à jour via un CSV, ou manuellement via l'interface d'administration. === Conferences From 5b9584756a11c1476f2b8942e505faedb3df4a2c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:44 +0200 Subject: [PATCH 194/336] New translations nav.adoc (German) --- docs/de/modules/ROOT/nav.adoc | 199 ++++++++++++++++++++++++++++++++++ 1 file changed, 199 insertions(+) create mode 100644 docs/de/modules/ROOT/nav.adoc diff --git a/docs/de/modules/ROOT/nav.adoc b/docs/de/modules/ROOT/nav.adoc new file mode 100644 index 0000000000..9d85961d75 --- /dev/null +++ b/docs/de/modules/ROOT/nav.adoc @@ -0,0 +1,199 @@ +* xref:install:index.adoc[Anfangen] +** xref:install:manual.adoc[Manuelle Installation] +** xref:install:checklist.adoc[Checklist] +** xref:install:update.adoc[Update] +* xref:configure:index.adoc[Configure] +** xref:configure:environment_variables.adoc[Umgebungsvariablen] +** xref:configure:initializer.adoc[Initializer] +*** xref:customize:authorizations.adoc[Authorizations] +*** xref:customize:code.adoc[Code] +*** xref:customize:gemfile.adoc[Gemfile] +*** xref:customize:images.adoc[Images] +*** xref:customize:javascript.adoc[Javascript] +*** xref:customize:menu.adoc[Menu] +*** xref:customize:oauth.adoc[OAuth] +*** xref:customize:styles.adoc[Styles] +*** xref:customize:texts.adoc[Texts] +*** xref:customize:users_registration_mode.adoc[Benutzerregistrierungsmodus] +*** xref:customize:views.adoc[Views] +*** xref:services:activejob.adoc[Aktiver Job] +*** xref:services:elections_bulletin_board.adoc[Wahlbulletin Board] +*** xref:services:etherpad.adoc[Etherpad] +*** xref:services:maps.adoc[Maps] +*** xref:services:smtp.adoc[SMTP] +*** xref:services:social_providers.adoc[Soziale Anbieter] +* Administrator +** xref:admin:index.adoc[Introduction] +*** xref:admin:system.adoc[System-Panel] +*** xref:admin:dashboard.adoc[Dashboard] +** Einstellungen +*** xref:admin:configuration.adoc[Configuration] +*** xref:admin:appearance.adoc[Appearance] +*** xref:admin:homepage.adoc[Homepage] +*** xref:admin:scopes.adoc[Scopes] +*** xref:admin:areas.adoc[Areas] +*** xref:admin:help_sections.adoc[Hilfe-Abschnitte] +** xref:admin:pages.adoc[Pages] +** xref:admin:participants.adoc[Participants] +*** xref:admin:participants/admins.adoc[Admins] +*** xref:admin:participants/groups.adoc[Groups] +*** xref:admin:participants/participants.adoc[Participants] +*** xref:admin:participants/impersonations.adoc[Impersonations] +**** xref:admin:participants/verifications_conflicts.adoc[Überprüfungskonflikte] +*** xref:admin:participants/reported_users.adoc[Gemeldete Benutzer] +*** xref:admin:participants/authorizations.adoc[Authorizations] +**** xref:admin:participants/authorizations/identity_documents.adoc[Identifizierungsdokumente] +**** xref:admin:participants/authorizations/code_postal_letter.adoc[Code by postal letter] +**** xref:admin:participants/authorizations/census.adoc[Organization's census] +** xref:admin:spaces.adoc[Spaces] +*** xref:admin:spaces/processes.adoc[Participatory Processes] +**** xref:admin:spaces/processes/phases.adoc[Phases] +**** xref:admin:spaces/processes/components.adoc[Components] +**** xref:admin:spaces/processes/categories.adoc[Categories] +**** xref:admin:spaces/processes/attachments.adoc[Attachments] +**** xref:admin:spaces/processes/admins.adoc[Process admins] +**** xref:admin:spaces/processes/private_participants.adoc[Private participants] +**** xref:admin:spaces/processes/moderations.adoc[Moderations] +**** xref:admin:spaces/processes/groups.adoc[Process Groups] +*** xref:admin:spaces/assemblies.adoc[Assemblies] +**** xref:admin:spaces/assemblies/components.adoc[Components] +**** xref:admin:spaces/assemblies/categories.adoc[Categories] +**** xref:admin:spaces/assemblies/attachments.adoc[Attachments] +**** xref:admin:spaces/assemblies/members.adoc[Members] +**** xref:admin:spaces/assemblies/admins.adoc[Assembly admins] +**** xref:admin:spaces/assemblies/private_participants.adoc[Private participants] +**** xref:admin:spaces/assemblies/moderations.adoc[Moderations] +*** xref:admin:spaces/initiatives.adoc[Initiatives] +*** xref:admin:spaces/conferences.adoc[Conferences] +**** xref:admin:spaces/conferences/components.adoc[Components] +**** xref:admin:spaces/conferences/categories.adoc[Categories] +**** xref:admin:spaces/conferences/attachments.adoc[Attachments] +**** xref:admin:spaces/conferences/media_links.adoc[Media Links] +**** xref:admin:spaces/conferences/partners.adoc[Partners] +**** xref:admin:spaces/conferences/speakers.adoc[Speakers] +**** xref:admin:spaces/conferences/registrations.adoc[Registrations] +***** xref:admin:spaces/conferences/registrations/types.adoc[Registration Types] +***** xref:admin:spaces/conferences/registrations/users.adoc[User Registrations] +***** xref:admin:spaces/conferences/registrations/invites.adoc[Invites] +***** xref:admin:spaces/conferences/registrations/certificates.adoc[Certificate of Attendance] +**** xref:admin:spaces/conferences/admins.adoc[Conference admins] +**** xref:admin:spaces/conferences/moderations.adoc[Moderations] +*** xref:admin:spaces/consultations.adoc[Consultations] +*** xref:admin:spaces/votings.adoc[Votings] +** xref:admin:components.adoc[Components] +*** xref:admin:components/blog.adoc[Blog] +*** xref:admin:components/budgets.adoc[Budgets] +*** xref:admin:components/debates.adoc[Debates] +*** xref:admin:components/elections.adoc[Elections] +*** xref:admin:components/meetings.adoc[Meetings] +**** xref:admin:components/meetings/registrations.adoc[Registrations] +**** xref:admin:components/meetings/agenda.adoc[Agenda] +**** xref:admin:components/meetings/polls.adoc[Polls] +**** xref:admin:components/meetings/close.adoc[Close] +*** xref:admin:components/pages.adoc[Pages] +*** xref:admin:components/proposals.adoc[Proposals] +**** xref:admin:components/proposals/amendments.adoc[Amendments] +**** xref:admin:components/proposals/answers.adoc[Answers] +**** xref:admin:components/proposals/collaborative_drafts.adoc[Kollaborative Entwürfe] +**** xref:admin:components/proposals/participatory_texts.adoc[teilnehmende Texte] +*** xref:admin:components/surveys.adoc[Surveys] +** Funktionen +*** xref:admin:features/badges.adoc[Badges] +*** xref:admin:features/comments.adoc[Comments] +*** xref:admin:features/conversations.adoc[Conversations] +*** xref:admin:features/embed.adoc[Embed] +*** xref:admin:features/endorsements.adoc[Endorsements] +*** xref:admin:features/fingerprint.adoc[Fingerprint] +*** xref:admin:features/follows.adoc[Follows] +*** xref:admin:features/metrics.adoc[Metrics] +*** xref:admin:features/my_account.adoc[Mein Konto] +**** xref:admin:features/my_account/account.adoc[Account] +**** xref:admin:features/my_account/notifications_settings.adoc[Benachrichtigungseinstellungen] +**** xref:admin:features/my_account/authorizations.adoc[Authorizations] +**** xref:admin:features/my_account/groups.adoc[Groups] +**** xref:admin:features/my_account/my_interests.adoc[Meine Interessen] +**** xref:admin:features/my_account/my_data.adoc[Meine Daten] +**** xref:admin:features/my_account/delete_my_account.adoc[Mein Konto löschen] +*** xref:admin:features/notifications.adoc[Notifications] +*** xref:admin:features/versions.adoc[Versions] +** xref:admin:newsletters.adoc[Newsletters] +** xref:admin:global_moderations.adoc[Globale Moderationen] +** Abgelehnt +*** xref:admin:information-pages.adoc[Informationsseiten] +* xref:mitmachen:index.adoc[Contribute] +** xref:contribute:governance.adoc[Governance] +** xref:contribute:translations.adoc[Translations] +** xref:mitwirken:documentation.adoc[Documentation] +* Develop +** xref:develop:guide.adoc[Guide] +*** xref:develop:guide_example_apps.adoc[1. Beispielanwendungen] +*** xref:develop:guide_development_app.adoc[2. Development App] +*** xref:develop:guide_commands.adoc[3. Commands] +*** xref:develop:guide_conventions.adoc[4. Conventions] +*** xref:develop:guide_architecture.adoc[5. Architecture] +** xref:develop:security.adoc[Security] +** Advanced +*** Concerns +**** xref:develop:authorable.adoc[Authorable] +**** xref:develop:embeddable.adoc[Embeddable] +**** xref:develop:endorsable.adoc[Endorsable] +**** xref:develop:followable.adoc[Followable] +**** xref:develop:reportable.adoc[Reportable] +**** xref:develop:traceable.adoc[Traceable] +**** xref:develop:machine_translations.adoc[TranslatableResource aka Machine Translations] +**** xref:develop:share_tokens.adoc[Shareable with Tokens] +*** xref:develop:api.adoc[API] +*** xref:develop:components.adoc[Components] +*** xref:develop:content_processors.adoc[Content Processors] +*** xref:develop:custom_seed_data.adoc[Custom Seed Data] +*** xref:develop:deploy.adoc[Deploy] +*** xref:develop:docker.adoc[Docker] +*** xref:develop:fixing_locales.adoc[Fixing locales] +*** xref:develop:guide_github_projects.adoc[GitHub Projects Workflow] +*** xref:develop:maps.adoc[Maps] +*** xref:develop:managing_translations_i18n.adoc[i18n] +*** xref:develop:metrics.adoc[Metrics] +*** xref:develop:modules.adoc[Modules] +*** xref:develop:notifications.adoc[Notifications] +*** xref:develop:open-data.adoc[Open Data] +*** xref:develop:permissions.adoc[Permissions] +*** xref:develop:profiling.adoc[Profiling] +*** xref:develop:releases.adoc[Releases] +*** xref:develop:templates.adoc[Templates] +*** xref:develop:testing.adoc[Testing] +*** xref:develop:guide_development_with_localhost_ssl.adoc[Testing SSL and Tenants in Development] +*** xref:develop:turbolinks.adoc[Turbolinks] +*** Views +**** xref:develop:content_blocks.adoc[Content Blocks] +**** xref:develop:data-picker.adoc[Data Picker] +**** xref:develop:newsletter_templates.adoc[Newsletter Templates] +**** xref:develop:view_hooks.adoc[View Hooks] +**** xref:develop:view_models_aka_cells.adoc[View Models (Cells)] +* Understand +** xref:understand:about.adoc[About] +** xref:understand:background.adoc[Background] +** xref:features:general-description.adoc[Features] +*** xref:features:participatory-spaces.adoc[Participatory spaces] +*** xref:features:components.adoc[Components] +*** xref:admin:participants.adoc[Participants] +*** xref:features:general-features.adoc[Allgemeine Merkmale] ++ +// ** xref:understand:governance.adoc[Project governance] + +// ** xref:understand:history.adoc[History of the project] + +// ** xref:understand:research.adoc[Research] + +** xref:understand:social-contract.adoc[Gesellschaftsvertrag] +*** xref:understand:social-contract-ca.adoc[Catalan] +*** xref:understand:social-contract-es.adoc[Castellano] +** Publikationen +*** xref:publications:catalan.adoc[Catalan] +*** xref:publications:german.adoc[English] +*** xref:publications:french.adoc[French] +*** xref:publications:german.adoc[German] +*** xref:publications:italian.adoc[Italian] +*** xref:publications:spanish.adoc[Spanish] +** Whitepaper +*** xref:whitepaper:decidim-a-brief-overview.adoc[Decidim: ein kurzer Überblick] +* xref:releases:index.adoc[Hinweise zur Veröffentlichung] \ No newline at end of file From 0f3cdf660c1ce189c0838bed67d160ef0910775c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:45 +0200 Subject: [PATCH 195/336] New translations index.adoc (German) --- docs/de/modules/ROOT/pages/index.adoc | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 docs/de/modules/ROOT/pages/index.adoc diff --git a/docs/de/modules/ROOT/pages/index.adoc b/docs/de/modules/ROOT/pages/index.adoc new file mode 100644 index 0000000000..fc5e4d20d1 --- /dev/null +++ b/docs/de/modules/ROOT/pages/index.adoc @@ -0,0 +1,24 @@ += Willkommen bei der Decidim-Dokumentation + +Dies ist die Dokumentationsseite zu Decidim, einer partizipatorischen Demokratieplattform, die ursprünglich vom Rathaus Barcelona geschaffen wurde. + +Decidim ist ein Framework, das es jedem erlaubt, eine Plattform zu erstellen und zu konfigurieren, in Form eines politischen Netzwerks für demokratische Partizipation. Die Plattform ermöglicht es jeder Organisation (Stadtrat, Vereinigung, Universität, NGO, Nachbarschaft oder Genossenschaft) Massenprozesse für die strategische Planung zu erstellen partizipative Budgetierung, gemeinschaftliche Gestaltung für Vorschriften, städtische Räume und Wahlprozesse. + +== Neu bei Decidim? + +Sie haben die Dokumentation für Decidim gefunden. Erfahren Sie mehr über das Projekt unter https://decidim.org[decidim.org]. + +[NOTE] +==== +This is the documentation for the `0.26` version. You can see this same documentation site for other versions: xref:v0.27@ROOT:index.adoc[v0.27] and xref:develop@ROOT:index.adoc[develop] +==== + +// * Read the xref:ROOT:getting-started.adoc[Getting Started guide] + +Die Dokumentation umfasst xref:install:index.adoc[installing], xref:configure:index.adoc[configuring]und xref:admin:index.adoc[running] Ihre eigene Decidim-Website. + +Wenn Sie Änderungen am Quellcode vornehmen möchten, haben wir auch eine Dokumentation für xref:develop:guide.adoc[developers]. + +Wenn du eine Organisation bist, die Decidim verwenden möchte, oder ein Entwickler, der an der Zusammenarbeit an der Software interessiert ist, bitte https://decidim.org/contact[get in contacch]. + +Decidim ist eine Gemeinschaftsanstrengung. Wenn du also Fehler in diesen Anleitungen findest, lass es uns bitte unter hola [at] Dezimierung [dot] Org wissen. Jede Hilfe ist willkommen. Wenn du ein GitHub Benutzer bist, kannst du sogar Änderungen an dieser Website mit dem Link Bearbeiten auf jeder Seite vorschlagen. \ No newline at end of file From efec67505d940d130ff806ce78a3cbdbfbe4ec4e Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:47 +0200 Subject: [PATCH 196/336] New translations appearance.adoc (German) --- docs/de/modules/admin/pages/appearance.adoc | 78 +++++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 docs/de/modules/admin/pages/appearance.adoc diff --git a/docs/de/modules/admin/pages/appearance.adoc b/docs/de/modules/admin/pages/appearance.adoc new file mode 100644 index 0000000000..1c47c6bc6c --- /dev/null +++ b/docs/de/modules/admin/pages/appearance.adoc @@ -0,0 +1,78 @@ += Aussehen + +Auf dieser Seite können Sie das Look-and-Feel Ihrer Decidim-Instanz konfigurieren. + +Bitte beachten Sie, dass dies mit einigen Änderungen, die Ihre Implementierer in Ihrer allgemeinen Installation ändern könnten, nicht vereinbar wäre. Wenn es zum Beispiel Änderungen im xref:customize:styles.adoc[Styles] gibt, konnte dies nicht funktionieren. + +image::admin_appearance.png[Decidim Admin Appearance] + +--- + +NOTE: Dies ist eine alte Einstellung, die in der nächsten Version entfernt wird. https://github.com/decidim/decidim/pull/6575[See PR]. + +* **Statistiken anzeigen**: ob die Statistiksektionen auf der Startseite angezeigt werden sollen oder nicht. + +--- + +* **Beschreibung**: Was ist die Beschreibung dieser Seite. Verwendet für Metatags für Google und Twitter Einbetten. Auch vom "SubHero" ContentBlock auf der Homepage verwendet. + +--- + +NOTE: Dies ist eine alte Einstellung, die in der nächsten Version entfernt wird. https://github.com/decidim/decidim/pull/6284[See PR]. + +* **Aufruf zu Aktion Button Pfad**: Du kannst überschreiben, wohin die Schaltfläche "Aufruf zum Handeln" in den Startseite-Links geht. Benutze hier partielle Pfade, nicht vollständige URLs. Akzeptiert Buchstaben, Zahlen, Bindestriche und Schrägstriche und muss mit einem Buchstaben beginnen. Der Button "Aufruf zum Handeln" wird auf der Homepage zwischen Willkommenstext und Beschreibung angezeigt. Beispiel: https://meta.decidim.org/conferences/decidimfest2020/ +* **Aktions-Buttontext anrufen**: Du kannst den Text der Schaltfläche "Aufruf zur Aktion" auf der Homepage für jede verfügbare Sprache in deinem Organisation überschreiben. Wenn nicht gesetzt, wird der Standardwert verwendet. Der Button "Aufruf zum Handeln" wird auf der Homepage zwischen Willkommenstext und Beschreibung angezeigt. + +--- + +NOTE: Dies ist eine alte Einstellung, die in der nächsten Version entfernt wird. Es gibt noch keine PR. + +* **Banner mit hochgestelltem Inhalt** +** *Zeigen Sie das hervorgehobene Inhaltsbanner an* +** *Title* +** *Short description* +** *Action button title* +** *Action button subtitle* +** *Action button URL* +** *Image* + +--- + +* *Edit omnipresent banner* +** **Show omnipresent banner** +** **Title** +** **Short description** +** **URL** + +--- + +* **Edit layout appearance** + +This subsection defines the images for the layout that will be visible in almost all the pages. These are: + +** Icon +** Logo +** Official logo header +** Official logo footer +** Official organization URL + +// TODO: Add examples + +--- + +* **Organization colors**: What are the colors for your organization. Please notice that this could generate accessibility problems, for instance with people that doesn't have a good contrast notion. You can set +** Primary +** Secondary +** Success +** Warning +** Alert +** Highlight +** Highlight, alternative + +// TODO: Add examples + +--- + +* **Header snippets**: Use this field to add things to the HTML head. The most common use is to integrate third-party services that require some extra JavaScript or CSS. Also, you can use it to add extra meta tags to the HTML. Note that this will only be rendered in public pages, not in the admin section. + +// TODO: reference to HTML snippet setting \ No newline at end of file From 6852782ae9e0c5913476025d45f56654de04c760 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:48 +0200 Subject: [PATCH 197/336] New translations areas.adoc (German) --- docs/de/modules/admin/pages/areas.adoc | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 docs/de/modules/admin/pages/areas.adoc diff --git a/docs/de/modules/admin/pages/areas.adoc b/docs/de/modules/admin/pages/areas.adoc new file mode 100644 index 0000000000..b25b26c414 --- /dev/null +++ b/docs/de/modules/admin/pages/areas.adoc @@ -0,0 +1,11 @@ += Areas + +include::partial$deprecated.adoc[] + +Areas are all the sectors that an Organization can have. + +They are pretty similar to xref:admin:scopes.adoc[scopes], meaning that they are a way of allowing a better navigation and filtering in the spaces and components. + +We don't recommend using them, as probably in the future they will be removed. + +You can read more information about the history of Areas in this https://github.com/decidim/decidim/issues/3540#issuecomment-427324532[GitHub comment]. \ No newline at end of file From 15758eaea3edc40ec7ef412a2d6b20270058b1e9 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:49 +0200 Subject: [PATCH 198/336] New translations components.adoc (German) --- docs/de/modules/admin/pages/components.adoc | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 docs/de/modules/admin/pages/components.adoc diff --git a/docs/de/modules/admin/pages/components.adoc b/docs/de/modules/admin/pages/components.adoc new file mode 100644 index 0000000000..602089c849 --- /dev/null +++ b/docs/de/modules/admin/pages/components.adoc @@ -0,0 +1,5 @@ += Components + +Through components an administrator can enable and configure different participatory mechanisms. + +include::partial$components_list.adoc[] \ No newline at end of file From 70f8bf7060f3a4bf72cafdeb30830e3e4a9c366c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:50 +0200 Subject: [PATCH 199/336] New translations blog.adoc (German) --- .../modules/admin/pages/components/blog.adoc | 145 ++++++++++++++++++ 1 file changed, 145 insertions(+) create mode 100644 docs/de/modules/admin/pages/components/blog.adoc diff --git a/docs/de/modules/admin/pages/components/blog.adoc b/docs/de/modules/admin/pages/components/blog.adoc new file mode 100644 index 0000000000..78febc841b --- /dev/null +++ b/docs/de/modules/admin/pages/components/blog.adoc @@ -0,0 +1,145 @@ += Blog + +The Blog component allows people to read multiple posts ordered by date. + +Some examples of where this component was used: + +* https://meta.decidim.org/processes/roadmap/f/247/[News in Propose new functionalities for Decidim software] in https://meta.decidim.org[Metadecidim] + +image:components/blog/example01.png[Example of blog posts list] +image:components/blog/example02.png[Example of a blog post] + +To configure the Blog component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies" or "Conferences". +. Go to components +. Click on "Add component" button +. Click on "Blog" +. Fill the xref:_add_component[Add component] form + +== Add component + +image:components/blog/component.png[Add component form] + + +.Add component: Blog form +|=== +|Field |Type |Description + +|Name +|Required +|What is the title of this component. For instance, "Blogs" + +|Order position +|Optional +|Which order will it have in relation to the other blogs. Having a lower number means a higher priority. +For instance, if you have two blogs, "Blog a" with weight "10" and "Blog b" with weight "0", then "Blog b" will be first when ordering. +|=== + + +.Add component: Blog form - Global settings +|=== +|Field |Type |Description + +|Announcement +|Optional +|A general announcement that'll be visible on the general blogs landing page. + +|Comments enabled +|Optional +|Whether you want to have comments in the meetings. + +|Comments max length +|Optional +|What is the characters limit that participants will have when making comments. Leave 0 for default value. +|=== + +In the cases where the space that this component will be used has xref:admin:spaces/processes/phases.adoc[Phases], for instance, in +xref:admin:spaces/processes.adoc[Participatory Processes], then you can also define different behaviors per Step. + + +.Add component: Blogs form - Step settings +|=== +|Field |Type |Description + +|Announcement +|Optional +|A general announcement that'll be visible on the general blog landing page. + +|Comments blocked +|Optional +|Whether you want to enable comments creation for this phase. + +|Endorsements enabled +|Optional +|Whether you want to enable endorsements for this phase. + +|Endorsements blocked +|Optional +|Whether you want to disable adding new endorsements for this phase. +|=== + +== Permissions + +An administrator can choose which kind of xref:customize:authorizations.adoc[Authorizations] a participant need to have to make +certain actions in the blogs: + +* Comment +* Endorse + +== Manage posts + +image:components/blog/manage_posts.png[Manage posts table] + +=== New post form + +image:components/blog/new_post.png[New post form] + + +.New post form +|=== +|Field |Type |Description + +|Create post as +|Required +|Participant account or user group that will be the author of the post. + +|Title +|Required +|What is the title of this post. + +|Body +|Required +|What is the description of this post. +|=== + +==== Actions + + +.Actions +|=== +|Icon |Name |Definition + +|image:action_edit.png[Edit icon] +|Edit +|Edit form for this post. It's the same form as "New post". + +|image:action_folder.png[Folder icon] +|Folder +|For classifying Attachments. + +|image:action_attachments.png[Attachments icon] +|Attachments +|Documents that are related to the post. + +|image:action_permissions.png[Permissions icon] +|Permissions +|To handle the permissions of this post, depending on the verification a participant has. + +|image:action_delete.png[Delete icon] +|Delete +|To delete this post. +|=== \ No newline at end of file From 8baa912a3ab8a5f7c9440f7ee8eb635d1b5463bc Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:51 +0200 Subject: [PATCH 200/336] New translations budgets.adoc (German) --- .../admin/pages/components/budgets.adoc | 357 ++++++++++++++++++ 1 file changed, 357 insertions(+) create mode 100644 docs/de/modules/admin/pages/components/budgets.adoc diff --git a/docs/de/modules/admin/pages/components/budgets.adoc b/docs/de/modules/admin/pages/components/budgets.adoc new file mode 100644 index 0000000000..e2f4d81332 --- /dev/null +++ b/docs/de/modules/admin/pages/components/budgets.adoc @@ -0,0 +1,357 @@ += Budgets + +:page-toclevels: 4 + +The Budgets component allows people to vote by selecting projects of their choosing. Depending on the needs and normative +of the organization, this could be configured so people have assigned a total budget (for instance, 100.000 EUR) and then +every project has assigned a value (for instance, 10.000 EUR). Then when people vote on projects, they have a progress bar +where they see how much remaining budget they have to allocate in this voting. + +From this starting point, there could be other configurations, such as: + +* A minimum percentage of budget to be allocated +* A minimum number of projects to be allocated +* Multiple budgets, one for each district or neighborhood + +Some examples of where this component was used: + +* https://www.decidim.barcelona/processes/PressupostosParticipatius[2020/2021 Participatory Budgeting Process in Decidim Barcelona]. +The city of Barcelona (Spain) has allocated a budget of 30.000.000 EUR so people can present, define, prioritize, vote +and choose which investment projects the city goverment should execute. +* https://ecrivons.angers.fr/processes/BP2021[2021 Participatory Budgeting Process in Angers]. The city of Angers (France) has allocated +a budget of 1.000.000 EUR so people from 11 years can propose maximum of 3 ideas and then vote for their 5 favorite projects. +* https://omastadi.hel.fi/[2021 Participatory Budgeting Process in Helsinki]. Helsinki has allocated 8.8 million euros to realising +residents’ wishes. The ideas are developed together into proposals that Helsinki residents can vote on. The proposals with the +most votes are realised by the City. + +image:components/budgets/example01.png[Budgets example voting] +image:components/budgets/example02.png[Budgets example error messagge when exceding the amount of budget] +image:components/budgets/example03.png[Budgets vote confirmation] +image:components/budgets/example04.png[Budgets after voting] + +To configure the Budgets component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies" or "Conferences". +. Go to components +. Click on "Add component" button +. Click on "Budgets" +. Fill the xref:_add_component[Add component] form + +== Add component + +image:components/budgets/component.png[Add component form] + + +.Add component: Budgets form +|=== +|Field |Type |Description + +|Name +|Required +|What is the title of this component. For instance, "Budgets" + +|Order position +|Optional +|Which order will it have in relation to the other budgets. Having a lower number means a higher priority. +For instance, if you have two budgets, "Budget a" with weight "10" and "Budget b" with weight "0", then "Budget b" will be first when ordering. +|=== + + +.Add component: Budgets form - Global settings +|=== +|Field |Type |Description + +|Scopes enabled +|Optional +|Check if you want to have Scopes filtering in this component. + +|Scope +|Optional +|Which xref:admin:scopes.adoc[Scope] does this component belongs to. + +|Global scope +|Optional +| + +|xref:_workflows[Workflow] +|Required +|How the participants can vote if there are multiple budget sets. You can define your own xref:_workflows[Workflow] or use one of the availables. + +|Projects per page +|Required +|How many projects are displayed per page. + +|Enable rule: Minimum budget percentage +|Optional, but incompatible with "Minimum number of projects to be voted on" and "Selected projects with minimum and maximum number of projects to be voted on" +|Allows to define a "Vote threshold percent", a percent of the total budget that participants must reach to be able to vote. + +|Enable rule: Minimum number of projects to be voted on +|Optional, but incompatible with "Minimum budget percentage" and "Selected projects with minimum and maximum number of projects to be voted on" +|Allows to define a "Minimum number of projects to vote", a number of projects that participants must reach to be able to vote. + +|Enable rule: Selected projects with minimum and maximum number of projects to be voted on +|Optional, but incompatible with "Minimum budget percentage" and "Minimum number of projects to be voted on" +|Allows to define a "Minimum amount of projects to be selected" and a "Maximum amount of projects to be selected", the number of projects +that participants will need to vote as a minimum and maximum. + +|Comments enabled +|Optional +|Whether you want to have comments in the meetings. + +|Comments max length +|Optional +|What is the characters limit that participants will have when making comments. Leave 0 for default value. + +|Actions permissions can be set for each project +|Optional +|Whether you want to be able to set permissions for every one of the projects. Most of the time you will want to leave this option disabled. + +|Announcement +|Optional +|A general announcement that'll be visible on the general budgets landing page. + +|Budgets landing page +|Optional +|What message will be shown in the Budgets landing page when there are multiple budgets. + +|More information modal +|Optional +|What message will be shown when clicking on the "More information" link. +|=== + +In the cases where the space that this component will be used has xref:admin:spaces/processes/phases.adoc[Phases], for instance, in +xref:admin:spaces/processes.adoc[Participatory Processes], then you can also define different behaviors per Step. + + +.Add component: Budgets form - Step settings +|=== +|Field |Type |Description + +|Comments blocked +|Optional +|Whether you want to enable comments for this phase. + +|Voting +|Required +|Choose one of the following options depending in the moment of the process: Voting disabled, Voting enabled or Voting finished. + +|Show votes +|Optional +|Wheter the votes will be shown. We strongly recommend that you only check this option after the voting is finished. + +|Announcement +|Optional +|A general announcement that'll be visible on the general budgets landing page. + +|Budgets landing page +|Optional +|What message will be shown in the Budgets landing page when there are multiple budgets. + +|More information modal +|Optional +|What message will be shown when clicking on the "More information" link. +|=== + +== Permissions + +Edit permissions + +* Vote +* Comment + +== Workflows + +One neat feature of the Budgets component is the ability to define your own workflows. + +This means that you can define multiple Budgets, for instance one for every Neighberhood or District that a City has, and +you can also define multiple rullings regarding how people can vote on those Budgets. By default you have these workflows: + +* Vote in one: allows participants to vote in any budget, but only in one. +* Vote in all: allows participants to vote in all budgets. +* Vote in a random component: allows participants to vote only in one budget, selected randomly. + +But this can be extended in your application by a developer, by making your own Workflows. For instance for the +https://www.decidim.barcelona/processes/PressupostosParticipatius[2020/2021 Participatory Budgeting Process in Decidim Barcelona], +the people could vote in two districts: the one where they lived and one of their choosing. This was defined in the +https://github.com/AjuntamentdeBarcelona/decidim-barcelona/blob/743be2a210e8745d2dc443166642b285aed2b356/lib/budgets_workflow_pam2021.rb[decidim-barcelona application itself]. + +You can read more about Worfklows in https://github.com/decidim/decidim/blob/1ab5cd8fdabef48f5be94ff9c30c6bb3bc9a2f8f/decidim-budgets/README.md#budget-workflows[decidim-budgets README.md]. + +NOTE: You only want to have a voting without much complications? Like a city-wide vote? Don't worry: if you define only one +Budget, then people will go there directly when click in the Budgets section. + +== Manage budgets + +image:components/budgets/manage_budgets.png[Manage budgets table] + +This window also lets you see the votes that the various projects have received. (Number of votes) and the total number of votes (*Finished votes* and *Pending votes*, that is, that a participant has started voting but has still not cast their vote). + +=== Export all + +Allows to export the projects for this budget in different formats. + +* Projects as CSV +* Projects as JSON +* Projects as Excel + +=== New budget form + +image:components/budgets/new_budget.png[New budget form] + + +.New budget form +|=== +|Field |Type |Description + +|Title +|Required +|What is the title of this budget. For instance, "District A" + +|Order position +|Optional +|Which order will it have in relation to the other budgets. Having a lower number means a higher priority. +For instance, if you have two budgets, "Budget a" with weight "10" and "Budget b" with weight "0", then "Budget b" will be first when ordering. + +|Description +|Optional +|What is the description of this budget. + +|Total budget +|Required +|What is the total amount of money that people will have for assigning. +|=== + +==== Actions + + +.Actions +|=== +|Icon |Name |Definition + +|image:action_preview.png[Preview icon] +|Preview +|To see how it's shown in the frontend to participants. + +|image:action_list.png[Manage projects icon] +|xref:_manage_projects[Manage projects] +|Allows you to manage the projects of a budget. + +|image:action_edit.png[Edit icon] +|Edit +|Edit form for a budget. It's the same form as "New budget". + +|image:action_delete.png[Delete icon] +|Delete +|To delete this budget. Only can be done when there aren't any projects. +|=== + +==== Manage projects + +===== Import proposals to projects + +Depending in the normative, you could want to have a first phase where participants +make proposals, and those proposals are selected (by voting or by technical review), +then you can import those proposals and convert them to projects. + +For this to work: + +. The following settings in the proposals component need to be enabled: +.. Proposal answering enabled +.. Enable costs on proposal answers +. A valuator or administrator need to Answer proposals: +.. Review the proposals +.. Accept or reject them according to your normative +.. Add costs to the proposals if were accepted +. An administrator can Import proposals to projects + +image:components/budgets/import_proposals.png[Import proposals to projects] + +===== Export all + +Allows to export the projects for this budget in different formats. + +* Projects as CSV +* Projects as JSON +* Projects as Excel + +===== New project form + +image:components/budgets/new_project.png[New project form for a Budget] + + +.New project form +|=== +|Field |Type |Description + +|Title +|Required +|The title for this project. + +|Description +|Required +|A description of what this project is about. + +|Budget amount +|Required +|What's the budget amount for this project. How much money will it cost to implement this project? + +|Category +|Optional +|Which Category has the project. Used for filtering in the budgets list. + +|Proposals +|Optional +|Choose related proposals for this project. Automatic assingned when importing proposals. + +|Add an image gallery +|Optional +|Add multiple images illustrating what this project is about, or where it will be implemented. +|=== + +===== Actions + + +.Actions +|=== +|Icon |Name |Definition + +|image:action_preview.png[Preview icon] +|Preview +|To see how it's shown in the frontend to participants. + +|image:action_edit.png[Edit icon] +|Edit +|Edit form for a project. It's the same form as "New project". + +|image:action_folder.png[Folders icon] +|Folders +|For classifying Attachments. + +|image:action_attachments.png[Attachments icon] +|Attachments +|Documents that are related to the project. + +|image:action_delete.png[Delete icon] +|Delete +|To delete this project. +|=== + +== Results + +After the voting step has finished, then an administrator need to: + +. Change the Voting configuration for the Budget component to "Voting finished" +. Go to the Budgets and view the results +. On the projects that according to the normative have been selected, she'll need to go to each project, edit it and +then check the "Selected for implementation". + +image:components/budgets/results_unselected.png[Unselected projects after voting] +image:components/budgets/results_select_project.png[Select a project for implementation] +image:components/budgets/results_selected.png[Selected projects after voting] +image:components/budgets/results_selected_frontend.png[Selected projects after voting in the frontend] + +We strongly recommend that after you have selected projects then you enable the Accountability +component so participants can see the grade of implementation. \ No newline at end of file From fec70030d86b015603d54476d8dd38ff6b2ff809 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:52 +0200 Subject: [PATCH 201/336] New translations debates.adoc (German) --- .../admin/pages/components/debates.adoc | 230 ++++++++++++++++++ 1 file changed, 230 insertions(+) create mode 100644 docs/de/modules/admin/pages/components/debates.adoc diff --git a/docs/de/modules/admin/pages/components/debates.adoc b/docs/de/modules/admin/pages/components/debates.adoc new file mode 100644 index 0000000000..6f62a9f8b5 --- /dev/null +++ b/docs/de/modules/admin/pages/components/debates.adoc @@ -0,0 +1,230 @@ += Debate + +The Debate component allows people to have discussions, without voting nor prioritzation. It also allows to close them, +by adding conclusions or a summary of what the discussion was about. + +From this starting point, there could be other configurations, such as: + +* To allow debates creation by participants +* To have debates with a fixed started and ending date or open +* To show endorsements (public supports) or not + +Some examples of where this component was used: + +* https://meta.decidim.org/processes/roadmap/f/219/[Propose new functionalities for Decidim software in Metadecidim] + +image:components/debates/example01.png[Debates listing example] +image:components/debates/example02.png[Debate example] + +To configure the Debate component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies" or "Conferences". +. Go to components +. Click on "Add component" button +. Click on "Debate" +. Fill the xref:_add_component[Add component] form + +== Add component + +image:components/debates/component.png[Add component form] + + +.Add component: Debate form +|=== +|Field |Type |Description + +|Name +|Required +|What is the title of this component. For instance, "Debates" + +|Order position +|Optional +|Which order will it have in relation to the other debates. Having a lower number means a higher priority. +For instance, if you have two debates, "Debate a" with weight "10" and "Debate b" with weight "0", then "Debate b" will be first when ordering. +|=== + + +.Add component: Debate form - Global settings +|=== +|Field |Type |Description + +|Scopes enabled +|Optional +|Check if you want to have Scopes filtering in this component. + +|Scope +|Optional +|Which xref:admin:scopes.adoc[Scope] does this component belongs to. + +|Global scope +|Optional +| + +|Comments enabled +|Optional +|Whether you want to have comments in the meetings. + +|Comments max length +|Optional +|What is the characters limit that participants will have when making comments. Leave 0 for default value. + +|Announcement +|Optional +|A general announcement that'll be visible on the general debates landing page. +|=== + +In the cases where the space that this component will be used has xref:admin:spaces/processes/phases.adoc[Phases], for instance, in +xref:admin:spaces/processes.adoc[Participatory Processes], then you can also define different behaviors per Step. + + +.Add component: Debates form - Step settings +|=== +|Field |Type |Description + +|Endorsements enabled +|Optional +|Check if you want that participants show public support for these debates. + +|Endorsements blocked +|Optional +| + +|Debate creation by participants enabled +|Optional +|Check if you want to allow the creation of new debates by participants. + +|Comments blocked +|Optional +|Whether you want to enable comments for this phase. + +|Announcement +|Optional +|A general announcement that'll be visible on the general debate landing page. +|=== + +== Permissions + +An administrator can choose which kind of xref:customize:authorizations.adoc[Authorizations] a participant need to have to make +certain actions in the debates: + +* Create +* Endorse + +== Manage debates + +image:components/debates/manage_debates.png[Manage debates table] + +=== Export all + +Allows exporting the comments in the debates in different formats. + +* Comments as CSV +* Comments as JSON +* Comments as Excel + +=== New debate form + +image:components/debates/new_debate_backend.png[New debate backend form] + + +.New debate form +|=== +|Field |Type |Description + +|Title +|Required +|What is the title of this debate. For instance, "How can we improve this process?" + +|Description +|Required +|What is the description of this debate. + +|Instructions to participate +|Required +|Add a message for the participants. + +|Information updates +|Optional +|Add a message for the participants. + +|xref:_debate_types[Debate type] +|Required +|Choose between Finite and Open. Finite means that the debate has a starting and ending date and time, Open means that +there isn't any timeframe. + +|Starts at +|Required if the debate type is Finite +|Expected format: dd/mm/yyyy hh:ii + +|Ends at +|Required if the debate type is Finite +|Expected format: dd/mm/yyyy hh:ii + +|Category +|Optional +|Which category has the debate. Used for filtering in the debates list. +|=== + +==== Debate types + +It's possible to have two kinds of debates: + +. Finite: with a start and end date +. Open: without a start and end date + +This is shown publically in the debate list. + +image:components/debates/debates_list.png[Debates list] +image:components/debates/debate_finite.png[Finite debate] + +==== Actions + + +.Actions +|=== +|Icon |Name |Definition + +|image:action_edit.png[Edit icon] +|Edit +|Edit form for a debate. It's the same form as "New debate". + +|image:action_close.png[Close icon] +|Close +|Close form for a debate. For adding conclusions. + +|image:action_permissions.png[Permissions icon] +|Permissions +|To handle the permissions of this debate, depending on the verification a participant has. + +|image:action_delete.png[Delete icon] +|Delete +|To delete this debate. Only can be done when there aren't any projects. +|=== + +=== Close debate form + +A debate can be closed. This is useful for adding conclusions. After a debate was closed it can't be edited nor commented any more + +image:components/debates/close_debate_backend.png[Close debate backend form] + +Take in account that if the debate was created by a participant then only that +participant can close it. + +image:components/debates/close_debate_frontend.png[Close debate frontend form] + + +.Close debate form +|=== +|Field |Type |Description + +|Conclusions +|Required +|What is the conclusion for this debate. +|=== + +The conclusions are shown publicly with the close date and time. + +image:components/debates/debate_closed.png[Closed debate] \ No newline at end of file From c0502f714c3948bebd20f17801655185ad27fa4f Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:53 +0200 Subject: [PATCH 202/336] New translations elections.adoc (German) --- docs/de/modules/admin/pages/components/elections.adoc | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 docs/de/modules/admin/pages/components/elections.adoc diff --git a/docs/de/modules/admin/pages/components/elections.adoc b/docs/de/modules/admin/pages/components/elections.adoc new file mode 100644 index 0000000000..d8d661054c --- /dev/null +++ b/docs/de/modules/admin/pages/components/elections.adoc @@ -0,0 +1,3 @@ += Elections + +include::admin:partial$development.adoc[] \ No newline at end of file From d6245f5353766557cd77be99673dbb07eba91ad7 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:54 +0200 Subject: [PATCH 203/336] New translations meetings.adoc (German) --- .../admin/pages/components/meetings.adoc | 411 ++++++++++++++++++ 1 file changed, 411 insertions(+) create mode 100644 docs/de/modules/admin/pages/components/meetings.adoc diff --git a/docs/de/modules/admin/pages/components/meetings.adoc b/docs/de/modules/admin/pages/components/meetings.adoc new file mode 100644 index 0000000000..96b29fa84e --- /dev/null +++ b/docs/de/modules/admin/pages/components/meetings.adoc @@ -0,0 +1,411 @@ += Meetings + +Meetings are where people come together to discuss or inform about a given topic. All the meetings have a given location +(where the meeting will happen) and start and end date and time (when the meeting will happen). + +Some examples of where this component was used are: + +* https://www.decidim.barcelona/processes/PAM2020/f/3734/[Procés participatiu del Programa d'Actuació Municipal (PAM) 2020-2023] +in https://www.decidim.barcelona/[Decidim Barcelona] +* https://lejourdapres.parlement-ouvert.fr/processes/ateliers/f/14/[Les ateliers] in https://lejourdapres.parlement-ouvert.fr/[Le jour d'après] + +image:components/meetings/example01.png[Meetings list in Decidim Barcelona] +image:components/meetings/example02.png[Example meeting detail 01 in Decidim Barcelona] +image:components/meetings/example03.png[Example meeting detail 02 in Decidim Barcelona] +image:components/meetings/example04.png[Meetings list in Le jour d'après] + +== Types + +Regarding the *location*, depending on the configuration of the component, you can have: + +* In-person meetings: where you get together in a given location +* Online meetings: where you get together using an external service (for instance Jitsi Meet) + +Depending in the *author* (who's the person that's making the call): + +* Official meetings: meetings created by the organization (created by an administrator through the panel) +* Citizens meetings: meetings created by a User participant (a User or an UserGroup). + +== Add the component + +image:components/meetings/component.png[Add a meetings component] + +For adding the component, you need to: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Go to components +. Click on "Add component" button +. Click on "Meetings" +. Fill the xref:_add_component[Add component] form + +== Add component + +For configuring the meeting component you have these settings: + + +.Add component - Meetings form +|=== +|Field |Type |Description + +|Name +|Required +|What is the name of this component. + +|Order position +|Optional +|Which order will it have in relation with the other components. Having a lower number means a higher priority. For instance, +if you have two components, "Proposals" with weight "10" and "Meetiings" with weight "0", then "Meetings" will be first when ordering. +|=== + + +.Add component - Meetings form: Global settings +|=== +|Field |Type |Description + +|Scopes enabled +|Optional +|Check if you want to have Scopes filtering in this process. + +|Scope +|Optional +|Which scope will be used for this component. + +|Announcement +|Optional +|A general announcement that'll be visible in the general meetings list. + +|Default registration terms +|Optional +|What'll be the registration terms of service that the participant would need to accept when registering. + +|Comments enabled +|Optional +|Whether you want to have comments in the meetings. + +|Comments max length +|Optional +|What is the characters limit that participants will have when making comments. Leave 0 for default value. + +|Registration code enabled +|Optional +|Check if you want to give registration codes to participants. Learn more in xref:components/meetings/registrations.adoc[Registrations]. + +|Actions permissions can be set for each meeting +|Optional +|If you want more granular permissions inside of every one of the Meetings. + +|Enable pads creation +|Optional +|If you want an Etherpad embedded in your meetings. Must have the xref:services:etherpad.adoc[Etherpad] integration configurated. + +|Participants can create meetings +|Optional +|Allows participants to create new meetings. See xref:_citizens_meetings[Citizens meetings] + +|Maps enabled +|Optional +|Wheter you want to show a map in the meetings in the meeting detail. +|=== + + +.Add component - Meetings form: Step settings +|=== +|Field |Type |Description + +|Announcement +|Optional +|A general announcement that'll be visible in the general meetings list. + +|Comments enabled +|Optional +|Whether you want to have comments in the meetings. +|=== + +== Create a new meeting + +=== Citizens meetings + +Meetings can be created by participants if the setting is "Participants can create meetings" is checked. + +If a participant belongs to a xref:admin:participants/groups.adoc[user group], then she'll be able to create meetings as that group also. + +image:components/meetings/new_meeting_form_frontend01.png[Create a new meeting form (frontend)] +image:components/meetings/new_meeting_form_frontend02.png[Create a new meeting form (frontend)] + + +.Create meeting - Frontend form +|=== +|Field |Type |Description + +|Title +|Required +|What is the title for this meeting. + +|Description +|Required +|A description of what will be discussed in this meeting, like the topics. + +|Type +|Required +|Choose one option between "In person", "Online" or "Booth" + +|Address +|Required if meeting type is "In person" or "Booth" +|Address: used by Geocoder to find the location + +|Location +|Required +|Location: message directed to the users implying the spot to meet at + +|Location hints +|Optional +|Location hints: additional info. Example: the floor of the building + +|Online meeting URL +|Optional +|Which URL will the meeting be held. + +|Show embedded iframe for this URL +|Optional +|Whether or not embed the iframe for this videoconference URL. Only a few services allow embedding (i.e. YouTube, Twitch...) + +|Start Time +|Required +|Which day and time will the meeting start. Expected format: dd/mm/yyyy hh:ii + +|End Time +|Required +|Which day and time will the meeting start. Expected format: dd/mm/yyyy hh:ii + +|Category +|Optional +|Which Category has the meeting. Used for filtering in the meetings list. + +|Registration type +|Required +|Choose one option between "Registration disabled", "On this platform", or "On a different platform" + +|Available slots for this meeting +|Required if "Registration type" is "On this platform" +|How many slots are available for this meeting? Leave it to 0 if you have unlimited slots available + +|Registration terms +|Required if "Registration type" is "On this platform" +|What terms of services participants need to accept to register or join the meeting. Specific to "Citizens meetings" + +|Registration URL +|Required if "Registration type" is "On a different platform" +|Must be an URL. Link to go on the external service that you are using for registrations. + +|Create meeting as +|Required if the participant belongs to a group +|With which identity she wants to create this meeting: as her user or as a group that she's reprensenting? +|=== + +After creating the meeting, participants can also edit and xref:components/meetings/close.adoc[close] it. + +=== Official meetings + +image:components/meetings/new_meeting_form_backend.png[Create a new meeting form (backend)] + + +.Create meeting - Backend form +|=== +|Field |Type |Description + +|Title +|Required +|What is the title for this meeting. + +|Description +|Required +|A description of what will be discussed in this meeting, like the topics. + +|Type +|Required +|Choose one option between "In person", "Online" or "Booth" + +|Address +|Required if meeting type is "In person" or "Booth" +|Address: used by Geocoder to find the location + +|Location +|Required +|Location: message directed to the users implying the spot to meet at + +|Location hints +|Optional +|Location hints: additional info. Example: the floor of the building + +|Online meeting URL +|Optional +|Which URL will the meeting be held. + +|Show embedded iframe for this URL +|Optional +|Whether or not embed the iframe for this videoconference URL. Only a few services allow embedding (i.e. YouTube, Twitch...) + +|Start Time +|Required +|Which day and time will the meeting start. Expected format: dd/mm/yyyy hh:ii + +|End Time +|Required +|Which day and time will the meeting start. Expected format: dd/mm/yyyy hh:ii + +|Category +|Optional +|Which Category has the meeting. Used for filtering in the meetings list. + +|Registration type +|Required +|Choose one option between "Registration disabled", "On this platform", or "On a different platform" + +|Available slots for this meeting +|Required if "Registration type" is "On this platform" +|How many slots are available for this meeting? Leave it to 0 if you have unlimited slots available + +|Registration URL +|Required if "Registration type" is "On a different platform" +|Must be an URL. Link to go on the external service that you are using for registrations. + +|Private meeting +|Optional +|Check if the meeting shouldn't be visible for all the visitors. Specific to "Official meetings". + +|Transparent +|Optional +|Related to "Private meeting", check if the meeting should be visible for all the visitors but they shouldn't be able to +participate in. Specific to "Official meetings". Specific to "Official meetings". + +|Customize registration email +|Optional +|Wheter you want to add a message in the registration email. Specific to "Official meetings". + +|Registration email custom content +|Required if "Customize registration email" is checked +|The content of the customized email. This text will appear in the middle of the registration confirmation email. Just +after the registration code. Specific to "Official meetings". +|=== + +You can also define *Services* inside of a Meeting. These are metadata that allows to comunicate, for instance, if there's +a place for children, deaf assistance, translations, etc. You can have multiple services inside of a meeting. + + +.Create meeting - Services +|=== +|Field |Type |Description + +|Title +|Required +|Title of the service. + +|Description +|Optional +|Description of the service. +|=== + +== Actions + +=== Citizens meetings + + +.Actions - Citizens meetings +|=== +|Icon |Name |Definition + +|image:action_preview.png[Preview icon] +|Preview +|To see how it's shown in the frontend to participants. + +|image:action_permissions.png[Permissions icon] +|Permissions +|To handle the permissions of this meeting, depending on the verification a participant has. Allows an admin to configure +who can *Join* a meeting. +|=== + +=== Official meetings + + +.Actions - Official meetings +|=== +|Icon |Name |Definition + +|image:action_publish.png[Publish icon] +|Publish +|To show publicly the meeting. + +|image:action_publish.png[Unpublish icon] +|Unpublish +|To not show publicly the meeting. + +|image:action_preview.png[Preview icon] +|Preview +|To see how it's shown in the frontend to participants. + +|image:action_duplicate.png[Duplicate icon] +|Duplicate +|Allows an admin to duplicate a meeting. + +|image:action_registrations.png[Registrations icon] +|xref:admin:components/meetings/registrations.adoc[Registrations] +|Allows to define who can register for attending to the meeting. + +|image:action_edit.png[Edit icon] +|Edit +|Edit form for a Meeting. It's the same form as "Create a new meeting". + +|image:action_agenda.png[Agenda icon] +|xref:admin:components/meetings/agenda.adoc[Agenda] +|To add the topics that will be discussed in the meeting. + +|image:action_list.png[Poll icon] +|xref:admin:components/meetings/polls.adoc[Polls] +|To manage the polls for this online meeting. + +|image:action_close.png[Close icon] +|xref:admin:components/meetings/close.adoc[Close] +|Allows and admin to Close the meeting and add extra information. + +|image:action_folder.png[Folders icon] +|Folders +|For classifying Attachments. + +|image:action_attachments.png[Attachments icon] +|Attachments +|Documents that are related to the meeting. + +|image:action_permissions.png[Permissions icon] +|Permissions +|To handle the permissions of this meeting, depending on the verification a participant has. Allows an admin to configure +who can *Join* a meeting. + +|image:action_delete.png[Delete icon] +|Delete +|To delete this meeting. +|=== + +== Meetings features + +There are different kinds of features that can be enabled in meetings, such as: + +* xref:admin:components/meetings/registrations.adoc[Registrations]: for managing how particpant can register to attend the meeting. +* xref:admin:components/meetings/agenda.adoc[Agenda]: for seeing the topics that will be discussed in the meeting by minutes. +* xref:admin:components/meetings/polls.adoc[Polls]: for quick voting during an online meeting. +* xref:admin:components/meetings/close.adoc[Close]: for adding the final report on what was discussed in the meeting. + +== Online meetings + +Depending in the moment and configuration of the meeting, there could be different messages that will be shown to the participants. + +. If the "Online meeting URL" ins't set, there'll be a message that says "Link available soon" +image:components/meetings/online_meeting_available_soon.png[Online meeting available soon] +. If the "Online meeting URL" is set, and a few minutes before the meeting start, the mesage will say "The link to join +the meeting will be available a few minutes before it starts" +image:components/meetings/online_meeting_available_before.png[Online meeting available before it starts] +. If the "Online meeting URL" is set, and the start time of the meeting has arrived, then there'll be a message that says +that "the meeting is happening right now", with a link to join the meeting. +image:components/meetings/online_meeting_happening.png[Online meeting available before it starts] \ No newline at end of file From d8e773158b1ef94b5c5896747a936b42b1003049 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:56 +0200 Subject: [PATCH 204/336] New translations agenda.adoc (German) --- .../pages/components/meetings/agenda.adoc | 91 +++++++++++++++++++ 1 file changed, 91 insertions(+) create mode 100644 docs/de/modules/admin/pages/components/meetings/agenda.adoc diff --git a/docs/de/modules/admin/pages/components/meetings/agenda.adoc b/docs/de/modules/admin/pages/components/meetings/agenda.adoc new file mode 100644 index 0000000000..5ec6d771ab --- /dev/null +++ b/docs/de/modules/admin/pages/components/meetings/agenda.adoc @@ -0,0 +1,91 @@ += Agenda + +The agenda feature allows an administrator to define the schedule for a meeting. It's possible to define agenda items and +sub-items, with every one of the topics that will be discussed in the meeting, along with a description and the duration +of every item and sub-item. + +image:components/meetings/agenda/agenda_frontend.png[Agenda in the frontend] + +== New agenda form + +To define an agenda for a meeting: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Click on "Meetings" +. Search the meeting that you want to add the agenda to +. Click on the "Agenda" button image:action_agenda.png[Agenda button] +. Fill the form + +image:components/meetings/agenda/new_agenda_form.png[New agenda form in the backend] + + +.New agenda form +|=== +|Field |Type |Description + +|Title +|Required +|Title for the agenda. For instance, "Schedule" + +|Visible +|Optional +|Check if you want to publish the agenda. + +|Agenda items +|Required +|List of agenda items. +|=== + +It's possible to create any number of Agenda items and sub-items. You can up or down the hierarchy of the agenda items. +It's also possible to remove and edit the agenda items. + + +.Agenda item form +|=== +|Field |Type |Description + +|Title +|Required +|Title for the agenda item + +|Duration +|Required +|How many minutes will the agenda item last. For instance, "15". + +|Description +|Optional +|Title for the agenda item + +|Agenda sub-items +|Optional +|List of agenda sub-items. +|=== + +The only limitation that agenda items and sub-items have is that they have to respect the duration of the parent. For instance, +if there's an Item that lasts 60 minutes, you can't create a sub-item that lasts 90 minutes. + +As an example, this agenda: + +image:components/meetings/agenda/agenda_frontend.png[Agenda in the frontend] + +Has the following configuration: + +* Title: "Schedule" +* Visible: true +* Agenda item #1: +** Title: Diagnosis +** Duration: 60 +* Agenda item #2: +** Title: Ideation +** Duration: 120 +** Agenda sub-item #2.1: +*** Title: Future thinking +*** Duration: 60 +*** Description: Imagining how we can solve the problem +** Agenda sub-item #2.2: +*** Title: Creating proposals +*** Duration: 60 +*** Description: In the platform \ No newline at end of file From 4fd3a669347c219d09ccfc286858a19299a2e327 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:56 +0200 Subject: [PATCH 205/336] New translations close.adoc (German) --- .../pages/components/meetings/close.adoc | 103 ++++++++++++++++++ 1 file changed, 103 insertions(+) create mode 100644 docs/de/modules/admin/pages/components/meetings/close.adoc diff --git a/docs/de/modules/admin/pages/components/meetings/close.adoc b/docs/de/modules/admin/pages/components/meetings/close.adoc new file mode 100644 index 0000000000..f598ec1e90 --- /dev/null +++ b/docs/de/modules/admin/pages/components/meetings/close.adoc @@ -0,0 +1,103 @@ += Close + +After a meeting has passed it's possible and recommened to close the meeting. This allows to adds the minutes, the notes +that gives a summary on what was discussed during the meeting, the agreements reached, decisions made, etc. + +This allows to bring transparency to the meeting and also serves as a record of the different meetings. + +It's also possible to add other kind of metadata to the meeting, such as what organizations has attended, how many attendees +and contributions were, and what proposals were discussed. + +image:components/meetings/close/frontend.png[Close report in the frontend] + +== Close meeting form + +=== Official meetings + +To close a meeting: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Click on "Meetings" +. Search the meeting that you want to close +. Click on the "Close" button image:action_close.png[Close button] +. Fill the form + +image:components/meetings/close/form_backend.png[Close meeting form in the backend] + + +.Close meeting form (backend) +|=== +|Field |Type |Description + +|Minutes +|Required +|Description of what happened in the meeting. + +|List of organizations that attended +|Optional +|Metadata that gets shown in the sidebar of the meeting. + +|Number of attendees +|Required +|Metadata that gets shown in the sidebar of the meeting. Must be a number. + +|Number of contributions +|Optional +|Metadata that gets shown in the sidebar of the meeting. Must be a number. + +|Proposals +|Optional +|Choose proposals from this space that were discussed in this meeting + +|Video URL +|Optional +|It's not used for anything. It will be removed in the future. + +|Audio URL +|Optional +|It's not used for anything. It will be removed in the future. + +|Is visible +|Optional +|Check if you want to publish the close report +|=== + +=== Citizens meetings + +Just like participants can create meetings, they can also close a meeting. They have fewer fields to fill. + +To close a a meeting: + +. Sign in as the participant that created the meeting +. Go to the meeting page +. Click on "Close". This will only be visible after the meeting has passed +. Fill the form + +image:components/meetings/close/form_frontend.png[Close meeting form in the frontend] + + +.Close meeting form (frontend) +|=== +|Field |Type |Description + +|Minutes +|Required +|Description of what happened in the meeting. + +|Number of attendees +|Required +|Metadata that gets shown in the sidebar of the meeting. Must be a number. + +|Proposals +|Optional +|Choose proposals from this space that were discussed in this meeting +|=== + +== Proposals + +If you relate a proposal to a meeting, the meeting also will be shown in the proposal. + +image:components/meetings/close/related_proposal.png[Related meeting in a proposal] \ No newline at end of file From 44344111d078e1af6b5b184d9fc9ae0df06af151 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:57 +0200 Subject: [PATCH 206/336] New translations polls.adoc (German) --- .../pages/components/meetings/polls.adoc | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 docs/de/modules/admin/pages/components/meetings/polls.adoc diff --git a/docs/de/modules/admin/pages/components/meetings/polls.adoc b/docs/de/modules/admin/pages/components/meetings/polls.adoc new file mode 100644 index 0000000000..99c7b70291 --- /dev/null +++ b/docs/de/modules/admin/pages/components/meetings/polls.adoc @@ -0,0 +1,29 @@ += Polls + +CAUTION: this feature is still in active development and can't be used in production yet. + +Through the manage polls feature is possible to define a poll that will be displayed when an online meeting is ocurring. +This is useful to see quick feedback and make a decision inside the meeting without having to leave the meeting and use +other kind of tools (like surveys or proposals). + +With this feature an administrator can define questions and also manage when these questions and its results will be shown +to participants. + +== Enable polls for a meeting + +To enable polls for a meeting: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Click on "Meetings" +. Search the meeting that you want to define polls for +. Click on the "Manage polls" button image:action_list.png[Manage polls button] +. Fill the form + +The form is pretty much the Decidim form builder, with one caveat: you can only define Single and Multiple option questions. + +image:components/meetings/polls/backend.png[Backend for meeting polls] + +image:components/meetings/polls/backend_question.png[Definining a question in meeting polls] \ No newline at end of file From 562dd8fed45d2a07a1307cb09eacfa6adf7a18b6 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:58 +0200 Subject: [PATCH 207/336] New translations registrations.adoc (German) --- .../components/meetings/registrations.adoc | 105 ++++++++++++++++++ 1 file changed, 105 insertions(+) create mode 100644 docs/de/modules/admin/pages/components/meetings/registrations.adoc diff --git a/docs/de/modules/admin/pages/components/meetings/registrations.adoc b/docs/de/modules/admin/pages/components/meetings/registrations.adoc new file mode 100644 index 0000000000..71f3b3adb2 --- /dev/null +++ b/docs/de/modules/admin/pages/components/meetings/registrations.adoc @@ -0,0 +1,105 @@ += Registrations + +Through registrations you can have capacity control of the attendance for a meeting. With this feature for instance you can +limit how many people could attend to the meeting, or you can know before the start of a meeting if you need to find a bigger +room to have the meeting. + +Enabling this feature will add a button so that participants can express their wish to go to the meeting. Depending in how +this feature is configured, then: + +. it's possible to define how many slots are available for controling the maximum capacity for this meeting +. a xref:_registration_form[custom registration form] for asking information to participants can be configured +. administrators can make xref:_invitations[invitations] to other participants or people that isn't registered in the platform +. it's possible to control attendance to the meeting through xref:_registration_code[registration codes] + +image:components/meetings/registrations/frontend_join_meeting.png[Join a meeting sidebar button] + +Once participants confirm joining a meeting they get asked if they're reprensenting a group and if they want to show publicly that they're attending. + +image:components/meetings/registrations/frontend_confirm.png[Join a meeting confirm modal] + +== Enable registrations for a meeting + +To enable registrations for a meeting: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Click on "Meetings" +. Search the meeting that you want to enable registrations for +. Click on the "Edit" button image:action_edit.png[Edit button] +. Change the "Registration type" field to "On this platform" +. Define how many slots are available in "Available slots for this meeting" +. Click on the "Update" button +. Click on the "Registrations" button image:action_registrations.png[Registrations button] +. Check the "Registrations enabled" checkbox +. Fill the form + +== Registrations settings form + +image:components/meetings/registrations/backend.png[Registrations settings in a meeting] + + +.Registrations settings form +|=== +|Field |Type |Description + +|Registrations enabled +|Required +|Check to enable the registration for this meeting. + +|Registration form enabled +|Optional +|Check if you want to enable the registration form + +|Available slots for this meeting +|Required +|How many slots are available. Leave it to 0 if you have unlimited slots available. + +|Reserved slots +|Required +|How many slots are already reserved. Leave it to 0 if you don't have reserved slots + +|Registration terms +|Required +|What terms of services participants need to accept to register or join the meeting. +|=== + +== Registration form + +This feature allows you to define a custom form like the xref:admin:components/surveys.adoc[Surveys] component to ask participants +for registration information. + +== Export all + +It's possible to export registrations in multiple formats: CSV, JSON and XLSX (Excel). + +The exported data will have these fields: + +* id: The registration id +* code: the xref:_registration_code[registration code] (if this feature is enabled) +* user/name: the name of the user +* user/email: the email of the user +* user/user_group: the group of the user if she has selected that's representing a group when registering + +== Invitations + +This feature allows you to invite attendes to a meeting. These could be already registered or non-existing participants +in the platform. + +image:components/meetings/registrations/invite_attendee.png[Invite attendee for registration in a meeting] + +== Registration code + +This feature allows you to check if the attendee is registered in the meeting. She needs to provide her code, that gets +entered in this form and it's checked against the database. + +image:components/meetings/registrations/backend_w_registration_code.png[Registration code form in a meeting] + +image:components/meetings/registrations/frontend_confirmed_w_code.png[Registration code in a meeting frontend] + +It can receive two kind of responses: + +* Registration code successfully validated. +* This registration code is invalid. \ No newline at end of file From fdda0852b540b7156b203e7d0135d85402fd020a Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 17:59:59 +0200 Subject: [PATCH 208/336] New translations pages.adoc (German) --- .../modules/admin/pages/components/pages.adoc | 85 +++++++++++++++++++ 1 file changed, 85 insertions(+) create mode 100644 docs/de/modules/admin/pages/components/pages.adoc diff --git a/docs/de/modules/admin/pages/components/pages.adoc b/docs/de/modules/admin/pages/components/pages.adoc new file mode 100644 index 0000000000..6739927552 --- /dev/null +++ b/docs/de/modules/admin/pages/components/pages.adoc @@ -0,0 +1,85 @@ += Page + +The Page component allows people to get information about a space. It's similar to the general xref:admin:pages.adoc[Pages] admin section, with +the main difference is that this component allows to define pages in a space, and the general Pages admin section allows to +define pages for all the platform (for instance, help pages, terms of services, or FAQs), that aren't associated to a space. + +From this starting point, there could be other configurations, such as: + +Some examples of where this component was used: + +* https://www.decidim.barcelona/processes/PressupostosParticipatius/f/4691/[More information page in 2020 Participatory Budgeting process in Decidim Barcelona] + +image:components/page/example01.png[More information page in 2020 Participatory Budgeting process in Decidim Barcelona - Frontend] +image:components/page/example02.png[More information page in 2020 Participatory Budgeting process in Decidim Barcelona - Backend] + +To configure the Page component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Go to components +. Click on "Add component" button +. Click on "Page" +. Fill the xref:_add_component[Add component] form + +== Add component + +image:components/page/component.png[Add component form] + + +.Add component: Page form +|=== +|Field |Type |Description + +|Name +|Required +|What is the title of this component. For instance, "More information". + +|Order position +|Optional +|Which order will it have in relation to the other pages. Having a lower number means a higher priority. +For instance, if you have two pages, "Page a" with weight "10" and "Page b" with weight "0", then "Page b" will be first when ordering. +|=== + + +.Add component: Page form - Global settings +|=== +|Field |Type |Description + +|Announcement +|Optional +|A general announcement that'll be visible on the general pages landing page. +|=== + +In the cases where the space that this component will be used has xref:admin:spaces/processes/phases.adoc[Phases], for instance, in +xref:admin:spaces/processes.adoc[Participatory Processes], then you can also define different behaviors per Step. + + +.Add component: Pages form - Step settings +|=== +|Field |Type |Description + +|Announcement +|Optional +|A general announcement that'll be visible on the general page landing page. +|=== + +== Permissions + +As this component doesn't allow to do anything, there are no permissions to set up. + +=== New page form + +image:components/page/new_page.png[New page form] + + +.New page form +|=== +|Field |Type |Description + +|Body +|Required +|What is the body for the page. +|=== \ No newline at end of file From 28ac6b50e802fa5164faec2d8d75dc83902acb71 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:01 +0200 Subject: [PATCH 209/336] New translations proposals.adoc (German) --- .../admin/pages/components/proposals.adoc | 445 ++++++++++++++++++ 1 file changed, 445 insertions(+) create mode 100644 docs/de/modules/admin/pages/components/proposals.adoc diff --git a/docs/de/modules/admin/pages/components/proposals.adoc b/docs/de/modules/admin/pages/components/proposals.adoc new file mode 100644 index 0000000000..c941722939 --- /dev/null +++ b/docs/de/modules/admin/pages/components/proposals.adoc @@ -0,0 +1,445 @@ += Proposals + +The Proposals component allows people to create, comment, endorse, and give support to proposals. + +From this starting point, there could be other configurations, such as: + +* how many proposals a participant can create +* how many supports as a maximum a participant can give to proposals +* how many supports as a minimum a participant must give to proposals so their supports are valid +* whether you want to enable that participants comment on proposals +* whether you want that proposals have images, attachments, WYSIWYG editor, geolocated address, scopes, etc. + +Some examples of where this component was used: + +* https://futureu.europa.eu/[Conference of the Future of Europe] +* https://meta.decidim.org/processes/roadmap/f/122/[Propose new functionalities for Decidim software] in https://meta.decidim.org/[Metadecidim] + +image:components/proposals/example01.png[Proposals list example in COFE] +image:components/proposals/example02.png[Proposals list example in Metadecidim] +image:components/proposals/example03.png[Proposal detail example in Metadecidim] + +To configure the Proposals component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Go to components +. Click on "Add component" button +. Click on "Proposals" +. Fill the xref:_add_component[Add component] form + +== Add component + +image:components/proposals/component.png[Add component form] + + +.Add component: Proposals form +|=== +|Field |Type |Description + +|Name +|Required +|What is the title of this component. For instance, "Proposals" + +|Order position +|Optional +|Which order will it have in relation to the other components. Having a lower number means a higher priority. +For instance, if you have two components, "Proposals" with weight "10" and "Meetings" with weight "0", then "Meetings" will be first when ordering. +|=== + + +.Add component: Proposals form - Global settings +|=== +|Field |Type |Description + +|Scopes enabled +|Optional +|Check if you want to have Scopes filtering in this component. + +|Scope +|Optional +|Which xref:admin:scopes.adoc[Scope] does this component belongs to. + +|Support limit per participant +|Optional +|Must be a number. How much supports a participant can give to proposals. + +|Minimum supports per user +|Optional +|Must be a number. How many supports does a participant needs to give to proposals so their supports are counted. If she doesn't +reach this number, her supports will not be taken in account. + +|Proposal limit per participant +|Optional +|Must be a number. How many proposals a participant can create. + +|Maximum proposal body length +|Optional +|Must be a number. How many characters a proposal body can have as maximum. + +|Proposal editing +|Required +|Choose one of these two options: "Allow editing of proposals within a specific timeframe" or "Allow editing proposals +for an infinite amount of time". In case it's within a specific timeframe, you must specify the time in "Proposals can be +edited by authors before this many minutes passes". Note that if you xref:components/proposals/answers.adoc[answer a proposal] +then it can't be edited anymore. + +|Proposals can be edited by authors before this many minutes passes +|Required if "Proposal editing" is "Allow editing of proposals within a specific timeframe" +|Must be a number. How many minutes after the creation of a proposal it can be edited by its author. + +|Threshold per proposal +|Optional +|Must be a number. How many supports a proposal needs to have to be considered as "validated". See <>. + +|Can accumulate supports beyond threshold +|Optional. Only applies if "Threshold per proposal" is configured. +|Whether the proposal can accumulate more supports than the threshold. + +|Proposal answering enabled +|Optional +|Whether administrators or valuators can answer proposals. + +|Official proposals enabled +|Optional +|Wheter administrators can create official proposals. + +|Comments enabled +|Optional +|Whether you want to have comments in the meetings. + +|Comments max length +|Optional +|What are the characters limit that participants will have when making comments. Leave 0 for the default value. + +|Geocoding enabled +|Optional +|Wheter participants can define a geocoding address for their proposals. Need to have xref:configure:geocoding[Geocoding] enabled. See <>. + +|Allow attachments +|Optional +|Check to allow participants to attach files to their proposals. + +|Allow card image +|Optional +|Check to show a card image when participants attach images to their proposals. See <>. + +|Actions permissions can be set for each proposal +|Optional +|Whether you want to be able to set permissions for every one of the proposals. Most of the time you will want to leave this option disabled. + +|Collaborative drafts enabled +|Optional +|Check to enable xref:components/proposals/collaborative_drafts.adoc[collaborative drafts] in proposals. + +|Participatory texts enabled +|Optional +|Check to enable xref:components/proposals/participatory_texts.adoc[participatory texts] in proposals. + +|Amendments enabled +|Optional +|Check to enable xref:components/proposals/amendments.adoc[amendments] in proposals. If active, configure Amendment features for each step. + +|Amendments Wizard help text +|Optional. Visible if the "Amendments enabled" option is checked. +|What's the help text visible when creating new amendments. + +|Announcement +|Optional +|A general announcement that'll be visible on the general proposals landing page. + +|New proposal body template +|Optional +|A pre-defined text that will be used when creating new proposals. Useful if you want to define a format that participants need to +follow when creating new proposals. + +|New proposal help text +|Optional +|What's the help text visible when creating new proposals. + +|Proposal wizard "Create" step help text +|Optional +|What's the help text visible when creating new proposals in the "Create" step. + +|Proposal wizard "Compare" step help text +|Optional +|What's the help text visible when creating new proposals in the "Compare" step. + +|Proposal wizard "Complete" step help text +|Optional +|What's the help text visible when creating new proposals in the "Complete" step. + +|Proposal wizard "Publish" step help text +|Optional +|What's the help text visible when creating new proposals in the "Publish" step. +|=== + +[#setting-threshold] +*Example of threshold setting* + +image::components/proposals/setting_threshold01.png[Example of threshold setting] + +image::components/proposals/setting_threshold02.png[Example of threshold setting] + +[#setting-card-image] +*Example of card image setting* + +image::components/proposals/setting_card_image.png[Example of card image setting] + +[#setting-geocoding] +*Example of geocoding setting* + +image::components/proposals/setting_geocoding.png[Example of geocoding setting] + +--- + +In the cases where the space that this component will be used has xref:admin:spaces/processes/phases.adoc[Phases], for instance, in +xref:admin:spaces/processes.adoc[Participatory Processes], then you can also define different behaviors per Step. + + +.Add component: Proposals form - Step settings +|=== +|Field |Type |Description + +|Announcement +|Optional +|A general announcement that'll be visible on the general proposal landing page. + +|Endorsements enabled +|Optional +|Check if you want that participants show public support for these proposals. + +|Endorsements blocked +|Optional +|Whether participants will be able to see the endorsments but don't make any. + +|Supports enabled +|Optional +|Whether participants will be able to support proposals in this step. + +|Supports blocked +|Optional +|Whether participants will be able to support proposals in this step. + +|Supports hidden +|Optional +|If supports are enabled, checking this will hide the number of supports. + +|Comments blocked +|Optional +|Whether you want to enable comments for this phase. + +|Proposal creation enabled +|Optional +|Whether you want to enable proposal creation by participants for this phase. See xref:_new_proposal_form[New proposal form] + +|Proposal answering enabled +|Optional +|Whether you want to enable xref:components/proposals/answers.adoc[proposal answering]. + +|Publish proposal answers immediately +|Optional +|Wheter you want that the answers of proposals are published at the same time that you're xref:components/proposals/answers.adoc[answering] them or you want to control when to publish the answers. + +|Enable costs on proposal answers +|Optional +|Wheter you want to add economical costs to proposal answers. Useful for importing to xref:components/budgets.adoc[budgets]. + +|Amendment creation enabled +|Optional. Visible if "Amendments enabled" option is checked. +|Participant can amend proposals. See xref:components/proposals/amendments.adoc[Amendments]. + +|Amendment reaction enabled +|Optional. Visible if "Amendments enabled" option is checked. +|Proposal's authors will be able to accept or reject Participant's emendations. + +|Amendment promotion enabled +|Optional. Visible if "Amendments enabled" option is checked. +|Emandation authors will be able to promote to Proposal the rejected emendation. + +|Amendments visibility +|Required. Visible if "Amendments enabled" option is checked. +|Choose one of "Amendments are visible to all" or "Amendments are visible only to their authors" + +|Announcement +|Optional +|A general announcement that'll be visible on the general proposals landing page. + +|Hashtags added to all proposals +|Optional +|Automatically add a hashtag to every proposal. See <>. + +|Hashtags suggested to participants for new proposals +|Optional +|Suggest hashtags to participants for new proposals. Participants can select more than one hashtag. See <>. +|=== + +[#setting-hashtags] +*Example of hashtags setting* + +image::components/proposals/setting_hashtag.png[Example of hashtag setting] + +== Permissions + +An administrator can choose which kind of xref:customize:authorizations.adoc[Authorizations] a participant need to have to make +certain actions in the proposals: + +* Endorse +* Support +* Create +* Withdraw +* Amend +* Comment +* Vote comment + +== Manage proposals + +image:components/proposals/manage_proposals.png[Manage proposals table] + +=== Export + +Allows exporting the proposals in different formats. + +* Proposals as CSV +* Proposals as JSON +* Proposals as Excel +* Comments as CSV +* Comments as JSON +* Comments as Excel + +=== Import + +* Import from another component +* Import from a file + +=== New proposal form + +==== Citizens proposals + +image:components/proposals/new_proposal_frontend.png[New proposal form] + +Proposals can be created by participants if the setting is "Proposal creation enabled" is checked for the active phase. + +If a participant belongs to a xref:admin:participants/groups.adoc[user group], then she'll be able to create proposals as that group also. + +This form depends a lot in which settings you've enabled in this component. It can be really short (with only a Title and +Body by default) or very long (Title, Body, Hashtags, Address, Scope, Category, Image and Attachment). + + +.New proposal form - default (by a participant) +|=== +|Field |Type |Description + +|Title +|Required +|What is the title of this proposal. For instance, "Bike lane in Main Street". Must have at least 15 characters as minimum +and 150 characters as maximum. Must start with a capital letter. + +|Body +|Optional +|What is the full description for this proposal. Must have at least 15 characters as minimum and 450 characters as maximum +by default but can be changed with the setting "Maximum proposal body length". +|=== + +To detect duplicated proposals before publishing them, the proposal creation has a wizard form with multiple steps. This also +allows participants to save proposals drafts (unpublished) in case they need to fill too many fields. + +image:components/proposals/new_proposal_frontend_compare.png[New proposal form (by a participant) - Compare] + +As an example of what the form could look depending in the settings enabled, here's a screenshot of the form for a proposal +with the following settings: "Hashtags added to all proposals", "Hashtags suggested to participants for new proposals", +"Geocoding enabled", "Allow attachments", "Allow card image" and "Scopes enabled". + +image:components/proposals/new_proposal_frontend_complete.png[New proposal form (by a participant) - Complete] + +After completing these fields the participant can see a preview of their proposal before publishing. They can also modify +the proposal before publishing it. + +image:components/proposals/new_proposal_frontend_publish.png[New proposal form (by a participant) - Publish] + +image:components/proposals/new_proposal_frontend_published.png[Published proposal made by a participant] + +==== Official proposals + +Administrators can create official proposals. There will be a filter to show only official proposals in the proposals navigation page. + +image:components/proposals/new_proposal_backend01.png[New proposal form - default (official proposals)] + + +.New proposal form - default (official proposals) +|=== +|Field |Type |Description + +|Title +|Required +|What is the title of this proposal. For instance, "Bike lane in Main Street". Must have at least 15 characters as minimum +and 150 characters as maximum. Must start with a capital letter. + +|Body +|Optional +|What is the full description of this proposal. Must have at least 15 characters as minimum and 450 characters as maximum +by default but can be changed with the setting "Maximum proposal body length". + +|This proposal comes from a meeting +|Optional +|Check if this proposal comes from a meeting. + +|Select a meeting +|Required if the "This proposal comes from a meeting" checkbox is checked +|Dropdown selector with all the meetings of this space. The author of the proposal will be the meeting. +|=== + +As an example of what the form could look like depending on the settings enabled, here's a screenshot of the form for a proposal +with the following settings: "Hashtags added to all proposals", "Hashtags suggested to participants for new proposals", +"Geocoding enabled", "Allow attachments", "Allow card image" and "Scopes enabled". + +image:components/proposals/new_proposal_backend02.png[New proposal form - with multiple settings (official proposals)] + +==== Actions + + +.Actions +|=== +|Icon |Name |Definition + +|image:action_edit.png[Edit icon] +|Edit +|Edit form for a proposal. It's the same form as "New proposal". Only visible when the proposal is an xref:_official_proposals["Official proposal"]. + +|image:action_answer.png[Answer proposal icon] +|xref:components/proposals/answers.adoc[Answer proposal] +|Allows you to answer a proposal. + +|image:action_permissions.png[Permissions icon] +|Permissions +| + +|image:action_preview.png[Preview icon] +|Preview +|To see how it's shown in the frontend to participants. +|=== + +== Origin filter + +When navigating in the proposals listing, you can filter the proposals by origin. + +image:components/proposals/origin_filter.png[Proposals origin filter] + +There are five origin options: + +* All: select all the origins +* xref:_official_proposals[Official]: proposals created by administrators +* xref:_citizens_proposals[Citizens]: proposals created by participants +* Groups: proposals created by participants that belong to a user group and choose that option when creating the proposal +* Meetings: proposals created by administrators that have checked this option when creating the proposal + +== Proposal types and mechanisms + +There are different kind of proposals mechanisms that can be enabled in proposals, such as: + +* xref:admin:components/proposals/amendments.adoc[Amendments] +* xref:admin:components/proposals/answers.adoc[Answers] +* xref:admin:components/proposals/collaborative_drafts.adoc[Kollaborative Entwürfe] +* xref:admin:components/proposals/participatory_texts.adoc[teilnehmende Texte] \ No newline at end of file From e0cd11aba17f75d17ca3ec19a5def586646d2d53 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:03 +0200 Subject: [PATCH 210/336] New translations amendments.adoc (German) --- .../components/proposals/amendments.adoc | 94 +++++++++++++++++++ 1 file changed, 94 insertions(+) create mode 100644 docs/de/modules/admin/pages/components/proposals/amendments.adoc diff --git a/docs/de/modules/admin/pages/components/proposals/amendments.adoc b/docs/de/modules/admin/pages/components/proposals/amendments.adoc new file mode 100644 index 0000000000..be89e58eb5 --- /dev/null +++ b/docs/de/modules/admin/pages/components/proposals/amendments.adoc @@ -0,0 +1,94 @@ += Amendments + +With the amendment feature, participants can propose changes to an already published proposal. + +It's useful to propose improvements or corrections, specially useful when redacting laws or normatives with xref:components/proposals/participatory_texts.adoc[Participatory Texts]. + +It has similarities with xref:components/proposals/collaborative_drafts.adoc[Collaborative Drafts], but the main difference +is that with amendments there is no need to trust the other authors intentions, as every change is reviewed and must be +approved by the author of the original proposal. + +image:components/proposals/amendments/amendment.png[Amendment of a proposal] + +To configure "Amendments" in proposals component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Go to components +. Click on "Add component" button +. Click on "Proposals" +. Check the "Amendments enabled" setting +. Review and configure the following related settings: "Amendments Wizard help text" in global component settings and "Amendment creation enabled", "Amendment reaction enabled", "Amendment promotion enabled", and "Amendments visibility" in the step component settings. +. Save the component + +== How it works + +. A participant (Alice) has created a proposal +. Another participant (Bob) has seen the proposal and wants to make some changes +image:components/proposals/amendments/proposal_to_amend.png[] +. Bob click on the "Amend proposal" button +. Bob makes the changes in the "Create amendment draft" form +image:components/proposals/amendments/create_amendment_draft.png[] +. Bob checks if there is any similar amendment +. Bob edits the amendment draft +image:components/proposals/amendments/edit_amendment_draft.png[] +. Bob publishes the amendment draft +image:components/proposals/amendments/publish_amendment_draft.png[] +. Anyone can see the amendment draft +image:components/proposals/amendments/proposal_amendmed.png[] +image:components/proposals/amendments/amendment_list.png[] +image:components/proposals/amendments/amendment_view_side_by_side.png[] +. It's also possible to filter the amended proposals +image:components/proposals/amendments/amendment_list_filter.png[] +. Alice receives a notification that Bob has proposed an amendment to her original proposal +image:components/proposals/amendments/proposal_amendmed_notification.png[] +. Alice can see the amendment proposal +image:components/proposals/amendments/proposal_amendmed_to_review.png[] +. Alice can review the amendment proposal +image:components/proposals/amendments/proposal_amendmed_review.png[] +. Alice can approve the amendment proposal +image:components/proposals/amendments/proposal_amendmed_accepted.png[] +. Anyone can see the final proposal +image:components/proposals/amendments/proposal_amendmed_final.png[] +image:components/proposals/amendments/proposal_amendmed_amendment_list.png[] +. Anyone can see the versions history of the proposal +image:components/proposals/amendments/proposal_amendmed_versions.png[] + +== Relevant component settings + + +.Proposals component form - Settings related to amendments +|=== +|Field |Type |Description + +|Amendments enabled +|Global +|Check to enable xref:components/proposals/amendments.adoc[amendments] in proposals. Other settings visible when enabling one. + +|Amendments Wizard help text +|Global +|What's the help text visible when creating new amendments. + +|Amendment creation enabled +|Step +|Participant can amend proposals. See xref:components/proposals/amendments.adoc[Amendments]. + +|Amendment reaction enabled +|Step +|Proposal's authors will be able to accept or reject Participant's emendations. + +|Amendment promotion enabled +|Step +|Emandation authors will be able to promote to Proposal the rejected emendation. + +|Amendments visibility +|Step +|Choose one of "Amendments are visible to all" or "Amendments are visible only to their authors" +|=== + +== Promotion + +If a proposal is rejected and the "Amendment promotion enabled" is enabled, then the author that have made the rejected +amendment will be able to promote to a new proposal the rejected emendation. \ No newline at end of file From 71cd9055fba8906db049906c98b22a6cfb38319f Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:04 +0200 Subject: [PATCH 211/336] New translations answers.adoc (German) --- .../pages/components/proposals/answers.adoc | 113 ++++++++++++++++++ 1 file changed, 113 insertions(+) create mode 100644 docs/de/modules/admin/pages/components/proposals/answers.adoc diff --git a/docs/de/modules/admin/pages/components/proposals/answers.adoc b/docs/de/modules/admin/pages/components/proposals/answers.adoc new file mode 100644 index 0000000000..8e1d8238b1 --- /dev/null +++ b/docs/de/modules/admin/pages/components/proposals/answers.adoc @@ -0,0 +1,113 @@ += Answers + +Proposals answers allow an administrator or valuator to review a proposal and give it an official response. + +image:components/proposals/proposal_answer_state_accepted.png[Proposal answer state: Accepted] + +For answering a proposal: + +. Sign in as admin or valuator +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Click in the "Proposals" component +. Search the proposal you want to answer +. Click in the "Proposal answer" button image:action_answer.png[Answer proposal icon] +. Fill the form + +Alternatively, you could also: + +. Sign in as admin or valuator +. Navigate to the proposal you want to answer +. Click in the proposal answer button in the header image:components/proposals/answer_button_header.png[Answer proposal button] +. Fill the form + +== Answer page + +The answer page has three sections: + +=== Metadata + +It has general information about the proposal, like the link, who is the author, the proposal body, how many supports, endorsements, comments, and so on. + +=== Private notes + +Allows an administrator or valuator to leave notes that will not be visible to the public. + +=== Answer for proposal + +Allows an administrator to answer a proposal. + +image:components/proposals/proposal_answer.png[Proposal answer form] + + +.Answer for proposal form +|=== +|Field |Type |Description + +|Internal state +|Required +|Choose one of the following: Accepted, Rejected, or Evaluating + +|Answer +|Optional +|An explanation on why the proposal was accepted, rejected, or evaluated + +|Cost +|Required if "Enable costs on proposal answers" is enabled in the proposals component settings and if it's accepted +|A number that indicates the cost of the proposal + +|Cost report +|Required if "Enable costs on proposal answers" is enabled in the proposals component settings and if it's accepted +|An explanation of the cost of the proposal + +|Execution period +|Required if "Enable costs on proposal answers" is enabled in the proposals component settings and if it's accepted +|How much time the proposal will take to be executed +|=== + +== States + +If the proposals component setting "Publish proposal answers immediately" is checked, then the response of the proposal will be visible to the public immediately. + +The state is visible on the proposal page and card. + +image:components/proposals/proposal_answer_state_accepted_card.png[Proposal card answer state: Accepted] + +=== Evaluating + +image:components/proposals/proposal_answer_state_evaluating.png[Proposal answer state: Evaluating] + +=== Accepted + +After proposals have been accepted, they can be imported to the xref:components/budgets.adoc[budgets] component. + +image:components/proposals/proposal_answer_state_accepted.png[Proposal answer state: Accepted] + +=== Rejected + +image:components/proposals/proposal_answer_state_rejected.png[Proposal answer state: Rejected] + +== Publication + +You can control when the answers will be published by using the "Publish proposal answers immediately" checkbox. + +For enabling automatic publication, you'll need to check it. + +On the other hand, if you want to control when to publish the answer a proposal or multiple proposals, you'll need to follow these steps: + +. Sign in as admin or valuator +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Click in the "Proposals" component +. Search the proposal you want to answer +. Click in the left checkbox of the proposal that you want to publish +. Click on the "Actions" button +. Click on the "Publish answers" option +image:components/proposals/proposal_answer_publish.png[Proposal answer publication: action] +. Click on "Publish" button +image:components/proposals/proposal_answer_publish_button.png[Proposal answer publication: publish button] + +NOTE: If you have unchecked the "Publish proposal answers immediately", answered the proposals and then checked the option again, the answers will not be +published automatically. You'll still need to publish the answers manually with the "Actions" button. \ No newline at end of file From b8dc8e24eae2fed3dd52318f096ef5ae28a9b9e7 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:05 +0200 Subject: [PATCH 212/336] New translations collaborative_drafts.adoc (German) --- .../proposals/collaborative_drafts.adoc | 70 +++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 docs/de/modules/admin/pages/components/proposals/collaborative_drafts.adoc diff --git a/docs/de/modules/admin/pages/components/proposals/collaborative_drafts.adoc b/docs/de/modules/admin/pages/components/proposals/collaborative_drafts.adoc new file mode 100644 index 0000000000..9c26ef25e2 --- /dev/null +++ b/docs/de/modules/admin/pages/components/proposals/collaborative_drafts.adoc @@ -0,0 +1,70 @@ += Collaborative draft + +With the collaborative draft feature participants can make a proposal with multiple authors. + +It's useful to propose improvements or corrections. + +It has similarities with xref:components/proposals/amendments.adoc[Amendments] but the main difference is that with collaborative +drafts there is a need to trust other authors, as they can make any change to the original proposal without approval by the +original author, although the original author can decide if she promotes the collaborative draft as a proposal. + +image:components/proposals/collaborative_drafts/collaborative_draft_request_access.png[Collaborative draft with request access button] + +To configure "Collaborative Drafts" in Proposals component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Go to components +. Click on "Add component" button +. Click on "Proposals" +. Check the "Collaborative drafts enabled" setting +. Save the component + +== How it works + +. A participant (Alice) wants to create a collaborative draft. For that, she goes to the proposals list page. +. Alice clicks in the "Access collaborative drafts" button +image:components/proposals/collaborative_drafts/proposals_list01.png[] +. Alice clicks in "New collaborative draft" button +image:components/proposals/collaborative_drafts/list_empty.png[] +. Alice fills the form and submits it +image:components/proposals/collaborative_drafts/create_form.png[] +. Once the collaborative draft is created, Alice can: edit, withdraw or publish the collaborative draft and approve or +reject collaboration requests +image:components/proposals/collaborative_drafts/collaborative_draft.png[] +. Another participant (Bob) has seen the collaborative draft and wants to make some changes +image:components/proposals/collaborative_drafts/collaborative_draft_request_access.png[] +. Bob clicks in the "Request access" button +image:components/proposals/collaborative_drafts/access_requested.png[] +. Alice receives the notification +image:components/proposals/collaborative_drafts/notification.png[] +. Alice goes to the collaborative draft. There she can accept or reject the collaboration request +image:components/proposals/collaborative_drafts/author_sidebar.png[] +. Alice approves the collaboration request. Once a request is approved it can't be rejected +. Now the collaborative draft has multiple authors +image:components/proposals/collaborative_drafts/multiple_authors.png[] +. Bob can edit the collaborative draft by clicking in the "Edit collaborative draft" button +image:components/proposals/collaborative_drafts/edit_collaborative_draft.png[] +image:components/proposals/collaborative_drafts/edit_form.png[] +. Once the collabrative draft is edited, then it's possible to see the old versions and its changes +image:components/proposals/collaborative_drafts/collaborative_draft_edited.png[] +image:components/proposals/collaborative_drafts/collaborative_draft_edited_versions.png[] +image:components/proposals/collaborative_drafts/collaborative_draft_edited_versions_show_v2_01.png[] +image:components/proposals/collaborative_drafts/collaborative_draft_edited_versions_show_v2_02.png[] +. Once Alice is satisfied with the collaborative draft, she can publish it by click in the "Publish" button +image:components/proposals/collaborative_drafts/publish_modal.png[] +. When it's published it becomes a proposal +image:components/proposals/collaborative_drafts/proposal.png[] +image:components/proposals/collaborative_drafts/proposals_list02.png[] +. And the collaborative draft is still visible although it can't be edited anymore +image:components/proposals/collaborative_drafts/collaborative_draft_published.png[] + +== Important aspects + +- A collaborative draft can has any number of authors. +- Only the original author can approve or reject the collaboration requests. +- Only the original author can publish the collaborative draft. +- Only the original author can withdraw the collaborative draft. +- Once a collaboration request is approved, it can't be rejected. \ No newline at end of file From c2e262b9c6a751e39fbdcada182e1de9b0fc171d Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:07 +0200 Subject: [PATCH 213/336] New translations participatory_texts.adoc (German) --- .../proposals/participatory_texts.adoc | 88 +++++++++++++++++++ 1 file changed, 88 insertions(+) create mode 100644 docs/de/modules/admin/pages/components/proposals/participatory_texts.adoc diff --git a/docs/de/modules/admin/pages/components/proposals/participatory_texts.adoc b/docs/de/modules/admin/pages/components/proposals/participatory_texts.adoc new file mode 100644 index 0000000000..c5573a6e6d --- /dev/null +++ b/docs/de/modules/admin/pages/components/proposals/participatory_texts.adoc @@ -0,0 +1,88 @@ += Participatory texts + +This feature allows you to navigate the proposals as text. It's useful for discussing normatives, plans, or other kinds of texts. + +Every paragraph is split into a proposal, so it's possible to discuss it in a more granular way. + +Some examples of where this feature was used are: + +* https://concertation.greenpeace.fr/processes/vision-greenpeace/f/8/[Vision Greenpeace] in https://concertation.greenpeace.fr/[Greenpeace France Concertation] +* https://www.decidim.barcelona/processes/PAM2020/f/3771/[Procés participatiu del Programa d'Actuació Municipal (PAM) 2020-2023] in https://www.decidim.barcelona/[Decidim Barcelona] + +image:components/proposals/participatory_texts/example01.png[Vision Greenpeace] + +image:components/proposals/participatory_texts/example02.png[PAM 2020-2023 in Decidim Barcelona] + +To configure the "Participatory texts" in proposals component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies", or "Conferences" +. Go to components +. Click on "Add component" button +. Click on "Proposals" +. Check the "Participatory texts enabled" setting +. Save the component +. Click in the "Participatory texts" button in the empty proposals component +image:components/proposals/participatory_texts/manage_proposals.png[Manage proposals] +. Click in the "Import document" button in the empty Preview participatory text panel +image:components/proposals/participatory_texts/preview_participatory_text_empty.png[Preview empty participatory text] +. Fill the xref:_add_document_form[Add document form] +image:components/proposals/participatory_texts/add_document_form.png[Add document form] +. xref:_preview_the_document[Preview the document] and make corrections +image:components/proposals/participatory_texts/preview_participatory_text.png[Preview participatory text] +. Click on publish the document +image:components/proposals/participatory_texts/imported_document_proposals.png[Imported document proposals] +. Publish the proposal component + +Notice that this feature could break existing proposals, so if there is any proposal it will not work. You'll see the +following message in the components settings: + +==== +Cannot interact with this setting if there are existing proposals. Please, create a new `Proposals component` if you want +to enable this feature or discard all imported proposals in the `Participatory Texts` menu if you want to disable it. +==== + +== Add document form + +Although it's possible to work with both Markdown (.MD) and ODT (.ODT) files, we recommend working with Markdown as it's +easier to see the formatting. + +link:{attachmentsdir}/participatory_text.md[Download the example participatory text]. + +image:components/proposals/participatory_texts/add_document_form.png[Add document form] + + +.Add document form +|=== +|Field |Type |Description + +|Title +|Required +|What's the title of the document? + +|Description +|Optional +|Description for the document + +|Document +|Required +|File. Add a document lesser than 2MB, each section until 3 levels deep will be parsed into proposals. Supported formats are: Markdown, ODT +|=== + +== Preview the document + +After the document is initially imported you have three options: + +. Discard +. Save draft +. Publish document + +== Frontend + +Once the document is imported and the proposals component published, you'll be able to navigate the document: + +image:components/proposals/participatory_texts/frontend.png[Frontend] +image:components/proposals/participatory_texts/frontend_hover.png[Frontend hover in proposal] +image:components/proposals/participatory_texts/frontend_proposal.png[Frontend proposal detail] \ No newline at end of file From 62547ae048afe2c30954b8a5afd54e45f5c5a509 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:09 +0200 Subject: [PATCH 214/336] New translations skeleton.adoc (German) --- .../admin/pages/components/skeleton.adoc | 167 ++++++++++++++++++ 1 file changed, 167 insertions(+) create mode 100644 docs/de/modules/admin/pages/components/skeleton.adoc diff --git a/docs/de/modules/admin/pages/components/skeleton.adoc b/docs/de/modules/admin/pages/components/skeleton.adoc new file mode 100644 index 0000000000..a0bbfcdb51 --- /dev/null +++ b/docs/de/modules/admin/pages/components/skeleton.adoc @@ -0,0 +1,167 @@ += Skeleton + +The Skeleton component allows people to XXX + +From this starting point, there could be other configurations, such as: + +* + +Some examples of where this component was used: + +* + +image:components/skeleton/example01.png[] +image:components/skeleton/example02.png[] +image:components/skeleton/example03.png[] +image:components/skeleton/example04.png[] + +To configure the Skeleton component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies" or "Conferences". +. Go to components +. Click on "Add component" button +. Click on "Skeleton" +. Fill the xref:_add_component[Add component] form + +== Add component + +image:components/skeleton/component.png[Add component form] + + +.Add component: Skeleton form +|=== +|Field |Type |Description + +|Name +|Required +|What is the title of this component. For instance, "Skeletons" + +|Order position +|Optional +|Which order will it have in relation to the other skeletons. Having a lower number means a higher priority. +For instance, if you have two skeletons, "Skeleton a" with weight "10" and "Skeleton b" with weight "0", then "Skeleton b" will be first when ordering. +|=== + + +.Add component: Skeleton form - Global settings +|=== +|Field |Type |Description + +|Scopes enabled +|Optional +|Check if you want to have Scopes filtering in this component. + +|Scope +|Optional +|Which xref:admin:scopes.adoc[Scope] does this component belongs to. + +|Global scope +|Optional +| + +|Comments enabled +|Optional +|Whether you want to have comments in the meetings. + +|Comments max length +|Optional +|What is the characters limit that participants will have when making comments. Leave 0 for default value. + +|Actions permissions can be set for each skeleton +|Optional +|Whether you want to be able to set permissions for every one of the skeletons. Most of the time you will want to leave this option disabled. + +|Announcement +|Optional +|A general announcement that'll be visible on the general skeletons landing page. +|=== + +In the cases where the space that this component will be used has xref:admin:spaces/processes/phases.adoc[Phases], for instance, in +xref:admin:spaces/processes.adoc[Participatory Processes], then you can also define different behaviors per Step. + + +.Add component: Skeletons form - Step settings +|=== +|Field |Type |Description + +|Comments blocked +|Optional +|Whether you want to enable comments for this phase. + +|Announcement +|Optional +|A general announcement that'll be visible on the general skeleton landing page. +|=== + +== Permissions + +An administrator can choose which kind of xref:customize:authorizations.adoc[Authorizations] a participant need to have to make +certain actions in the skeletons: + +* Create +* Endorse + +== Manage skeletons + +image:components/skeleton/manage_skeletons.png[Manage skeletons table] + +=== Export all + +Allows exporting the skeletons in different formats. + +* Skeletons as CSV +* Skeletons as JSON +* Skeletons as Excel +* Comments as CSV +* Comments as JSON +* Comments as Excel + +=== New skeleton form + +image:components/skeleton/new_skeleton.png[New skeleton form] + + +.New skeleton form +|=== +|Field |Type |Description + +|Title +|Required +|What is the title of this skeleton. For instance, "District A" + +|Order position +|Optional +|Which order will it have in relation to the other skeletons. Having a lower number means a higher priority. +For instance, if you have two skeletons, "Skeleton a" with weight "10" and "Skeleton b" with weight "0", then "Skeleton b" will be first when ordering. + +|Description +|Optional +|What is the description of this skeleton. +|=== + +==== Actions + + +.Actions +|=== +|Icon |Name |Definition + +|image:action_preview.png[Preview icon] +|Preview +|To see how it's shown in the frontend to participants. + +|image:action_list.png[Manage projects icon] +|xref:_manage_projects[Manage projects] +|Allows you to manage the projects of a skeleton. + +|image:action_edit.png[Edit icon] +|Edit +|Edit form for a skeleton. It's the same form as "New skeleton". + +|image:action_delete.png[Delete icon] +|Delete +|To delete this skeleton. Only can be done when there aren't any projects. +|=== \ No newline at end of file From 330f4077cba4556c666b2dbc0d391436e19943ce Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:10 +0200 Subject: [PATCH 215/336] New translations surveys.adoc (German) --- .../admin/pages/components/surveys.adoc | 256 ++++++++++++++++++ 1 file changed, 256 insertions(+) create mode 100644 docs/de/modules/admin/pages/components/surveys.adoc diff --git a/docs/de/modules/admin/pages/components/surveys.adoc b/docs/de/modules/admin/pages/components/surveys.adoc new file mode 100644 index 0000000000..2b4fc6689a --- /dev/null +++ b/docs/de/modules/admin/pages/components/surveys.adoc @@ -0,0 +1,256 @@ += Survey + +The Survey component allows people to answer questionnaires. This is useful when an organization wants to receive private +feedback, although it's possible to publish the answers manually as well. It allows defining a set of questions with multiple kinds of answers. + +From this starting point, there could be other configurations, such as: + +* if the answering is limited to a time period +* what answer types should have the questions, like short (one line), long (multiple lines), single or multiple options, +sorting through a list, etc. +* if there's an answer validation like how many characters as maximum should have an answer +* if there's a maximum number of options to select in multiple options questions + +Some examples of where this component was used: + +* https://consultation.quebec.ca/processes/donneesquebec/f/82/[Data Quebec: participate in its improvement! (Données Québec : participez à son amélioration!) in Québec consultations] +* https://meta.decidim.org/conferences/decidimfest2020/f/1403/?locale=en[DecidimFest2020 Assessment Survey] + +image:components/surveys/example01.png[Example of a survey] + +To configure the Survey component: + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button for the space that you want to configure the component for. +For instance, it could be "Processes", "Assemblies" or "Conferences". +. Go to components +. Click on "Add component" button +. Click on "Survey" +. Fill the xref:_add_component[Add component] form + +Once a survey is already answered by some users it's not possible to modify its questions, as that would affect the integrity +of the answers. If it's needed to modify the questions, then it's needed to create a new survey and unpublish the original one. + +== Add component + +image:components/surveys/component.png[Add component form] + + +.Add component: Survey form +|=== +|Field |Type |Description + +|Name +|Required +|What is the title of this component. For instance, "Surveys" + +|Order position +|Optional +|Which order will it have in relation to the other surveys. Having a lower number means a higher priority. +For instance, if you have two surveys, "Survey a" with weight "10" and "Survey b" with weight "0", then "Survey b" will be first when ordering. +|=== + + +.Add component: Survey form - Global settings +|=== +|Field |Type |Description + +|Scopes enabled +|Optional +|Check if you want to have Scopes filtering in this component. + +|Scope +|Optional +|Which xref:admin:scopes.adoc[Scope] does this component belongs to. + +|Answers accepted from +|Optional +|Start date when you want to receive answers. Leave blank for no specific date. Expected format: dd/mm/yyyy hh:ii + +|Answers accepted until +|End date when you want to stop receiving answers. Leave blank for no specific date. Expected format: dd/mm/yyyy hh:ii +|Announcement + +|Optional +|A general announcement that'll be visible on the general surveys landing page. +|Delete answers when publishing the survey +|=== + +In the cases where the space that this component will be used has xref:admin:spaces/processes/phases.adoc[Phases], for instance, in +xref:admin:spaces/processes.adoc[Participatory Processes], then you can also define different behaviors per Step. + + +.Add component: Surveys form - Step settings +|=== +|Field |Type |Description + +|Allow answers +|Optional +|Check if you want to receive answers in this survey. + +|Allow unregistered users to answer the survey +|Optional +|If active, no login will be required in order to answer the survey. This may lead to poor or unreliable data and it will +be more vulnerable to automated attacks. Use with caution! Mind that this option only allows an answer by browser session, +but participants can use the Private navigation option and make multiple answers with the same device. + +|Announcement +|Optional +|A general announcement that'll be visible on the general survey landing page. +|=== + +== Permissions + +An administrator can choose which kind of xref:customize:authorizations.adoc[Authorizations] a participant need to have to make +certain actions in the surveys: + +* Answer + +== New survey form + +When you create a new survey you'll need to fill the form with the following fields: + +image:components/surveys/edit_form.png[Edit survey form] + +NOTE: Do you have repetitive surveys? For instance the same feedback form for every process? You can have a survey that +gets copied and is used as a blueprint for so you don't have to manually configure the same survey everytime. Learn more +about xref:_templates[Templates]. + + +.New survey form +|=== +|Field |Type |Description + +|Title +|Required +|What is the title of this survey. For instance, "Feedback" + +|Description +|Optional +|What is the description of this survey. + +|Terms of service +|Required +|Legal conditions that the participants must agree to in order to answer the survey. +|=== + +In the bottom of this form there's a button that allows you to "Add question". + +image:components/surveys/add_question_button.png[] + +You can add multiple questions per survey, and reorder or delete them. It's possible to also add separators between questions. + +Every question has to have a statement and a type as a minimum. + +image:components/surveys/question_form.png[] + + +.Add question form +|=== +|Field |Type |Description + +|Statement +|Required +|The question itself. For instance, "What is your age category?" + +|Description +|Optional +|Explanation of the question being made. + +|Mandatory +|Optional +|Check if this question is required to respond to submit the answer. + +|Character limit +|Optional +|How many characters has as a maxim the answer to this question. Leave to 0 if no limit. Compatible with Short and Long answer question types. + +|Type +|Required +|One of the following: Short answer, Long answer, Single option, Multiple option, Sorting, Files, Matrix (Single option) +or Matrix (Multiple option). See xref:_question_types[Question types] for more information. +|=== + +Depending in the question type, it's possible to add validations to the answers, like if the question is mandatory (participants +would need to provide an answer in order to submit the form) or if the answer is limited to a certain number of characters as maximum in +short and long answers. + +image:components/surveys/question_form_limits_backend.png[] + +image:components/surveys/question_form_limits_frontend.png[] + +== Question types + +A survey can have multiple questions with different types, such as: + +- Short answer +- Long answer +- Single option +- Multiple option +- Sorting +- Files +- Matrix (Single option) +- Matrix (Multiple option) + + +.Question types (click to view image in detail) +|=== +|Type |Frontend |Backend |Description + +|Short answer +|image:components/surveys/type_short_answer_frontend.png[Short answer type - frontend,link=../_images/components/surveys/type_short_answer_frontend.png] +|image:components/surveys/type_short_answer_backend.png[Short answer type - backend,link=../_images/components/surveys/type_short_answer_backend.png] +|Compatible with "Character limit" validation + +|Long answer +|image:components/surveys/type_long_answer_frontend.png[Long answer type - frontend,link=../_images/components/surveys/type_long_answer_frontend.png] +|image:components/surveys/type_long_answer_backend.png[Long answer type - backend,link=../_images/components/surveys/type_long_answer_backend.png] +|Compatible with "Character limit" validation + +|Single option +|image:components/surveys/type_single_option_frontend.png[Single option type - frontend,link=../_images/components/surveys/type_single_option_frontend.png] +|image:components/surveys/type_single_option_backend.png[Single option type - backend,link=../_images/components/surveys/type_single_option_backend.png] +|Participants will have to choose a single option, with radio buttons. At least 2 options always. It's possible to define a "Free text" option, so participants can submit their own answer. + +|Multiple option +|image:components/surveys/type_multiple_option_frontend.png[Multiple option type - frontend,link=../_images/components/surveys/type_multiple_option_frontend.png] +|image:components/surveys/type_multiple_option_backend.png[Multiple option type - backend,link=../_images/components/surveys/type_multiple_option_backend.png] +|Participants will have to choose multiple options, with checkboxes. At least 2 options always. It's possible to add a validation, with the maximum number of choices. It's possible to define a "Free text" option, so participants can submit their own answer. + +|Sorting +|image:components/surveys/type_sorting_frontend.png[Sorting type - frontend,link=../_images/components/surveys/type_sorting_frontend.png] +|image:components/surveys/type_sorting_backend.png[Sorting type - backend,link=../_images/components/surveys/type_sorting_backend.png] +|At least 2 options always. Participants will click in order of preference to sort. + +|Files +|image:components/surveys/type_files_frontend.png[Files type - frontend,link=../_images/components/surveys/type_files_frontend.png] +|image:components/surveys/type_files_backend.png[Files type - backend,link=../_images/components/surveys/type_files_backend.png] +|Participants will be able to upload files. + +|Matrix (Single option) +|image:components/surveys/type_matrix_single_option_frontend.png[Matrix (Single option) type - frontend,link=../_images/components/surveys/type_matrix_single_option_frontend.png] +|image:components/surveys/type_matrix_single_option_backend.png[Matrix (Single option) type - backend,link=../_images/components/surveys/type_matrix_single_option_backend.png] +|Participants will have to choose between rows and columns of single options, with radio buttons. + +|Matrix (Multiple option) +|image:components/surveys/type_matrix_multiple_option_frontend.png[Matrix (Multiple option) type - frontend,link=../_images/components/surveys/type_matrix_multiple_option_frontend.png] +|image:components/surveys/type_matrix_multiple_option_backend.png[Matrix (Multiple option) type - backend,link=../_images/components/surveys/type_matrix_multiple_option_backend.png] +|Participants will have to choose between rows and columns of multiple options, with checkboxes. +|=== + +== Templates + +For the cases where administrators need to define multiple surveys that are mostly the same but used in different contexts, +it's possible to define a template. When there's one defined for a survey, then it'll ask to select the Template and create +the survey based on this one or in the other hand if there's no need to use a template, then it's possible to Skip the template +selection. + +image:components/surveys/edit_questionnaire.png[Choose template form] + +== Export answers + +It's possible to export the survey participant answers to different formats: CSV, JSON, XLSX (Excel) or PDF. + +Note that the platform doesn't handle the answers processing nor presenting results or summary to the users, that need to be +done externally. \ No newline at end of file From ecfbcdc48a3372a4c6de514aafbeb5679fd5db91 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:11 +0200 Subject: [PATCH 216/336] New translations configuration.adoc (German) --- .../de/modules/admin/pages/configuration.adoc | 53 +++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 docs/de/modules/admin/pages/configuration.adoc diff --git a/docs/de/modules/admin/pages/configuration.adoc b/docs/de/modules/admin/pages/configuration.adoc new file mode 100644 index 0000000000..eae6e6a6e3 --- /dev/null +++ b/docs/de/modules/admin/pages/configuration.adoc @@ -0,0 +1,53 @@ += Configuration + +In this page you can configure general settings from Decidim. + +image::admin_configuration.png[Decidim Admin Configuration] + +These are: + +* **Name**. Required. The name that the platform has. Visible at title, emails, etc. +* **Social**. Social handlers for different social networks. Visible at the footer in every page. This are: +** Twitter +** Facebook +** Instagram +** YouTube +** GitHub + +image::settings_configuration_social.png[Social networks configuration in Decidim] + +* **Default locale**. Required. +* **Time Zone**. Required. In which Time Zone is your organization. Used by things like calendars in Meetings. +* **Reference prefix**. Required. +* **Enable badges**. Whether you want or not that your participants have badges as a gamification mechanism, for instance for creating proposals or making comments. +* **Enable groups**. Whether you want or not that your participants have the possibility to create xref:participants/groups.adoc[User Groups]. Useful for example for associations or other collectives. +* **Enable rich text editor for participants**. Whether you want or not that your participants have the possibility to have a https://en.wikipedia.org/wiki/WYSIWYG[What You See Is What You Get (WYSIWYG) editor]. In some text areas, participants will be able to insert some HTML tags by using the rich text editor. +* **Send welcome notification**. Whether you want or not that your participants receive a notification when their first created their account. If enabled you can customize this notification. +** **Customize welcome notification**. +** **Welcome notification subject**. +** **Welcome notification body**. + +.Welcome notification +==== +Hi {\{name}}, thanks for joining {\{organization}} and welcome! + +If you want to get a quick idea of what you can do here, have a look at the Help section. +Once you have read it you will get your first badge. Here's a list of all the badges you can get as you participate in {\{organization}} + +Last but not least, join other people, share with them the experience of being engaged and participating in {\{organization}}. Make proposals, comments, debate, think about how to contribute to the common good, provide arguments to convince, listen and read to be convinced, express your ideas in a concrete and direct way, respond with patience and decision, defend your ideas and keep an open mind to collaborate and join other people's ideas. +==== + +image::settings_configuration_welcome.png[Welcome notification configuration in Decidim] + +* **Admin terms of use body**. Which message an Administrator user will see when accessing for the first time to the Administration panel. + +.Admin terms of use +==== +ADMIN TERMS OF USE + +We trust you have received the usual lecture from the local System Administrator. It usually boils down to these three things: + +* Respect the privacy of others. +* Think before you click. +* With great power comes great responsibility. +==== \ No newline at end of file From 2efacb3cfaf084ac62bb09fcf6c28e96ddc7338c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:12 +0200 Subject: [PATCH 217/336] New translations dashboard.adoc (German) --- docs/de/modules/admin/pages/dashboard.adoc | 23 ++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 docs/de/modules/admin/pages/dashboard.adoc diff --git a/docs/de/modules/admin/pages/dashboard.adoc b/docs/de/modules/admin/pages/dashboard.adoc new file mode 100644 index 0000000000..bf2fc64564 --- /dev/null +++ b/docs/de/modules/admin/pages/dashboard.adoc @@ -0,0 +1,23 @@ += Dashboard + +For your first time accessing to a Decidim plaform as Admin, you'll receive an invitation email so you can finish setting up your account with your nickname, name and password. + +Once you've finished and you're logged-in, you'll be able to access the Admin panel, starting with the Dashboard page. For this you'll need to click on your username, and click on "Admin dashboard". + +image::admin_dashboard_menu.png[Decidim Admin Dashboard in user menu] + +Here, you'll have a summary of the last activity of the platform. + +image::admin_dashboard.png[Decidim Admin Dashboard] + +You'll have three blocks: + +1. Activity: participants and admins that had logged in in last month, last week and last day. +1. Metrics: the graphics for the evolution of multiple things inside of Decidim: +* Participants +* Proposals +* Comments +* Meetings +* Accepted proposals +* Results +1. Admin log: last actions made by Administrator users in the platform. \ No newline at end of file From 1da6079a16de4b79d9fcbf70003a809898256d32 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:13 +0200 Subject: [PATCH 218/336] New translations badges.adoc (German) --- .../modules/admin/pages/features/badges.adoc | 76 +++++++++++++++++++ 1 file changed, 76 insertions(+) create mode 100644 docs/de/modules/admin/pages/features/badges.adoc diff --git a/docs/de/modules/admin/pages/features/badges.adoc b/docs/de/modules/admin/pages/features/badges.adoc new file mode 100644 index 0000000000..6cf9a138d3 --- /dev/null +++ b/docs/de/modules/admin/pages/features/badges.adoc @@ -0,0 +1,76 @@ += Badges + +Badges are recognitions to participant actions and progress in the platform. As participants start discovering, participating +and interacting in the platform, they will earn different badges. Here is the list of badges and some ways participants can earn them. + +It's a https://en.wikipedia.org/wiki/Gamification[gamification] mechanism to improve the engagement of the participants in a ludic way. + +The badges a participant has are visible in her account. There's also a general explanation page with a short description of every badge. + +image:features/badges/example01.png[Example of badges in profile] + +When a participant earns a badge she receives a notification. + +image:features/badges/notification.png[Example of badges notification] + +Badges have multiple levels, depending in the number of times she has made the action. For instance, for Proposals badge +she'll receive the first level badge when arriving at 1 follower, the second level at 15 followers, the third level at 30 followers, +the fourth level at 60 and the fifth level at 100. + + +.Badges +|=== +|Image |Title |Description |How it's earned |Levels + +|image:features/badges/accepted_proposals_badge.png[Accepted proposals badge] +|Accepted proposals +|Granted when particiapnts actively participate with new proposals and these are accepted. +|The participant needs to choose the participation space of her interest with submission for proposals enabled and try to +make proposals that can be carried out. This way they are more likely to be accepted. +|1, 5, 15, 30, 50 + +|image:features/badges/attended_meetings_badge.png[Attended meetings badge] +|Attended meetings +|Granted when participants attend several face-to-face meetings. +|The participant needs to register for the meetings she want to attend +|1, 3, 5, 10, 30 + +|image:features/badges/debates_badge.png[Debates badge] +|Debates +|Granted when participants actively participate in the different debates by leaving comments. +|The participant needs to take part in debates. +|1, 5, 10, 30, 50 + +|image:features/badges/followers_badge.png[Followers badge] +|Followers +|Granted when participant reach a certain number of followers. The platform is a social and political network, so +participants ned to weave their web to communicate with other people in the platform. +|The participant needs to be be active and follow other people. That will surely make other people follow her. +|1, 15, 30, 60, 100 + +|image:features/badges/published_initiatives_badge.png[Published initiatives badge] +|Published initiatives +|Granted when a participant launch new initiatives, partnering with others to carry them out. +|The participant needs to go to the participation space of Intiatives and follow the steps to create a new initiative. +|1, 5, 15, 30, 50 + +|image:features/badges/invitations_badge.png[invitations badge] +|Invitations +|Granted when participants invite some people and they have become participants. +|The participant needs to use the “invite friends” link on her user page to invite her friends. She can customize the +message she's sending. She’ll level up by sending invitations and getting them registered. Note that this feature is disabled +and this badge is not available, so it'll be removed in the future. +|1, 5, 10, 30, 50 + +|image:features/badges/proposal_supports_badge.png[Proposal supports badge] +|Proposal supports +|Granted when participants support other people's proposals. +|The participant needs to browse and spend some time reading other people's proposals and give support to the proposals she like or find interesting. +|5, 15, 50, 100, 500 + +|image:features/badges/proposals_badge.png[Proposals badge] +|Proposals +|Granted when participants actively participate with new proposals. +|The participant needs to choose the participation space of her interest with submission for proposals enabled and create a new proposal. +|1, 5, 10, 30, 60 +|=== \ No newline at end of file From ec0e4eb88ba2ae77b05aec01f862cea47acc4798 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:14 +0200 Subject: [PATCH 219/336] New translations comments.adoc (German) --- .../admin/pages/features/comments.adoc | 64 +++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 docs/de/modules/admin/pages/features/comments.adoc diff --git a/docs/de/modules/admin/pages/features/comments.adoc b/docs/de/modules/admin/pages/features/comments.adoc new file mode 100644 index 0000000000..43bd35408c --- /dev/null +++ b/docs/de/modules/admin/pages/features/comments.adoc @@ -0,0 +1,64 @@ += Comments + +Comments are public messages left to the rest of the community. It allows participants to share information or opinions +about a proposal, debate, meeting, initiative, etc. + +image:features/comments/example01.png[Comments example] + +== Create a comment + +. Sign in as a participant +. Go to the content that you want to leave a comment +. Go to the bottom of the page +. Fill the "Add comment" form + +Depending on the component settings, this feature can be disabled. + +image:features/comments/form.png[Comments form] + +=== Form + +It's possible to: + +. mention a participant or user group (like @admin). They'll receive a notification +. add a hashtag (like #Example). This will link to the general search +. make a quote of a comment (like > this is a quote) +. if an URL is entered, then it'll be linked automatically +image:features/comments/rich_text_write.png[Comments with rich text (write)] +image:features/comments/rich_text_read.png[Comments with rich text (read)] +image:features/comments/hashtag_search.png[Hashtags in comments] +. if HTML is added, it'll be escaped and not shown +image:features/comments/xss_write.png[XSS in comments (write)] +image:features/comments/xss_read.png[XSS in comments (read)] +. add emojis to comments +image:features/comments/emoji_selector.png[Emoji selector in comments] + +== Sort + +Comments can be sorted by "Best rated", "Recent", "Older" or "More discussed". + +image:features/comments/order_by.png[Order comments] + +== Actions + +After a comment is created, the author can "Reply", "Report", "Get link", "Edit" and "Delete". Other participants can "Reply", "Report" and "Get link". Some of these actions are visible in the three dots menu: + +image:features/comments/actions.png[Comments actions] + +=== Reply + +It's possible to reply to comments until the 4th anidation level. + +image:features/comments/anidation_levels.png[Anidation levels for comments] + +=== Delete + +Once a comment is deleted is not longer visible. + +image:features/comments/deleted_comment.png[Deleted comment] + +=== Edit + +Once a comment is edited then it's shown that was edited. It doesn't have a version history of the changes made. + +image:features/comments/edited_comment.png[Edited comment] \ No newline at end of file From 2259bc93ca0de6823f57d73f042ec8f7a994cd17 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:16 +0200 Subject: [PATCH 220/336] New translations conversations.adoc (German) --- .../admin/pages/features/conversations.adoc | 57 +++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 docs/de/modules/admin/pages/features/conversations.adoc diff --git a/docs/de/modules/admin/pages/features/conversations.adoc b/docs/de/modules/admin/pages/features/conversations.adoc new file mode 100644 index 0000000000..4165c50e1d --- /dev/null +++ b/docs/de/modules/admin/pages/features/conversations.adoc @@ -0,0 +1,57 @@ += Conversations + +With conversations, participants can have private messaging with each other. Only the participants who are in the +conversation can see each others messages. + +A conversation can be started with any participant or group registered on the platform. + +image:features/conversations/conversation.png[Example of a conversation] + +To start a conversations: + +. Sign in as participant +. Go to the participant profile that you want to start a conversation with +image:features/conversations/profile.png[Participant profile] +. Click on the contact icon image:icon_envelope.png[Envelope icon] +. Fill the form +image:features/conversations/start_a_conversation_form.png[Start a conversation form] + +Alternatively, you could also: + +. Sign in as participant +. Click on the conversation icon in the header image:icon_envelope_off.png[Conversations icon] +. Click on the "Start conversation" button +. Search the participant or group that you want to start a conversation with +. Fill the form + +If there are new messages in a conversation, then the participant will see the icon with a color image:icon_envelope_on.png[Conversation icon with color] + +image:features/conversations/conversations.png[Conversations list] + +== Multiple participants in a conversation + +It's possible to have multiple participants in a conversation. + +For this, you need to: + +. Sign in as participant +. Click on the conversation icon in the header image:icon_envelope_off.png[Conversations icon] +. Click on the "Start conversation" button +. Search the participants or groups that you want to start a conversation with +. Fill the form + +image:features/conversations/new_conversation_modal.png[New conversation modal] + +== Group converations + +Just like with participants, is possible to have converstaions with groups. + +image:features/conversations/group_conversations.png[Group conversations list] +image:features/conversations/conversations_group_counter.png[Conversations group counter] + +== Notes + +Some things to consider about conversations: + +* It's not possible to delete a conversation. +* It's not possible to edit a message in a conversation. \ No newline at end of file From 5bf14a34d0c938da4c676611bf04e6967240b6ca Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:17 +0200 Subject: [PATCH 221/336] New translations embed.adoc (German) --- .../modules/admin/pages/features/embed.adoc | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 docs/de/modules/admin/pages/features/embed.adoc diff --git a/docs/de/modules/admin/pages/features/embed.adoc b/docs/de/modules/admin/pages/features/embed.adoc new file mode 100644 index 0000000000..c35bf2bca7 --- /dev/null +++ b/docs/de/modules/admin/pages/features/embed.adoc @@ -0,0 +1,23 @@ += Embed + +Sometimes you want to embed some content to an external page. For this you can use the `Embed` feature. + +image:features/embed/example.png[A proposal card embeded in another page] + +== How to embed + +. Navigate to the content you want to embed. +. Click on the `Embed` link in the sidebar. image:features/embed/link.png[] +image:features/embed/sidebar.png[] +. Copy the code from the modal. +image:features/embed/modal.png[] +. Paste that code in the external page where you want to embed it. The CMS or platform that you're using needs to supports +changing HTML code. + +An example of this code is: + +[source,html] +---- + + +---- \ No newline at end of file From 70abd5dd232d34739cb5b48019f2c4015b55eea2 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:18 +0200 Subject: [PATCH 222/336] New translations endorsements.adoc (German) --- .../admin/pages/features/endorsements.adoc | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 docs/de/modules/admin/pages/features/endorsements.adoc diff --git a/docs/de/modules/admin/pages/features/endorsements.adoc b/docs/de/modules/admin/pages/features/endorsements.adoc new file mode 100644 index 0000000000..b407e0ca97 --- /dev/null +++ b/docs/de/modules/admin/pages/features/endorsements.adoc @@ -0,0 +1,17 @@ += Endorsements + +Through endorsements, participants can publicly show that they want to support a particular content, for instance, a proposal. + +image:features/endorsements/list.png[List of endorsements] + +This is done through the button in the sidebar. Administrators can enable or disable them by step in a given participatory process, and they can also define permissions with authorizations. + +image:features/endorsements/sidebar.png[Endorsement button in sidebar] + +When a participant belongs to a verified group she can also endorse like that group by selecting the identity. + +image:features/endorsements/modal.png[Select identity modal] + +By default the endorsements list is collapsed. To see it fully visitors need too click in the "(see more)" link. + +image:features/endorsements/full_list.png[Full list of endorsements] \ No newline at end of file From 68236542cde64dc80ffba6ed7c791aa837ddda18 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:19 +0200 Subject: [PATCH 223/336] New translations fingerprint.adoc (German) --- .../admin/pages/features/fingerprint.adoc | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 docs/de/modules/admin/pages/features/fingerprint.adoc diff --git a/docs/de/modules/admin/pages/features/fingerprint.adoc b/docs/de/modules/admin/pages/features/fingerprint.adoc new file mode 100644 index 0000000000..0a4c43d309 --- /dev/null +++ b/docs/de/modules/admin/pages/features/fingerprint.adoc @@ -0,0 +1,29 @@ += Fingerprint + +Although the platform should show the xref:admin:features/versions.adoc[Versions] for almost all of the contents, it'd be +still possible to manipulate the content by directly editing the database. + +As mitigation for this risk, the platform shows a fingerprint for some important fields, for instance, a proposal body and title. + +image:features/fingerprint/modal.png[Check fingerprint modal] + +Its goal is to provide a way to give an informal "receipt" to a participant to they can detect tampering. A fingerprint is +a hashed representation of the content. It's useful to ensure the content hasn't been tampered with, as a single modification +would result in a totally different value. It's calculated using a SHA256 hashing algorithm. In order to replicate it +yourself, you can use a http://www.md5calc.com/sha256[MD5 calculator online] and copy-paste the source data. + +== Check fingerprint + +. Go to the content that you want to check the fingerprint +. Click in the "Check fingerprint" link in the sidebar +image:features/fingerprint/sidebar.png[Check fingerprint link in sidebar] +. Follow the modal instructions + +image:features/fingerprint/md5calc.png[MD5calc.com screenshot] + +It's possible to check the fingerprint with other tools, such as the sha256sum command line tool. + +[source,bash] +---- +echo -n '{"body":{"en":"

**Is your feature request related to a problem? Please describe.**

It would be useful to set a character limit on questionnaire answers to provide guidance for users regarding how long their answers should be.


**Describe the solution you\'d like**

To have a number input field next to each question in the admin, labeled \\"Character limit\\", by default set to zero (no limit), which determines the maximum characters the user answers to those questions can have.


**Describe alternatives you\'ve considered**

Another possibility could be to define this globally for the questionnaire, setting the character limit for each type of question.


**Additional context**

-


**Could this issue impact on users private data?**

No


**Funded by**

Fundació Bosch i Guimpera

"},"title":{"en":"Maximum characters for questionnaire text answers"}}' | sha256sum +---- \ No newline at end of file From f6bf9b540a58817fb2058ab919be37a1ca6772b5 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:20 +0200 Subject: [PATCH 224/336] New translations follows.adoc (German) --- .../modules/admin/pages/features/follows.adoc | 27 +++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 docs/de/modules/admin/pages/features/follows.adoc diff --git a/docs/de/modules/admin/pages/features/follows.adoc b/docs/de/modules/admin/pages/features/follows.adoc new file mode 100644 index 0000000000..405b49e053 --- /dev/null +++ b/docs/de/modules/admin/pages/features/follows.adoc @@ -0,0 +1,27 @@ += Follows + +Most of the contents in Decidim allows to be followed. This means that you'll receive xref:features/notifications.adoc[notifications] +of the activity being made by the thing you're following. + +You can control these notifications in the xref:features/my_account/notifications_settings.adoc[settings of your account]. + +The activity of the things that you're following is visible in your profile timeline. + +For following a thing: + +. Navigate to whatever you want to follow. +. Click in the "Follow" button. +image:button_follow.png[Follow button] +. You'll see the "Follow" button disappear and the "Stop following" button appear. + +To unfollow a thing: + +. Navigate to whatever you want to unfollow. +. Click in the "Stop following" button. +image:button_stop_following.png[Stop following button] +. You'll see the "Stop following" button disappear and the "Follow" button appear. + +Administrators by default follow all the new spaces that are created in the Decidim platform. + +A participant can also follow another participants. This is public and it's visible in the profile sections +follows and followers. \ No newline at end of file From e7d5e635896664af6c18890d3ee93a0710606bb8 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:22 +0200 Subject: [PATCH 225/336] New translations metrics.adoc (German) --- docs/de/modules/admin/pages/features/metrics.adoc | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 docs/de/modules/admin/pages/features/metrics.adoc diff --git a/docs/de/modules/admin/pages/features/metrics.adoc b/docs/de/modules/admin/pages/features/metrics.adoc new file mode 100644 index 0000000000..0e98422d88 --- /dev/null +++ b/docs/de/modules/admin/pages/features/metrics.adoc @@ -0,0 +1,15 @@ += Metrics + +NOTE: Looking for how to enable this feature technically? Go to xref:develop:metrics.adoc[Metrics in Developers guide] + +With Metrics participants can see the evolution in time of some resources, such as Proposals, Supports, Endorsements, Followers, Participants, Accepted propsoals, Comments, etc. You can see a real world example of this in https://meta.decidim.org/processes/roadmap/all-metrics[Metadecidim Roadmap process]. + +For this to work it needs to be first xref:develop:metrics.adoc[configured technically] and also enabled by the setting in the participatory space (`Show metrics` checkbox). + +Then this section will be visible in the space landing page. + +image:features/metrics/example.png[Example of metrics] + +By clicking in "Show all metrics", visitors can see other metrics and download this data in CSV format. + +image:features/metrics/page.png[Metrics page] \ No newline at end of file From e47544c62f9200412fe3e0adc7bda21f0a9f72ce Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:23 +0200 Subject: [PATCH 226/336] New translations my_account.adoc (German) --- .../admin/pages/features/my_account.adoc | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 docs/de/modules/admin/pages/features/my_account.adoc diff --git a/docs/de/modules/admin/pages/features/my_account.adoc b/docs/de/modules/admin/pages/features/my_account.adoc new file mode 100644 index 0000000000..930fd37088 --- /dev/null +++ b/docs/de/modules/admin/pages/features/my_account.adoc @@ -0,0 +1,19 @@ += My account + +My account is all the pages where a participant can change her personal data that is displayed in My public profile page, change her notifications settings, see which groups she belongs, etc. + +To go to this section: + +. Sign in as a participant +. Click in the name of the participant in the header +. Click in "My account" + +The actions that she can do are: + +* xref:admin:features/my_account/account.adoc[Account] +* xref:admin:features/my_account/notifications_settings.adoc[Benachrichtigungseinstellungen] +* xref:admin:features/my_account/authorizations.adoc[Authorizations] +* xref:admin:features/my_account/groups.adoc[Groups] +* xref:admin:features/my_account/my_interests.adoc[Meine Interessen] +* xref:admin:features/my_account/my_data.adoc[Meine Daten] +* xref:admin:features/my_account/delete_my_account.adoc[Mein Konto löschen] \ No newline at end of file From 23da65e52616564bbe08603b15432046accce675 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:24 +0200 Subject: [PATCH 227/336] New translations account.adoc (German) --- .../pages/features/my_account/account.adoc | 47 +++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 docs/de/modules/admin/pages/features/my_account/account.adoc diff --git a/docs/de/modules/admin/pages/features/my_account/account.adoc b/docs/de/modules/admin/pages/features/my_account/account.adoc new file mode 100644 index 0000000000..f1352a9738 --- /dev/null +++ b/docs/de/modules/admin/pages/features/my_account/account.adoc @@ -0,0 +1,47 @@ += Account + +In this section is possible to make modifications that will be visible in the participants public profile and also modify the email address or the language that the platform will use with the user. + +. Sign in as a participant +. Click in the name of the participant in the header +. Click in "My account" + +image:features/my_account/account.png[My account form] + + +.Participant settings - My account form +|=== +|Field |Type |Description + +|Avatar +|Optional +|Avatar or picture for the participant. Guidance for image: Preferrably a landscape image that does not have any text. +The service crops the image. Maximum file size: 5MB + +|Your name +|Required +|The name of the participant. + +|Nickname +|Required +|The nickname of the participant. + +|Your email +|Required +|The email of the participant, where she'll receive notifications, password recovery, etc. If it's changed it needs to be +confirmed. + +|Personal URL +|Optional +|Metadata that is displayed in the participant's profile. + +|About +|Optional +|Metadata that is displayed in the participant's profile. + +|Locale +|Required +|Choose the language you want to use to browse and receive notifications in Decidim +|=== + +From this page is possible to also modify the participant's password. \ No newline at end of file From f84307ecedc0cdebc43e9b7569b6e1cf1de3e70c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:26 +0200 Subject: [PATCH 228/336] New translations authorizations.adoc (German) --- .../features/my_account/authorizations.adoc | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 docs/de/modules/admin/pages/features/my_account/authorizations.adoc diff --git a/docs/de/modules/admin/pages/features/my_account/authorizations.adoc b/docs/de/modules/admin/pages/features/my_account/authorizations.adoc new file mode 100644 index 0000000000..3838e35959 --- /dev/null +++ b/docs/de/modules/admin/pages/features/my_account/authorizations.adoc @@ -0,0 +1,23 @@ += Authorizations + +In this section participants will be able to review their Authorizations and see some metadata, like when it was granted +or the status of the authorization. + +It depends on how it's configured for the organization, as depending in the context (like normative or laws) it could work +in different ways. For more information about Authorizations see xref:admin:participants/authorizations.adoc[authorizations +in admin manual] and xref:customize:authorizations.adoc[authorizations in customize guide]. + +image:features/my_account/authorizations.png[Authorizations] + +To go to this section: + +. Sign in as a participant +. Click in the name of the participant in the header +. Click in "My account" +. Click in "Authorizations" in the sidebar + +For any given authorization, you can see the following information: + +* If it's not finished, when the authorization process started +* If it has finished and has been granted, the date when it was granted +* If the authorization provides it, some metadata, such as the scope of the authorization \ No newline at end of file From 667d9ceddade454a6e896bba990518af4fa9a66f Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:27 +0200 Subject: [PATCH 229/336] New translations delete_my_account.adoc (German) --- .../my_account/delete_my_account.adoc | 21 +++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 docs/de/modules/admin/pages/features/my_account/delete_my_account.adoc diff --git a/docs/de/modules/admin/pages/features/my_account/delete_my_account.adoc b/docs/de/modules/admin/pages/features/my_account/delete_my_account.adoc new file mode 100644 index 0000000000..8ba403a53e --- /dev/null +++ b/docs/de/modules/admin/pages/features/my_account/delete_my_account.adoc @@ -0,0 +1,21 @@ += Delete my account + +In this section participants will be able to delete their own accounts. This means that they will be unable to access the system anymore. This action is irreversible. All the contributions will be anonymized. + +image:features/my_account/delete_my_account.png[Delete my account form] + +To delete the account: + +. Sign in as a participant +. Click in the name of the participant in the header +. Click in "My account" +. Click in "Delete my account" in the sidebar +. Optionally, she can provide a reason for the deletion +. Click in "Delete my account" +. Click in "Yes, I want to delete my account" + +image:features/my_account/delete_my_account_confirm.png[Confirm account deletion] + +After the account has been deleted, the contributions (such as comments, proposals, etc), will be still visible but all the authorship information will be anonymized, belonging to an special kind of author called "Participant deleted": + +image:features/my_account/delete_my_account_deleted.png[Deleted participant contribution] \ No newline at end of file From 2ff4e14314995ced4a4490ee437a5ab2d2e3bee2 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:28 +0200 Subject: [PATCH 230/336] New translations groups.adoc (German) --- .../pages/features/my_account/groups.adoc | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 docs/de/modules/admin/pages/features/my_account/groups.adoc diff --git a/docs/de/modules/admin/pages/features/my_account/groups.adoc b/docs/de/modules/admin/pages/features/my_account/groups.adoc new file mode 100644 index 0000000000..cad6c2d784 --- /dev/null +++ b/docs/de/modules/admin/pages/features/my_account/groups.adoc @@ -0,0 +1,18 @@ += Groups + +In this section participants can see which Groups they belong to. + +NOTE: Want to create a new group? Go to the My public profile page. + +image:features/my_account/groups.png[Groups] + +To go to this section: + +. Sign in as a participant +. Click in the name of the participant in the header +. Click in "My account" +. Click in "Groups" in the sidebar + +Here you can see in which date the group was created and which status does it have (`pending` or `verified`). + +Read more about xref:admin:participants/groups.adoc[Groups in admin manual]. \ No newline at end of file From 1663315541b677f6aa4a92af85e38c7f675b09e9 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:29 +0200 Subject: [PATCH 231/336] New translations my_data.adoc (German) --- .../pages/features/my_account/my_data.adoc | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 docs/de/modules/admin/pages/features/my_account/my_data.adoc diff --git a/docs/de/modules/admin/pages/features/my_account/my_data.adoc b/docs/de/modules/admin/pages/features/my_account/my_data.adoc new file mode 100644 index 0000000000..657fe4af9b --- /dev/null +++ b/docs/de/modules/admin/pages/features/my_account/my_data.adoc @@ -0,0 +1,29 @@ += My data + +In this section participants can request a file with all the data that they've provided to the platform. + +image:features/my_account/my_data.png[My data] + +To request the data: + +. Sign in as a participant +. Click in the name of the participant in the header +. Click in "My account" +. Click in "My data" in the sidebar +. Click in "Request data" +. Wait a couple of minutes so the files are generated. It could depend in how many proposals, comments, etc you've made +. Go to your email account and find the received email +. Click in "Download" +. Open it with a support zip software +. Enter the password that you've received in the email +. Unzip or extract the contents + +image:features/my_account/my_data_email.png[My data] + +== Zip applications + +For opening the zip file, the software that you use need to support encryption with the AES-256 algorithm. Depending on your operating system you have multiple alternatives. + +* Windows: https://www.7-zip.org/[7-Zip] +* Mac: https://www.keka.io[Keka] +* GNU/Linux: File Roller (available through your package manager) or https://peazip.github.io/[PeaZip] \ No newline at end of file From 86e8acaaef2edc53e3feaa946da2f285feb6091a Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:30 +0200 Subject: [PATCH 232/336] New translations my_interests.adoc (German) --- .../pages/features/my_account/my_interests.adoc | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 docs/de/modules/admin/pages/features/my_account/my_interests.adoc diff --git a/docs/de/modules/admin/pages/features/my_account/my_interests.adoc b/docs/de/modules/admin/pages/features/my_account/my_interests.adoc new file mode 100644 index 0000000000..df77a4d79b --- /dev/null +++ b/docs/de/modules/admin/pages/features/my_account/my_interests.adoc @@ -0,0 +1,15 @@ += My interests + +In this section participants can choose which interests they have to receive more information about. + +By default what they see here is a list of all the xref:admin:scopes.adoc[Scopes] of the organization. Those selections +can be used by administrators when segmenting for the xref:admin:newsletters.adoc[Newsletters]. + +image:features/my_account/my_interests.png[My interests] + +To go to this section: + +. Sign in as a participant +. Click in the name of the participant in the header +. Click in "My account" +. Click in "My interests" in the sidebar \ No newline at end of file From be81ee632ac975f0e723917b32ef651b87062865 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:31 +0200 Subject: [PATCH 233/336] New translations notifications_settings.adoc (German) --- .../my_account/notifications_settings.adoc | 26 +++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 docs/de/modules/admin/pages/features/my_account/notifications_settings.adoc diff --git a/docs/de/modules/admin/pages/features/my_account/notifications_settings.adoc b/docs/de/modules/admin/pages/features/my_account/notifications_settings.adoc new file mode 100644 index 0000000000..ff949d0ad4 --- /dev/null +++ b/docs/de/modules/admin/pages/features/my_account/notifications_settings.adoc @@ -0,0 +1,26 @@ += Notifications + +In this section participants can choose which kind of notifications they'll receive. For instance, depending in the activity of the installation and spaces, most people would want to disable the "Everything I follow" + +image:features/my_account/notifications_settings.png[Notifications settings] + +To go to this section: + +. Sign in as a participant +. Click in the name of the participant in the header +. Click in "My account" +. Click in "Notifications settings" in the sidebar + +The options available are: + +* I want to get notifications about +** My own activity, like when someone comments in my proposal or mentions me +** Everything I follow +* Send notifications by email +** I want to receive an email every time I receive a notification +* Newsletters +** I want to receive newsletters +* Receive direct messages from anyone +** Allow anyone to send me a direct message, even if I don't follow them +* Administrators +** I want to receive an email every time something is reported for moderation \ No newline at end of file From baf1639ba7d9e9804594ab9a63ec52c87868160d Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:33 +0200 Subject: [PATCH 234/336] New translations notifications.adoc (German) --- .../admin/pages/features/notifications.adoc | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 docs/de/modules/admin/pages/features/notifications.adoc diff --git a/docs/de/modules/admin/pages/features/notifications.adoc b/docs/de/modules/admin/pages/features/notifications.adoc new file mode 100644 index 0000000000..18006f9c47 --- /dev/null +++ b/docs/de/modules/admin/pages/features/notifications.adoc @@ -0,0 +1,16 @@ += Notifications + +Most of the actions in the platform generate notifications so particpants can know when there are new things to watch. + +This is accessible from the `Notifications` menu item (image:icon_bell.png[Notification icon]) in the header, after a participant has logged in. + +To see the notifications: + +. Sign in as participant +. Click in the notifications icon in the header + +If there are notifications, then the participant will see the icon with a color image:icon_bell_on.png[Notification icon with color] + +image:features/notifications/notifications.png[Example of notifications page when there are notifications] + +image:features/notifications/no_notifications_yet.png[Example of notifications page when there aren't notifications] \ No newline at end of file From d260f2fed527338e3a37a71069362743c5425299 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:34 +0200 Subject: [PATCH 235/336] New translations versions.adoc (German) --- .../admin/pages/features/versions.adoc | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 docs/de/modules/admin/pages/features/versions.adoc diff --git a/docs/de/modules/admin/pages/features/versions.adoc b/docs/de/modules/admin/pages/features/versions.adoc new file mode 100644 index 0000000000..63b7ca2f13 --- /dev/null +++ b/docs/de/modules/admin/pages/features/versions.adoc @@ -0,0 +1,24 @@ += Versions + +The versions feature allows a visitor to see the evolution of the different versions of resources that can be edited, +like proposals or results. + +With versions it's possible to see who made the change, when the change has been made and exactly what has changed. + +image:features/versions/side_by_side_escaped.png[Versions in resources] + +== See the versions + +. Go to the content that you want to see the version of. +. Click in the "see other versions" link in the sidebar +image:features/versions/sidebar.png[See other versions link in sidebar] +. Click in the past version that you want to see +image:features/versions/list.png[List of versions] +. From there you can change the visualiation of the version differences +image:features/versions/unified_unescaped.png[Unified unescaped view] + +It's possible to view the diffs of the versions in in two formats: side by side or unified. In case that the contents are +in HTML then it's also possible to see the diff unescaped and escaped, and see the full HTML code. + +image:features/versions/side_by_side_unescaped.png[Side by side unescaped view] +image:features/versions/unified_escaped.png[Unified escaped view] \ No newline at end of file From f5b79cf6a5ea9b216dd00d0e6f6ea5b1b7bb860c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:35 +0200 Subject: [PATCH 236/336] New translations global_moderations.adoc (German) --- .../admin/pages/global_moderations.adoc | 121 ++++++++++++++++++ 1 file changed, 121 insertions(+) create mode 100644 docs/de/modules/admin/pages/global_moderations.adoc diff --git a/docs/de/modules/admin/pages/global_moderations.adoc b/docs/de/modules/admin/pages/global_moderations.adoc new file mode 100644 index 0000000000..bb3d553310 --- /dev/null +++ b/docs/de/modules/admin/pages/global_moderations.adoc @@ -0,0 +1,121 @@ += Global moderations + +The *Global moderations* function allows you to moderate different kind of contents and +ensure that the dialog in your platform is democratic and constructive. Making +use of this function, administrators, collaborators and moderators of a space can +hide the contents/contributions that have been reported, where the complaint is +deemed appropriate, or delete the complaint. + +NOTE: Looking for how to report users? See xref:participants/reported_users.adoc[Reported users]. + +For instance, in the case of https://www.decidim.barcelona/[Decidim Barcelona], +the https://www.decidim.barcelona/pages/terms-and-conditions[Terms of Service] says: + +> It is not allowed to add any illegal or unauthorized content to the site, such +> as information with the following features: +> +> * be it false or misleading; +> * to infringe any law of the City Council or any third party, such as copyright, +> trademarks or other intellectual and industrial property rights or related rights; +> * attacking the privacy of a third party, such as publishing personal details +> of participants, such as name, address, phone number, email, photos or any other +> personal information; +> * containing viruses, Trojans, robots or other programs that may harm the website +> or the City Hall systems, or the website or system of any third party, or which +> intend to circumvent the technical measures designed for the proper functioning +> of the platform; +> * to send spam to users or overload the system; +> * which has the character of message chain, pyramidal game or random game; +> * for commercial purposes, such as publishing job offers or ads; +> * that it is not in keeping with public decency; consequently, content must not +> incite hatred, discriminate, threaten, provoke, have no sexual, violent, coarse or +> offensive meaning or character; +> * to infringe the law or applicable regulation; +> * to campaign by promoting mass voting for other proposals not related to the +> process and the framework for discussion, and +> * to create multiple users by pretending to be different people (astroturfing). + +Anyone can propose a moderation in Decidim, through the "Flag" icon in the participant +profile. After a participant has clicked in this action then she needs to provide a +reason why she's making this report: + +* Contains clickbait, advertising, scams or script bots. +* Contains racism, sexism, slurs, personal attacks, death threats, suicide requests or any form of hate speech. +* Contains illegal activity, suicide threats, personal information, or something else you think doesn't belong on [This organization]. + +Participants can also add extra information regarding their report. + +image:moderation_modal.png[Give reason for moderation modal] + +After a participant has reported a content, it'll be shown in two sections of the +administration panel: + +* Global moderations panel +* Participatory space moderation panel + +To go to the Global moderations panel, you need to: + +. Sign in as administrator +. Go to administration panel +. Click in Global moderations in the sidebar + +There you'll find first all the unprocessed reports if there's any: + +image:global_moderations_list_unhidden.png[Show all the moderated content list] + +It's also possible to filter by the type of content that was moderated and the +state of the reported content (if it was hidden or not). + +* *Id*: unique identificator of the reported content. +* *Type*: which kind of content it was reported, for instance a *Proposal* or a *Comment*. +* *Participatory Space*: which space this content belongs to. +* *Count*: Number of times it has been reported by different users. +* *Reported content URL*: link for seeing the content reported and see the context of the complaint. +* *Reports*: why it has been reported. If the participant that made the report has given extra +information it's possible to see it by hovering it. +* *Creation date*: when it was originally reported. +* *Actions*: you can *Expand*, *Unreport* or *Hide*. + +== Actions (when the report wasn't accepted yet) + +|=== +|Icon |Name |Definition + +|image:action_expand.png[Expand icon] +|Expand +|To see the full metadata of the reported content. + +|image:action_hide.png[Hide icon] +|Hide +|Allows an admin or moderator to hide this content (accepting the report). + +|image:action_unreport.png[Unreport icon] +|Unreport +|Allows an admin or moderator to keep showing this content (rejecting the report). +|=== + +== Actions (after the content is hidden) + +|=== +|Icon |Name |Definition + +|image:action_expand.png[Expand icon] +|Expand +|To see the full metadata of the reported content. + +|image:action_unhide.png[Unhide icon] +|Unhide +|Allows an admin or moderator to unhide this content (showing it publicly again). +|=== + +If the report was "Unreported" and it was a mistake, meaning that for instance the +content was spam but it was a mistake not accepting the report, then you'll need +to find that again in the public view and report it yourself so you can moderate it. + +== Expand + +To see all the metadata of a report, you can see it Expanded. + +image:global_moderations_report01.png[Expanded moderation 01] + +image:global_moderations_report02.png[Expanded moderation 02] \ No newline at end of file From 9c102fa7b169fe4ac4360b7eeb7ba65918385dc7 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:36 +0200 Subject: [PATCH 237/336] New translations help_sections.adoc (German) --- .../de/modules/admin/pages/help_sections.adoc | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 docs/de/modules/admin/pages/help_sections.adoc diff --git a/docs/de/modules/admin/pages/help_sections.adoc b/docs/de/modules/admin/pages/help_sections.adoc new file mode 100644 index 0000000000..7e942f55d7 --- /dev/null +++ b/docs/de/modules/admin/pages/help_sections.adoc @@ -0,0 +1,23 @@ += Help sections + +The first time a visitor goes to any Space page she'll see an information box about what's this Space about. + +This is how the information box is shown to participants and visitors: + +image:help_sections_frontend.png[Help sections: frontend] + +They can hide this box by clicking in the close button [X]. This gets remembered by the application. They can open this box again by clicking in [Help: ?]. + +image:help_sections_frontend_hide.png[Help sections: hide] + +As this is something that depends on your given installation, an administrator can customize these *Help sections*, adapting them to your needs. + +image:help_sections_backend.png[Help sections: backend] + +== Disable + +You can disable these information boxes by leaving the contents all empty for every language: + +image:help_sections_disable_backend.png[Disable help section in admin] + +image:help_sections_disable_frontend.png[Disabled help section] \ No newline at end of file From 6a40a8728921e54785df37e59e209d3f7507f124 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:38 +0200 Subject: [PATCH 238/336] New translations homepage.adoc (German) --- docs/de/modules/admin/pages/homepage.adoc | 101 ++++++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 docs/de/modules/admin/pages/homepage.adoc diff --git a/docs/de/modules/admin/pages/homepage.adoc b/docs/de/modules/admin/pages/homepage.adoc new file mode 100644 index 0000000000..b5811167d9 --- /dev/null +++ b/docs/de/modules/admin/pages/homepage.adoc @@ -0,0 +1,101 @@ += Homepage + +include::partial$under-construction.adoc[] + +You can control how it's the Homepage of your organization. To do so you have the Settings -> Homepage section through the Administration panel: + +image::admin_homepage.png[Decidim Admin Homepage] + +--- + +== How this works + +This means that every section in the Homepage is called **content block**. + +For instance, this is the *How to participate* content block: + +image::homepage_how_to_participate.png[How to participate example] + +For managing these contents you need to Drag and Drop the contents between the two columns, on the left are the Active and in the Right are the Inactive content blocks. + +As an example, here you can see how your page will look with only the *Hero image* content block: + +// TODO: add screenshot + +At the admin this is handled with: + +// TODO: add screenshot + +In your installation you could have other content blocks, as this depends on which modules you have active. Please contact your system administrator if you see something different here, like a missing content block. + +== Content blocks + +These are the different content blocks enabled with the official Decidim modules: + +=== Hero image + +image::homepage_hero_image_back.png[Hero image in Homepage backend content block] + +image::homepage_hero_image_front.png[Hero image in Homepage frontend content block] + +=== Sub hero banner + +Displays the description text of the instance. See xref:admin:appearance.adoc[Appearance]. + +image::homepage_sub_hero_banner.png[Sub hero banner in Homepage content block] + +=== Footer sub hero banner + +// TODO: I think this should be changed with an HTML text and probably removed + +image::homepage_footer_sub_hero_banner.png[Hero image in Homepage content block] + +=== How to participate + +// TODO: I think this should be changed with an HTML text and probably removed + +image::homepage_how_to_participate.png[How to participate in Homepage content block] + +=== Upcoming meetings + +image::homepage_upcoming_meetings.png[Upcoming meetings in Homepage content block] + +=== Last activity + +image::homepage_last_activity.png[Last activity in Homepage content block] + +=== HTML block + +image::homepage_html_block.png[HTML block in Homepage content block] + +=== Highlighted processes + +image::homepage_highlighted_processes.png[Highlighted processes in Homepage content block] + +=== Highlighted assemblies + +image::homepage_highlighted_assemblies.png[Highlighted assemblies in Homepage content block] + +=== Highlighted initiatives + +image::homepage_highlighted_initiatives.png[Highlighted initiatives in Homepage content block] + +=== Highlighted consultations + +image::homepage_highlighted_consultations.png[Highlighted consultations in Homepage content block] + +=== Highlighted conferences + +image::homepage_highlighted_conferences.png[Highlighted conferences in Homepage content block] + +=== Highlighted content banner + +image::homepage_highlighted_content_banner.png[Highlighted content banner in Homepage content block] + +=== Organization statistics + +image::homepage_organization_statistics.png[Organizations statistics in Homepage content block] + +=== Organization metrics + +image::homepage_organization_metrics.png[Organzation metrics in Homepage content block] \ No newline at end of file From fbf1a8a127f047e6188303ddd4fad685351c0184 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:39 +0200 Subject: [PATCH 239/336] New translations index.adoc (German) --- docs/de/modules/admin/pages/index.adoc | 27 ++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 docs/de/modules/admin/pages/index.adoc diff --git a/docs/de/modules/admin/pages/index.adoc b/docs/de/modules/admin/pages/index.adoc new file mode 100644 index 0000000000..4c3b2a0763 --- /dev/null +++ b/docs/de/modules/admin/pages/index.adoc @@ -0,0 +1,27 @@ += Introduction + +Deploying Decidim means taking account of all the activities that play a part in the configuration of the platform and the deployment of the participatory processes. Acquiring knowledge in administering Decidim enables control over fundamental matters such as: + +* configuring a participatory process +* activating a consultation and receiving votes +* moderating the platform +* managing associated legal texts (as the privacy policy) +* managing authorization from the administrators +* monitoring and verifying organizations + +None of these aspects are strictly technical but they do involve a series of political decisions over how we want Decidim to be, what messages and contents it has to contain, what the moderation policy for comments and debates has to be and, above all, how a specific participatory platform has to be, and what functions it has to have active. This is why it is essential to understand the socio-technical implications of the Decidim platform’s administration and management when it comes to deploying the platform. + +To understand how Decidim works, we need to distinguish between xref:spaces.adoc[*spaces*] and xref:components.adoc[*components*]. The participatory spaces are the channels that citizens can participate through when public decisions are being taken. These are participatory processes, initiatives, consultations and assemblies. +Whereas participatory components are mechanisms that enable interaction between users of the platform and the various participatory spaces. These include meetings, pages, proposals and surveys. + +image:introduction.png[Spaces and components] + +Therefore, a participatory space as a participatory process, in the various stages, can incorporate several components such as face-to-face meetings, proposals, surveys and results and the monitoring of these. + +image:introduction_process.png[Components in a participatory process] + +So, participatory spaces are configured by defining (and configuring) the components they are going to have. It is important to bear in mind that these participatory components and the various functions are repeated in the various spaces, offering many opportunities when it comes to configuring the various spaces. This simplifies learning as once a space has been configured, it is then easier to configure another. + +This section provides a full description of how to configure the Decidim platform for any kind of organization and how to configure, manage and administer the various participatory processes. A description has been given in tutorial format, to help with understanding administration tasks, following Decidim’s literal fields and enclosing screenshots to facilitate their interpretation. + +Managing (administering) the Decidim platform is relatively simple and intuitive and no specific IT knowledge is required. The administrators of a Decidim platform, in other words, those with the necessary authorization for managing the platform, can configure the platform in a general way (images, information pages, etc.,) and manage the various participatory processes (configuring, editing, analysing and concluding). \ No newline at end of file From 0466f7d20357165526eb282cce00852b16c1275a Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:40 +0200 Subject: [PATCH 240/336] New translations information-pages.adoc (German) --- .../admin/pages/information-pages.adoc | 153 ++++++++++++++++++ 1 file changed, 153 insertions(+) create mode 100644 docs/de/modules/admin/pages/information-pages.adoc diff --git a/docs/de/modules/admin/pages/information-pages.adoc b/docs/de/modules/admin/pages/information-pages.adoc new file mode 100644 index 0000000000..b92b94229d --- /dev/null +++ b/docs/de/modules/admin/pages/information-pages.adoc @@ -0,0 +1,153 @@ += Information pages + +include::partial$legacy.adoc[] + +Here we offer you three informative pages that you can use as a template or re-use replacing the text highlighted in yellow with the correct text. You can find the same documents in spanish or catalan in their respective Administering Decidim document. + +== Information/FAQs + +[[t.6a4146f0a2c8ecae39afa2642bcb7f700ef842af]][[t.0]] + +[width="100%", cols="100%"] +|=== +|_FAQS (EN)_ + +a|If you’d like to take part in participatory processes and have your say, register! Note that to use some of the functions of certain processes (such as voting and prioritising) you will have to verify that you are registered with #Name of the Municipality/ Organization#, by following a very simple step. + +*What is #Name of the Municipality/ Organization?#* + +A platform for building a more participatory #Name of the Municipality/ Organization#, with a shared vision and for delving deeper into local participatory democracy. + +#Platformname# is a participatory platform based on open code. Citizens can see how it is built and can reuse or improve it. https://www.google.com/url?q=https://github.com/AjuntamentdeBarcelona/decidim.barcelona&sa=D&ust=1526042251888000[Check out the code here on GitHub]. + +*How can I participate in Platformname?* + +Get informed + +* Consult the active participatory processes. +* Browse through the proposals made by other citizens +* Access the face-to-face meetings' data and documents and the discussions and debates held there. +* Search contents of interest to you, by district, subject matter and tags. + +Take part + +* Make new proposals. +* Offer arguments in favour or against, or your general thoughts. +* Share the proposals on social media. + +a|Follow the existing proposals + +* Follow the existing proposals: those started on the platform and those generated by face-to-face meetings. +* After the face-to-face meetings have taken place, you can follow the progress of the discussions and debates as well as the contributions generated. +* Tick a proposal of interest to you and follow its entire progress, from the comments made by others to the final documents. + +*What are...?* + +*Participatory processes* + +*#Platformname#* activities that involve citizens and which are carried out in several stages: information, diagnosis, contributions, decisions, results and evaluation of the proposals. + +*Assemblies* + +Permanent participatory channels and bodies. + +*Face-to-face meetings:* + +Meetings and work sessions for contributing to active participatory processes. + +*Surveys* + +Questionnaire for providing information and sharing your opinion. + +*Discussions and debates* + +Digital spaces for getting informed and deciding on the proposals in the processes that have this function enabled. + +*Proposals* + +Contributions you can make as a user. In some cases you will be able to receive votes from other users. Some of them will have a decision-taking function and others a merely consultative function. Each process will have its own characteristic rules. + +*Comments* + +Contributions you can make as a user in response to a proposal or discussion and debate. + +*My residency verification doesn't work.* + +Check the following possibilities: + +* Have you entered your national ID number or document without spaces between the digits, including the final letter? +* Are you sure you are a registered resident in the municipality of #Name of the Municipality/ Organization#? (The municipality is geographically smaller than the Barcelona Metropolitan Area and the Province of Barcelona) +* There may be a problem with your data in the residency register. Consult your nearest CITIZEN HELP AND INFORMATION OFFICE and confirm that your registration information is correct. + +If all the above steps do not solve the problem, email us at #Email# or come to the face-to-face discussions and debates for each process. + +*I am not a registered resident in #Name of the Municipality/ Organization#; why can't I vote for the proposals?* + +Only registered residents in #Name of the Municipality/ Organization# are allowed to vote in processes where proposals can be voted on. When it comes to questions that affect decisions to be taken that are specific to the city, it is the city’s residents who need to take part in such decision-taking. + +It is true that there are people not registered #Name of the Municipality/ Organization# residents who may still be affected by these decisions, but the Register is the broadest available census that we have in #Name of the Municipality/ Organization#: it allows us to reach the maximum number of people while also guaranteeing that the participatory process is secure. On the other hand, not all the processes launched from the platform require their participants to be registered residents in the city. + +*I am not a registered #Name of the Municipality/ Organization# resident. Can I participate?* + +Yes, you can take part even when you are not a registered resident. You can take part in several enabled processes, in face-to-face discussions and debates, and you can launch a proposal, without having to be a registered resident. It is only in some processes that voting for proposals is limited to registered residents, just as only registered residents can vote at municipal elections. + +*Why do I have to verify my account?* + +You need a user account to use the platform. You can do more or fewer things depending on the degree of verification: + +* If you register with the website through an email address without providing any further information (so the verification process is not carried out), you will be able to comment on and debate proposals. +* If after registering, you have carried out the basic verification, i.e. you have verified your residence through the platform (more info at "How do I create and verify my account?"), you can vote for proposals in processes that are feasible (in certain processes). +* You can always take part in person and at any of the face-to-face meetings there are for each participatory process. Contributions that are made face to face will be collected, published and accessible to the platform. + +*Do I need a mobile phone or access to internet to take part?* + +No. You can carry out any action relating to the proposals - whether for creating, supporting, voting for or getting informed about them - face to face at any of the discussions and debates that are held. You can also create a completely verified user account if you wish to use the platform. + +*How do I create and verify my account?* + +The first step is to create an account. Create the account and fill in the information you are asked for. You are required to tick the box stating that you accept our user terms and conditions. On creating a new account, an email will be sent to the address you have specified, and you will have to click on the link it contains (the "Confirm my account" link) to complete the creation of the account. + +Once your basic account has been created and you have logged in using your email and password, the system will give you the option of carrying out a basic verification. To do this, click on the "My account" link on the top right and then click on the "Verify my account" button. + +Some processes, where necessary, will also require you to enter your residency data, to verify you are a registered resident in #Name of the Municipality/ Organization# (it is important to enter the document number along with the letter and your date of birth, and tick the box stating you accept access to the Municipal Register). If your data is correct, your account will allow you to support the proposals. + +*I've forgotten my password and my account doesn't work. What can I do?* + +You can request a new password, which will be sent to your email address. If the above solution does not work, you can email us at #Email#, and we will solve the problem associated with your account. Processes that include face-to-face meetings are open to you to attend and take part in, without the need for you to register with the platform. + +*How can I change my email address, my user name, my password, unsubscribe or activate/deactivate the notifications that are sent to email address?* + +Click on the "Enter" link, enter your email address and password, and click on the "Enter" button. Once you have done so, click on the "My account" link, where you will find all the options, allowing you to change your email address or user name, unsubscribe, or activate/deactivate notifications. Once you have made the appropriate changes, make sure you click on the "Save changes" button. + +*I am unable to create my account correctly.* + +Review the section "My residency verification doesn't work", in case the problem lies in this step; generally speaking, this is the most frequent problem. If this does not solve your problem, review the section "How to create and verify my account", to ensure that your are following the steps correctly. If the problem persists, email us at #Email#, and you will be given assistance. +|=== + +[[h.mkf6otb3mhlh]] +== Terms and conditions of use + +[[t.0c2d2bc083254e4010a82a1ac81ebd7f18f135ee]][[t.1]] + +[width="100%", cols="100%"] +|=== +|_Terms and conditions of use (EN)_ + +a|Legal aspects and conditions of use for the #Platformname# participatory platform at #Name of the Municipality/ Organization# City Council. + +(the ones that the legal services recommend you. You can use the https://www.google.com/url?q=https://decidim.barcelona/pages/terms-and-conditions&sa=D&ust=1526042251902000[Decidim.Barcelona terms and conditions of use] as a model). +|=== + +[[h.3oy7u29]] +== How the platform works + +[[t.44b67a895959076674b8c3aa044e22bbd448f440]][[t.2]] + +[width="100%", cols="100%"] +|=== +|_Accessibility (EN)_ + +a|This refers to the webpage's design and contents, which have to be accessible (without any visual or technological obstacles and for the largest number of users possible), and to standard regulations (WAI, Web Accessibility Initiative). + +Decidim.Barcelona example https://www.google.com/url?q=https://www.decidim.barcelona/pages/accessibility&sa=D&ust=1526042251903000[Accessibility]. +|=== \ No newline at end of file From 382213aa33ef83db1c8e82559ad20981bb0db7fc Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:41 +0200 Subject: [PATCH 241/336] New translations initiatives_initializer.adoc (German) --- .../admin/pages/initiatives_initializer.adoc | 174 ++++++++++++++++++ 1 file changed, 174 insertions(+) create mode 100644 docs/de/modules/admin/pages/initiatives_initializer.adoc diff --git a/docs/de/modules/admin/pages/initiatives_initializer.adoc b/docs/de/modules/admin/pages/initiatives_initializer.adoc new file mode 100644 index 0000000000..80f663fc2c --- /dev/null +++ b/docs/de/modules/admin/pages/initiatives_initializer.adoc @@ -0,0 +1,174 @@ += Initiatives Initializer + +For using the initiatives module, you'll want to review the configurations that are in the initializer. See the xref:configure:initializer.adoc[general Initializer configuration] for more information regarding this file. + +You'll need to change in the `config/initializer/decidim.rb` file. You could also create an ad-hoc file for these configurations, like `config/initializer/initiatives.rb`. + +After making changes to this file you'll need to also restart your application server. + +== Creation enabled + +Setting that defines whether creation is allowed to any validated user or not. Defaults to true. + +[source,ruby] +.... + config_accessor :creation_enabled do + true + end +.... + +== Similarity threshold + +Setting that defines the similarity minimum value to consider two +initiatives similar. Defaults to 0.25. + +[source,ruby] +.... + config_accessor :similarity_threshold do + 0.25 + end +.... + +== Similarity limit + +Setting that defines how many similar initiatives will be shown. +Defaults to 5. + +[source,ruby] +.... + config_accessor :similarity_limit do + 5 + end +.... + +== Minimum committee members + +Minimum number of committee members required to pass the initiative to +technical validation phase. Only applies to initiatives created by +individuals. + +[source,ruby] +.... + config_accessor :minimum_committee_members do + 2 + end +.... + +== Default signature time period length + +Number of days available to collect supports after an initiative has been +published. + +[source,ruby] +.... + config_accessor :default_signature_time_period_length do + 120 + end +.... + +== Default components + +Components enabled for a new initiative + +[source,ruby] +.... + config_accessor :default_components do + [:pages, :meetings] + end +.... + +== First notification percentage + +Notifies when the given percentage of supports is reached for an +initiative. + +[source,ruby] +.... + config_accessor :first_notification_percentage do + 33 + end +.... + +== Second notification percentage + +Notifies when the given percentage of supports is reached for an +initiative. + +[source,ruby] +.... + config_accessor :second_notification_percentage do + 66 + end +.... + +== Stats cache expiration time + +Sets the expiration time for the statistic data. + +[source,ruby] +.... + config_accessor :stats_cache_expiration_time do + 5.minutes + end +.... + +== Max time in validating state + +Maximum amount of time in validating state. +After this time the initiative will be moved to +discarded state. + +[source,ruby] +.... + config_accessor :max_time_in_validating_state do + 60.days + end +.... + +== Print enabled + +Print functionality enabled. Allows the user to get +a printed version of the initiative from the administration +panel. + +[source,ruby] +.... + config_accessor :print_enabled do + true + end +.... + +== Timestamp service + +Set a service to generate a timestamp on each vote. The +attribute is the name of a class whose instances are +initialized with a string containing the data to be +timestamped and respond to a timestamp method. + +[source,ruby] +.... + config_accessor :timestamp_service +.... + +== PDF signature service + +Set a service to add a signature to pdf of signatures. +The attribute is the name of a class whose instances are +initialized with the document to be signed and respond to a +signed_pdf method with the signature added. + +[source,ruby] +.... + config_accessor :pdf_signature_service +.... + +== Do no require authorization + +This flag allows creating authorizations to unauthorized users. + +[source,ruby] +.... + config_accessor :do_not_require_authorization do + false + end +.... \ No newline at end of file From d792bf2dc35958d9d1a8d8f78e435012de205fc2 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:43 +0200 Subject: [PATCH 242/336] New translations newsletters.adoc (German) --- docs/de/modules/admin/pages/newsletters.adoc | 164 +++++++++++++++++++ 1 file changed, 164 insertions(+) create mode 100644 docs/de/modules/admin/pages/newsletters.adoc diff --git a/docs/de/modules/admin/pages/newsletters.adoc b/docs/de/modules/admin/pages/newsletters.adoc new file mode 100644 index 0000000000..7c3c069551 --- /dev/null +++ b/docs/de/modules/admin/pages/newsletters.adoc @@ -0,0 +1,164 @@ += Newsletters + +Newsletters are emails sent to the organization's participants with the news. They are +sent to participants that have checked the "Receive an occasional newsletter +with relevant information" when the participant signed up or after in their account. + +image::newsletter_contact_permission.png[Contact permission in participant registration] + +image::newsletter_participant_notifications_settings.png[Contact permission in participant account] + +Some examples of when you can and should sent a newsletter are: + +* When a new process could be interesting for all the citizens in a city, +for instance a Participatory Budgeting process. +* When there are the results published for a given process. +* When an assembly has a important point for discussion. +* When there's a new voting planned. +* When there's a new conference published + +To create a new newsletter, as an administrator you need to: + +. Go to newsletter menu +. Click in the button "New newsletter" +. Select the template that you want to use +. Fill the form with the newsletter contents +. Preview the newsletter +. Select recipients to deliver +. Deliver the newsletter + +== 1. Go to newsletter menu + +It's on the main sidebar of the admin panel. + +image::newsletter_menu.png[Newsletter admin menu] + +== 2. Click in the button "New newsletter" + +In this page you'll have a list of all the sent newsletters, along with the status +(if it was sent already or not) and how many participants have received it. + +image::newsletter_list.png[Newsletter list] + +In the secondary sidebar or in the top of the list you have the button for "New +newsletter". + +== 3. Select template of new newsletter + +Depending on what you want to sent, if it's just a quick update or if it's something +a little more elaborated (with an image and a button), then you can choose for +which kind of template you want to use: + +* Basic (only text) +* Text, image and Call to Action button + +image::newsletter_templates.png[Newsletter new templates selection] + +== 2. Fill the form with the newsletter contents + +Depending in which template you've choosen, you have two different forms for +filling: + +=== Basic (only text) newsletter form + +image::newsletter_new_basic.png[Newsletter new template basic form] + +image::newsletter_new_basic_example.png[Newsletter new template basic form filled] + +[NOTE] +==== +You can use "%\{name}" anywhere in the body or subject and it will be +replaced by the recipient's name. +==== + + +.New Newsletter "basic (only text)" form +|=== +|Field |Type |Description + +|Subject +|Required +|Subject of the email. + +|Body +| +|Body of the email. +|=== + +=== Text, image and Call to Action button newsletter form + +image::newsletter_new_cta01.png[Newsletter new template text, image and CTA form 1] + +image::newsletter_new_cta02.png[Newsletter new template text, image and CTA form 2] + + +.New Newsletter "Image, text and Call To Action button" form +|=== +|Field |Type |Description + +|Subject +|Required +|Subject of the email. + +|Introduction +| +|Body of the email. + +|Call To Action button text +| +|What will the button say. For instance, it could be "Participate" + +|Call To Action button URL +| +|Where will the button link to. For instance, it could be the complete URL of a participatory process. + +|Body +| +|Body of the email. + +|Main image +| +|Guidance for image: Preferrably a landscape image that does not have any text. The service crops the image. Allowed file extensions: jpg jpeg gif png bmp ico +|=== + +== 3. Preview the newsletter + +After you've filled the contents of the newsletter, you can preview it. Until you've +sent it you can go back and edit it anytime you want. + +image::newsletter_preview_basic_example.png[Newsletter new template basic form preview] + +== 4. Select recipients to deliver + +If you want to only communicate about a given space, one useful way of doing this +is through the "Select recipients to deliver". Here you can choose between: + +* Sending the newsletter to all confirmed users +* Sending the newsletter to all confirmed users that have participated in any of +the selected participatory spaces in the list +* Sending the newsletter to all confirmed users that have followed any of +the selected participatory spaces in the list +* Sending the newsletter to all the participants that have selected an scope in +their "My interests" settings in their account. + +It's important to note that even if a participant has confirmed its account and +is following the space, the system will not send her a newsletter email if she +haven't activated the "I want to receive newsletters". + +image::newsletter_select_recipients.png[Newsletter select recipients] + +If you select the "Sent do participants" or "Send to followers" of a given space, +then you can choose which spaces are relevant: + +image::newsletter_select_recipients_spaces.png[Newsletter select recipients spaces] + +== 5. Deliver the newsletter + +Finally if you click in the "Deliver newsletter" button, the newsletter will be +sent to all the selected recipients. + +[NOTE] +==== +Once a newsletter was sent it can't be undone nor edited. If you have multiple +languages active, be careful with reviewing all the languages well before sending. +==== \ No newline at end of file From 57519a42f4f82704304ad310b05b678dafd0073d Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:44 +0200 Subject: [PATCH 243/336] New translations pages.adoc (German) --- docs/de/modules/admin/pages/pages.adoc | 125 +++++++++++++++++++++++++ 1 file changed, 125 insertions(+) create mode 100644 docs/de/modules/admin/pages/pages.adoc diff --git a/docs/de/modules/admin/pages/pages.adoc b/docs/de/modules/admin/pages/pages.adoc new file mode 100644 index 0000000000..23b34d8656 --- /dev/null +++ b/docs/de/modules/admin/pages/pages.adoc @@ -0,0 +1,125 @@ += Pages + +You can configure static Pages, which contains general information to the participants of the platform. + +As an example, some of these pages could refer to: + +* What's this platform? Who's the organization? +* How can I participate here? +* How can I create and verify my account? +* What are the terms of conditions and the legal information about this platform? + +These pages will be available to all the participants through the **Help** top menu section and also at the footer sections. You can define **Topics** to categorize all of these pages. + +As the platform enables the Participants to sign up (register) and save some of their personal data, it's important that there's an especial page, called **Terms and Conditions**. This is where you need to put your legal terms, for instance which entity has control of this data, how much time does this data will be saved, etc. This should be (ideally) written and (at least) reviewed by a lawyer. + +== Create a new page + +For creating a new page, you need to: + +. Sign in as admin +. Click in Pages in the sidebar menu +. Click in "Create page" + +image::pages_backend_form.png[Backend: new page form] + + +.New page form +|=== +|Field |Type |Description + +|Title +|Required +|Title of this page. For instance: "How to participate?" + +|URL Slug +|Required +|String that will be used on the URL. Benutze hier partielle Pfade, nicht vollständige URLs. Akzeptiert Buchstaben, Zahlen, Bindestriche und Schrägstriche und muss mit einem Buchstaben beginnen. For instance if the slug is "hello-world" and your domain is "https://example.org", your page will be at "https://example.org/hello-world" + +|Content +|Required +|All the text of the page. + +|Topic +|Optional +|In which Topic it'll be in. + +|Weight +|Optional +|Which order will it have in relation with the other pages. Having a lower number means a higher priority. For instance, if you have two pages, "Page a" with weight "10" and "Page b" with weight "0", then "Page b" will be first when ordering. + +|Show in the footer +|Optional +|Wether you want to show this page in the general footer (available in every page). +|=== + +image::pages_frontend_footer.png[Frontend: example of a page in the footer] + +== Create a new topic + +For creating a new topic, you need to: + +. Sign in as admin +. Click in Pages in the sidebar menu +. Click in "Create topic" + +image::pages_backend_topic_form.png[Backend: new topic form] + + +.New topic form +|=== +|Field |Type |Description + +|Title +|Required +|Title of this topic. For instance: "Help" + +|Description +|Optional +|What's this topic is about. + +|Weight +|Optional +|Which order will it have in relation with the other topics. Having a lower number means a higher priority. For instance, if you have two topics, "Topic a" with weight "10" and "Topic b" with weight "0", then "Topic b" will be first when ordering. + +|Show in the footer +|Optional +|Wether you want to show this topic in the general footer (available in every page). +|=== + +== Special "Terms and Conditions" page + +This is where you need to put your legal terms, for instance which entity has control of this data, how much time does this data will be saved, etc. This should be (ideally) written and (at least) reviewed by a lawyer. + +It's generated by default in a new installation. It can't be deleted, and it has a few special details related with its legal nature: + +. It's shown in the text area sign up form +. If there are meaningful changes, it has a field that can allow an admin when it's necessary that the participants accept the "Terms and Conditions" again, in the next sign in. + +image::pages_backend_tos_change.png[Backend: ToS change] + +image::pages_frontend_tos_change.png[Frontend: ToS change] + +If a participant rejects to accept the terms, then she has three options: + +. To review this again later. It signs her out automatically. +. To download their personal data +. To delete her account + +image::pages_frontend_tos_reject.png[Frontend: ToS reject] + +== Examples + +=== Pages + +image::pages_frontend_show.png[Frontend: show a page] + +image::pages_backend_edit.png[Backend: edit a page] + +image::pages_backend_list.png[Backend: list pages] + +=== Topics + +image::pages_frontend_list_topics.png[Frontend: list topics of pages] + +image::pages_backend_list_topics.png[Backend: list topics of pages] \ No newline at end of file From 64d2f160a90f0cecba076407ed229887e54ae926 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:45 +0200 Subject: [PATCH 244/336] New translations participants.adoc (German) --- docs/de/modules/admin/pages/participants.adoc | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 docs/de/modules/admin/pages/participants.adoc diff --git a/docs/de/modules/admin/pages/participants.adoc b/docs/de/modules/admin/pages/participants.adoc new file mode 100644 index 0000000000..829abbbae3 --- /dev/null +++ b/docs/de/modules/admin/pages/participants.adoc @@ -0,0 +1,29 @@ += Participants + +Sometimes as an administrator you'll need to make certain tasks with participants, among them: + +* To give permissions to other administrators so they can manage platform's content +* To verify user groups (organizations or collectives) +* To verify participants +* To recognize that a participant has a special status in the platform, with Officializations +* To authenticate that a person has the right to vote, with Authorizations +* To contact a participant + +You can access this section on the main sidebar of the admin panel. + +image:participants_menu.png[Participants menu] + +Once you're in you can see all the different kind of participants and actions that you can do: + +image:participants_sidebar_menu.png[Participants sidebar menu] + +* xref:admin:participants/admins.adoc[Admins] +* xref:admin:participants/groups.adoc[Groups] +* xref:admin:participants/participants.adoc[Participants] +* xref:admin:participants/impersonations.adoc[Impersonations] +** xref:admin:participants/verifications_conflicts.adoc[Überprüfungskonflikte] +* xref:admin:participants/reported_users.adoc[Gemeldete Benutzer] +* xref:admin:participants/authorizations.adoc[Authorizations] +** xref:admin:participants/authorizations/identity_documents.adoc[Identifizierungsdokumente] +** xref:admin:participants/authorizations/code_postal_letter.adoc[Code by postal letter] +** xref:admin:participants/authorizations/census.adoc[Organization's census] \ No newline at end of file From 6c3a0a3aa7df33a58c1981903d5016d6acd6a2ea Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:46 +0200 Subject: [PATCH 245/336] New translations admins.adoc (German) --- .../admin/pages/participants/admins.adoc | 21 +++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 docs/de/modules/admin/pages/participants/admins.adoc diff --git a/docs/de/modules/admin/pages/participants/admins.adoc b/docs/de/modules/admin/pages/participants/admins.adoc new file mode 100644 index 0000000000..f88bcff92b --- /dev/null +++ b/docs/de/modules/admin/pages/participants/admins.adoc @@ -0,0 +1,21 @@ += Admins + +In the administrator listing page you can see all the administrators of the platform: + +image:admins.png[Admins list] + +Here you can: + +* invite new administrators +* revoke administrators permissions +* see when was the last time an administrator logged in + +For inviting a new administrator, you need to go to the button "New user" and fill +the form with the admin username, email and which role will she have: + +* Admin: to give full access to the platform +* Participant manager: to give permission to only do xref:admin:participants/impersonations.adoc[Impersonations] + +image:admins_invite.png[Invite participant as administrator form] + +You can invite an already registered or a non registered participant. \ No newline at end of file From 54271647c2f95192e20f3d7a2c544f5aac9366aa Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:47 +0200 Subject: [PATCH 246/336] New translations authorizations.adoc (German) --- .../pages/participants/authorizations.adoc | 40 +++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 docs/de/modules/admin/pages/participants/authorizations.adoc diff --git a/docs/de/modules/admin/pages/participants/authorizations.adoc b/docs/de/modules/admin/pages/participants/authorizations.adoc new file mode 100644 index 0000000000..43b2ebea32 --- /dev/null +++ b/docs/de/modules/admin/pages/participants/authorizations.adoc @@ -0,0 +1,40 @@ += Authorizations + +This section allows you to manage participants' authorizations. It depends on which Authorizations you have configured and +enabled by your developers. To understand more what are authorizations and how to configure them, please refer to the +xref:customize:authorizations.adoc[Authorizations section in the Customize Guide]. + +With authorizations an administrator can define different permissions so participants can make some actions in a component. +For instance you can configure that only participants who have verified herselves by their identity documents can vote on +proposals in a participatory process. + +A participant can see which authorizations does she have available in her account settings. + +image:authorizations_account.png[Authorizations in participants account] + +== Authorizations revocation + +A default Decidim installation will not have verified participants. + +image:authorizations_admin_default.png[Authorizations in a default installation] + +In the moment that there are some participants verified, an administrator can revoke all the authorizations, as the attributes +that give permissions to those participants could be changed in time and the platform didn't receive these changes in the +participants statuses. For instance, an identity document of a participant could be expired, or if a participant have been +authorized by the "code by postal letter", that participant could move in the meantime. + +image:authorizations_admin_revocation.png[Authorizations revocation] + +It's possible to revoke all the authorizations with "Revoke all", or to only revoke authorizations before a given date. +Another possiblity is to revoke only the xref:admin:participants/impersonations.adoc[impersonated participants]. + +== Verification methods + +Some of the available authorizations by default are: + +* xref:admin:participants/authorizations/identity_documents.adoc[Identifizierungsdokumente] +* xref:admin:participants/authorizations/code_postal_letter.adoc[Code by postal letter] +* xref:admin:participants/authorizations/census.adoc[Organization's census] + +If any of these authorizations are not useful for your needs, talk with your implementer to see other alternatives. Learn +more about xref:customize:authorizations.adoc[Authorizations in the Customize Guide section]. \ No newline at end of file From 379d519c085130990276febe527657f5b4bd0d4f Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:48 +0200 Subject: [PATCH 247/336] New translations census.adoc (German) --- .../participants/authorizations/census.adoc | 34 +++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 docs/de/modules/admin/pages/participants/authorizations/census.adoc diff --git a/docs/de/modules/admin/pages/participants/authorizations/census.adoc b/docs/de/modules/admin/pages/participants/authorizations/census.adoc new file mode 100644 index 0000000000..b7e2cfbb9d --- /dev/null +++ b/docs/de/modules/admin/pages/participants/authorizations/census.adoc @@ -0,0 +1,34 @@ += Organization's census authorization + +The process is as follows: + +. Admins upload a CSV with the emails of the accepted participants +. Participants go to its accounts and requests to be verified +. Only participants with an email in that CSV file can get verified + +NOTE: is this too simple and you need more features related to CSV census imports? +Check all the CSV or file based authorizations in our https://decidim.org/modules/[Modules page]. + +== 1. An administrator uploads the CSV of the participants + +In the admin panel, the administrator can review the request by going to the "Organization's census" in the "Participants" section. + +image:authorizations_organization_census.png[Organization's census in admin panel] + +After the CSV is imported then the administrator can see how many participants where imported. She can also delete this +imported census. + +image:authorizations_organization_census_imported.png[Imported CSV] + +== 2. A participant requests to be verified + +By going to the authorization section in its profile, or by clicking on the action button if this permission is requested, +a participant can request to be verified. + +image:authorizations_organization_census_account.png[Organization's census in participant's accounts] + +== 3. The participant is verified (or not) + +After is verified, as with other verifications, she can see it in her account settings. + +image:authorizations_organization_census_verified.png[Verified by organization's census] \ No newline at end of file From d4ffb5671719161e40269071c35231be3d1c39ee Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:49 +0200 Subject: [PATCH 248/336] New translations code_postal_letter.adoc (German) --- .../authorizations/code_postal_letter.adoc | 57 +++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 docs/de/modules/admin/pages/participants/authorizations/code_postal_letter.adoc diff --git a/docs/de/modules/admin/pages/participants/authorizations/code_postal_letter.adoc b/docs/de/modules/admin/pages/participants/authorizations/code_postal_letter.adoc new file mode 100644 index 0000000000..953c5c0eb0 --- /dev/null +++ b/docs/de/modules/admin/pages/participants/authorizations/code_postal_letter.adoc @@ -0,0 +1,57 @@ += Code by postal letter authorization + +This authorization allows a participant to request for a verification code to be sent to its address, to confirm that she +lives or works in this place. She'll need to then fill the code in the platform. + +The process is: + +. Participants request a verification code to be sent to their address. +. An administrator sends the letter to their address with the verification code. +. An administrator marks the letter as sent. +. Once you mark the letter as sent, the participant will be able to introduce the code. +. If this code matchs, then she gets verified. + +== 1. A participant request the verification code + +By going to the authorization section in its profile, or by clicking on the action button if this permission is requested, +a participant can see the form for filling in her full address to request the verification code. + +image:authorizations_code_postal_letter_request.png[Code by postal letter request by participant] + +If she tries to edit it, she'll see this message: + +image:authorizations_code_postal_letter_edit.png[Edit the postal letter request] + +This is because the letter could be in the process of being sent. If this needs to be corrected, then the participant needs +to contact to the organization. + +== 2. An administrator review this request and sent the letter + +In the admin panel, the administrator can review the request by going to the "Code by postal letter" in the "Participants" section. + +image:authorizations_code_postal_letter_ongoing.png[Code by postal letter ongoing panel in admin] + +Here she can see the verification code and can send it to the participant by mail. After the code is sent she can mark it +as sent with the icon image:action_mark_as_sent.png[Mark as sent]. It'll also show when the letter was sent. + +== 3. A participant fills in the verification code + +After the participant has received the code, she can go to it's account settings and click in the "Code by postal letter" +verfication method. + +image:authorizations_code_postal_letter_verify.png[Code by postal letter ongoing in the participant account] + +Then she'll see the form for confirming the code. + +image:authorizations_code_postal_letter_confirm.png[Code by postal letter confirmation form] + +== 4. The verification code matches or not + +If the verification code matches, then the participant will see the message "Congratulations. You've been successfully verified". + +On the other hand, if the verification code doesn't match, then the participant will see the message "Your verification +code doesn't match ours. Please double-check the letter we sent to you." + +After is verified, as with other verifications, she can see it in her account settings. + +image:authorizations_code_postal_letter_verified.png[Verified by code by postal letter] \ No newline at end of file From 2c96b140d0da668800bbe7da383517e4bfafc342 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:51 +0200 Subject: [PATCH 249/336] New translations identity_documents.adoc (German) --- .../authorizations/identity_documents.adoc | 141 ++++++++++++++++++ 1 file changed, 141 insertions(+) create mode 100644 docs/de/modules/admin/pages/participants/authorizations/identity_documents.adoc diff --git a/docs/de/modules/admin/pages/participants/authorizations/identity_documents.adoc b/docs/de/modules/admin/pages/participants/authorizations/identity_documents.adoc new file mode 100644 index 0000000000..2502903d6a --- /dev/null +++ b/docs/de/modules/admin/pages/participants/authorizations/identity_documents.adoc @@ -0,0 +1,141 @@ += Identity documents authorization + +This authorization allows a participant to upload its identity documents. These documents depend on the organization, +they could be a driver's license, a passport, a national identity card, a club membership card, etc. + +These documents will be reviewed by an administrator to accept or reject them. It's possible to do this process in two ways: Online or Offline. + +* Online: the participant will be asked to upload the documents, and the administrator will review these documents. +* Offline: the participant will be asked to fill in some data, and then she'll need to go to a presential place to show her documents face to face. + +== Configuration + +By clicking on the btn:[Config] button in this section, an administrator can configure the settings for this authorization. + +image:authorizations_id_document_configuration.png[ID document authorization configuration] + +NOTE: As you can see, this authorization is based in the original implementers reality, in this case in the Spanish identities document types. +For instance, we're giving as options for document types "DNI, NIE or Passport" or we're asking for "Document number (with letter)" +You can change this by xref:customize:code.adoc[code customizing or overriding] these things. We also accept xref:contribute:governance.adoc[Pull Request contributions] +so it's possible to configure this. + + +.ID Documents authorization configuration +|=== +|Field |Type |Description + +|Available methods +|Required +|At least one method must be selected. Options: Online and/or Offline. + +|Instructions for offline verification +|Required (if offline is selected) +|Directions that participants need to follow to verify their documents when offline verification is selected. For instance, +do they need to go to a specific place to show their documents? Is this place open some days of the week? Is it open +for certain hours? +|=== + +== Online + +The process is: + +. Participants fill in their document type and number and upload a copy of their document. +. An administrator fills in the information present in the uploaded image. +. The information should match whatever the user filled in. +. If the administrator can't clearly see the information or she can't get it verified, she can reject the request and +the user will be able to fix it. + +=== 1. A participant fill in the document information and upload a copy of her document + +By going to the authorization section in its profile, or by clicking on the action button if this permission is requested, +a participant can see the form for uploading a copy of her document. She also needs to fill in her document type and number. + +image:authorizations_id_document_online.png[ID document authorization online form] + +=== 2. An administrator review this document + +After this document is uploaded, an administrator can review it by going to the Identity documents section in the admin +panel. + +image:authorizations_id_document_online_pending.png[ID document authorization pending online verification] + +After clicking on the document, the administrator needs to see the image and fill in the document number. This needs to match +with the one provided by the participant. + +image:authorizations_id_document_online_confirm.png[ID document authorization online confirmation form] + +=== 3. The request is accepted or rejected + +There are two actions an admin can do: + +* Accept: the participant will be fully authorized. +* Reject: the participant will be prompted to amend her documents + +If the request is rejected then the participant can provide other pictures or document. + +image:authorizations_id_document_online_rejected.png[ID document authorization rejected online verification] + +== Offline + +The process is: + +. Participants fill in their document type and number. +. Participants follow the instructions provided to them. For instance, if they need to go to a specific place in a +specific time to show their documents. +. An administrator go to the "Offline verification" panel and fills in the information present in the physical documents. +. The information should match whatever the user filled in. +. If the administrator can't clearly see the information or she can't get it verified, she can reject the request and +the user will be able to fix it. + +For this authorization to work, an administrator need to first configure it in the admin panel with the instructions explaining +what the participant need to do to finish the verification process. + +image:authorizations_id_document_configuration_offline.png[ID document authorization configuration: offline instructions] + +=== 1. A participant fill in the document information and follow the instructions + +By going to the authorization section in its profile, or by clicking on the action button if this permission is requested, +a participant can see the form for filling in her document type and number. + +image:authorizations_id_document_offline_request.png[ID document authorization offline form] + +=== 2. An administrator review this request + +In the admin panel, the administrator can review the request by clicking in the "Offline verification" button. + +image:authorizations_id_document_offline_button.png[ID document authorization offline button in admin] + +Then she'll need to fill some data provided by the participant and by reviewing the document physically provided by her. + +image:authorizations_id_document_offline_confirm.png[ID document authorization offline confirmation form in admin] + + +.ID Documents authorization offline flow +|=== +|Field |Type |Description + +|Participant email +|Required +|Email of the registered participant + +|Type of the document +|Required +|Can be: DNI, NIE or Passport + +|Document number (with letter) +|Required +|Document number of the participant. For instance, "12345678Z" +|=== + +=== 3. The request is accepted or rejected + +In the cases where the verifications don't match (meaning that the email or the document number provided by the +participant and the ones filled by the administrators aren't the same), then the participant need to ammend it with her +user account. + +== Both + +It's also possible to enable both of these verifications methods. In this case, the participant will be asked to choose +which kind of verification she wants to do. + +image:authorizations_id_document_account_choose.png[Choose ID document verification kind] \ No newline at end of file From 3fcb0607f72346bed68d4a27b43f92a39787d500 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:52 +0200 Subject: [PATCH 250/336] New translations groups.adoc (German) --- .../admin/pages/participants/groups.adoc | 116 ++++++++++++++++++ 1 file changed, 116 insertions(+) create mode 100644 docs/de/modules/admin/pages/participants/groups.adoc diff --git a/docs/de/modules/admin/pages/participants/groups.adoc b/docs/de/modules/admin/pages/participants/groups.adoc new file mode 100644 index 0000000000..3201f6fac9 --- /dev/null +++ b/docs/de/modules/admin/pages/participants/groups.adoc @@ -0,0 +1,116 @@ += User Groups + +An user group is a group of participants. Depending in the installation and the context of the organization it could be disabled. This is enabled or disabled in the administration dashboard, in Settings -> Configuration -> Edit organization -> Enable groups. + +== Creation + +This action is done by **a participant**. She needs to go to their profile and in the sidebar there's a button that says "Create group": + +image:user_sidebar.png[User sidebar] + +When clicked it'll open the "New group form": + +image:user_group_new_form.png[New user group form] + + +.New group form +|=== +|Field |Type |Description + +|Name +|Required +|Name of your organization, association, collective, group, etc. + +|Nickname +|Required +|Nickname of your organization, association, collective, group, etc. Do not use spaces nor accents. 20 characters maximum. + +|Email +|Required +|Email of your organization, association, collective, group, etc. + +|Avatar +|Optional +|Guidance for image: Preferably a landscape image that does not have any text. The service crops the image. Maximum file size: 5MB. Allowed file extensions: jpg jpeg gif png bmp ico + +|About +|Optional +|Description of what's this group. + +|Document number +|Optional +|Used for verifications. Do not use dashes nor spaces. + +|Phone +|Optional +|Used for verifications. Do not use dashes nor spaces. +|=== + +== Membership + +After a group has been created, it's possible to invite participants to become members of the group. After a participant has accepted to be part of this group then she can become an admin. + +The actions that can be done by a participant in the user group are: + +* Edit group profile +* Manage members +* Manage admins +* Invite participant +* Leave group + +image:user_group_invite_participant.png[User groups: invite a participant] + +== Group verifications + +image:admin_user_group_verification.png[Admin panel: user group verifications] + +This action is done by **an administrator**. A group can be: +* Pending +* Verified +* Rejected + +This can be done with the buttons at the sidebar: + +image:admin_user_group_verification_actions.png[Admin panel: user group verifications actions] + +When a user group is pending it can be verified or rejected. Once is verified it can be rejected and once is rejected it can be verified. + +If you want to verify multiple user groups at the same time you can do so with the option "Verify via CSV": + +image:admin_user_group_verification_csv.png[Admin panel: user group verifications CSV] + +.... +Upload your CSV file. It must have the official emails of the groups in your organization in the first column of the file, without headers. Only groups that have confirmed their email and that have an email appearing in the CSV file will be validated. +.... + +After a group is verified this is publicly visible in their nickname in the platform and there's a message in its profile: "This group is publicly verified, its name has been verified to correspond with its real name". + +image:user_group_verified.png[User group: verified icon] + +== Actions + +As a verified user group, there's some options that your participant account can do in behalf of the group, such as: + +=== Create a Debate, Proposal or Meeting + +There's a dropdown in the form during the creation process: + +image:user_group_create_debate.png[User group: create a debate] + +=== Make a comment + +There's a dropdown in the form when making a comment: + +image:user_group_make_comment.png[User group: make a comment] + +=== Endorse + +When making an Endorse there's a modal window asking who do you want to make the endorse with: + +image:user_group_endorse.png[User group: endorse] + +=== Conversations + +You can also have Conversations as a group. This is in the group profile page: + +image:user_group_conversation.png[User group: conversations] \ No newline at end of file From 81001a9c6e6ae2bba047d2bb1de1a64996e97549 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:53 +0200 Subject: [PATCH 251/336] New translations impersonations.adoc (German) --- .../pages/participants/impersonations.adoc | 42 +++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 docs/de/modules/admin/pages/participants/impersonations.adoc diff --git a/docs/de/modules/admin/pages/participants/impersonations.adoc b/docs/de/modules/admin/pages/participants/impersonations.adoc new file mode 100644 index 0000000000..9cd1788be5 --- /dev/null +++ b/docs/de/modules/admin/pages/participants/impersonations.adoc @@ -0,0 +1,42 @@ += Participants Impersonations + +For participants that don't have the knowledge or don't have an email for registering +an account, there's the Impersonation feature. + +This allows an 'Administrator' or 'Participant manager' to search through a +Verification system for an already existing participant and also to create a +participant without email. + +NOTE: At the code and the User Interface we say both *Impersonation* and *Managed +Participants*. It's the same thing. + +== Panel + +image::participants_impersonations.png[Admin's Impersonations panel] + +This is the panel where you can find all the participants: + +* by filtering by managed or not managed participants +* by searching by name + +After you've clicked in `Manage new participant` you'll go to the form to enter +the personal data to check against the verification: + +image::participants_impersonations_form.png[Admin's Impersonations form] + +NOTE: If you don't see the `Manage new participant` button, is because this feature +only works when you have a Verification of kind `direct` (also known +as `form authorizations`). See in your xref:admin:system.adoc[system panel] which +`Available authorizations` are enabled. You can learn more regarding how to program +your form authorization in https://github.com/decidim/decidim/blob/develop/decidim-verifications/README.md[decidim-verification README]. + +After this data is confirmed then there'll be a session for the participant for +30 minutes: + +image::participants_impersonations_user.png[Impersonated user session] + +Finally, it's also possible to Promote a participant, meaning that after a +participant has been managed, an administrator can add the email and send her +an Invitation: + +image::participants_impersonations_promotion.png[Admin's promotion Impersonations] \ No newline at end of file From c9c5e4928679350a420bc9db6ddf8ed8a740648a Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:54 +0200 Subject: [PATCH 252/336] New translations participants.adoc (German) --- .../pages/participants/participants.adoc | 90 +++++++++++++++++++ 1 file changed, 90 insertions(+) create mode 100644 docs/de/modules/admin/pages/participants/participants.adoc diff --git a/docs/de/modules/admin/pages/participants/participants.adoc b/docs/de/modules/admin/pages/participants/participants.adoc new file mode 100644 index 0000000000..e76ab358b4 --- /dev/null +++ b/docs/de/modules/admin/pages/participants/participants.adoc @@ -0,0 +1,90 @@ += Participants + +In this page an administrator can: + +* Block a participant, for instance because she's spamming or acting against the Terms of Service +* Contact a participant with Decidim private messages (Conversations) +* Officialize a participant +* See its email + +image:participants_participants.png[Participants list] + +== Actions + +image:participants_participants_actions.png[Participants actions] + +|=== +|Icon |Name |Definition + +|image:action_block.png[Block user] +|xref:_block_user[Block user] +|To block or moderate a participant. + +|image:action_show_email.png[Show email] +|xref:_show_email_address[Show email address] +|To show an email of a participant. + +|image:action_contact.png[Contact] +|xref:_contact[Contact] +|To contact a participant with Decidim private messages (Conversations) + +|image:action_officialize.png[Officialize] +|xref:_officialize[Officialize] +|To recognize that a participant has a special status in the platform + +|image:action_reofficialize.png[Reoffficialize] +|Reoffficialize +|To change an officialization. See xref:_officialize[Officialize] + +|image:action_unofficialize.png[Unofficialize] +|Unofficialize +|To revoke an officialization. See xref:_officialize[Officialize] +|=== + +=== Block user + +After clicking in this option you'll need to provide a justification why you're +blocking this participant: + +image:participants_block_user_justification.png[Justificate the blocked user action] + +Once a blocked participant tries to log-in she'll see an error message: + +image:participants_block_user_alert.png[Message shown to blocked user] + +After a participant was blocked its name is changed to "Blocked user". + +See more at xref:admin:participants/reported_users.adoc[Reported users] + +=== Show email address + +After clicking this option, the admin will see a modal. She'll have to click in +button "Show email address". + +image:participants_show_email.png[Modal in show email] +image:participants_showed_email.png[Modal after the email is shown] + +This action will be logged in the Admin actvity log. + +image:participants_showed_email_admin_log.png[Admin activity log for show email] + +=== Contact + +By clicking on this option, it will open the private messaging (Conversation) for +this participant. + +image:participants_conversation.png[Conversation with a participant]. + +=== Officialize + +This option is useful to recognize that a participant has a special status in the +platform. For instance, if someone is the City Mayor, a City Councillor or the +President of an Association in an organization context. + +After Officializing a participant you can: + +- Change the Officialization text with "Reofficialize" +- Revoke the Officialization status with "Unofficialize" + +image:participants_officialize.png[Officialize a participant] +image:participants_participants_actions_officialize.png[Officialize a participant] \ No newline at end of file From ec2ff4b7d2b8d4d48942a4e6a1a05b8dc3ed9796 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:55 +0200 Subject: [PATCH 253/336] New translations reported_users.adoc (German) --- .../pages/participants/reported_users.adoc | 33 +++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 docs/de/modules/admin/pages/participants/reported_users.adoc diff --git a/docs/de/modules/admin/pages/participants/reported_users.adoc b/docs/de/modules/admin/pages/participants/reported_users.adoc new file mode 100644 index 0000000000..6616b10c2b --- /dev/null +++ b/docs/de/modules/admin/pages/participants/reported_users.adoc @@ -0,0 +1,33 @@ += Reported users + +There are cases where participants could go against the Terms of Service of the +platform, so it's useful to have the option for reporting and blocking users. You +can read more about how moderation and reporting contents work in xref:global_moderations.adoc[Global moderations]. + +A participant can be blocked from the xref:participants/participants.adoc[participants +section in the admin panel] or through this "Reported users" section. + +Anyone can propose a moderation in Decidim, through the "Flag" icon in the participant +profile. After a participant has clicked in this action she needs to provide a +reason why she's making this report: + +* Contains clickbait, advertising, scams or script bots. +* Contains racism, sexism, slurs, personal attacks, death threats, suicide requests +or any form of hate speech. +* Contains illegal activity, suicide threats, personal information, or something +else you think doesn't belong on Demo. +* Other (and add it) + +image:reported_participant_modal.png[Give reason for reporting a participant modal] +image:reported_participant_flag.png[Flag in sidebar profile] + +After clicking in this option you'll need to provide a justification why you're +blocking this participant: + +image:participants_block_user_justification.png[Justificate the blocked user action] + +Once a blocked participant tries to log-in she'll see an error message: + +image:participants_block_user_alert.png[Message shown to blocked user] + +After a participant was blocked its name is changed to "Blocked user". \ No newline at end of file From af03bfa68338665ac8a50b138ac7ee2d4adb5065 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:56 +0200 Subject: [PATCH 254/336] New translations verifications_conflicts.adoc (German) --- .../participants/verifications_conflicts.adoc | 38 +++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 docs/de/modules/admin/pages/participants/verifications_conflicts.adoc diff --git a/docs/de/modules/admin/pages/participants/verifications_conflicts.adoc b/docs/de/modules/admin/pages/participants/verifications_conflicts.adoc new file mode 100644 index 0000000000..1e14b977f6 --- /dev/null +++ b/docs/de/modules/admin/pages/participants/verifications_conflicts.adoc @@ -0,0 +1,38 @@ += Verification's conflicts + +There are cases depending on which kind of verifications you've enabled that there could be verification's conflicts. + +For instance: + +. A participant get xref:admin:participants/impersonations.adoc[impersonated], and she doesn't provide an email +. Then she creates an account and tries to verify herself with the Census verification + +For security, we try to be extra cautious in these cases, and we want that an administrator reviews these verifications. +As you can see, this depends a lot on which kind of verifications you've enabled in your organization, so it's easy to say +that most of the time an organization will not see any conflicts in this panel. + +image:verifications_conflicts.png[Verification's conflicts panel] + +== Transfer user + +An administrator can review these conflicts by clicking in the Transfer user image:action_transfer_user.png[Transfer user] icon. + +Then she'll see the Transfer user form, where she can provide a reason for the transfer. + +image:verifications_conflicts_transfer_user.png[] + + +.Transfer user form +|=== +|Field |Type |Description + +|Reason +|Required +|Why you want to transfer the user + +|Email +|Required +|The email of the user to transfer +|=== + +After the user is transferred, both accounts (the original and the new one) will be merged. \ No newline at end of file From 2ba67cf5de2b419cbff6e9e88c4a53d637ad244f Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:57 +0200 Subject: [PATCH 255/336] New translations scopes.adoc (German) --- docs/de/modules/admin/pages/scopes.adoc | 105 ++++++++++++++++++++++++ 1 file changed, 105 insertions(+) create mode 100644 docs/de/modules/admin/pages/scopes.adoc diff --git a/docs/de/modules/admin/pages/scopes.adoc b/docs/de/modules/admin/pages/scopes.adoc new file mode 100644 index 0000000000..aa902449fd --- /dev/null +++ b/docs/de/modules/admin/pages/scopes.adoc @@ -0,0 +1,105 @@ += Scopes + +Scopes are the set of territories or subjects that an Organization has. A scope may have child scopes. + +For instance, in the case of the city of Barcelona the scopes are its districts, and the children of a district are its neighborhoods. They can also have types, so it can be configured, for example, by thematic and also territorial scopes. + +Most of the components and spaces in Decidim allow you to configure Scopes in one way or another. There are mainly three ways of using Scopes: + +To configure Scope on the Decidim platform, go to menu:Settings[Scopes] in the admin sidebar menu. A list will appear with the existing scopes if there are any: + +image:scopes_list.png[Scopes list] + +If you need so, you need to first configure the Scope type. + +== Form + +image:scopes_types_new_form.png[New scope type form] + + +.Admin New Scope Type form +|=== +|Field |Type |Description + +|Singular +|Required +|Name of the scope type in singular. + +|Plural +|Required +|Name of the scope type in plural. +|=== + +image:scopes_new_form.png[New scope form] + + +.Admin New Scope Form +|=== +|Field |Type |Description + +|Name +|Required +|Name of the scope. + +|Code +|Required +|(Internal) name of the scope. + +|Scope type +|Required +|Which type of scope it's. +|=== + +== Actions + +You have 3 possible actions in this list after a Scope is created: + +|=== +|Icon |Name |Definition + +|image:action_browse.png[Browse icon] +|Browse +|See and configure the children scopes for this Scope. + +|image:action_edit.png[Edit icon] +|Edit +|Edit form for a Scope. It's the same form as "Create a new scope". + +|image:action_delete.png[Delete icon] +|Delete +|To delete this scope. +|=== + +== Funktionen + +The main features related with scopes are: + +. Filtering +. User interests and Newsletters + +=== Filtering + +For filtering. Most of the spaces and components allows an administrator or a participant to associate them to a scope. This allows to filter by scopes when exploring them. + +image:scopes_filter_initiatives.png[Initiatives scopes filtering] + +image:scopes_filter_processes.png[Processes scopes filtering] + +Some examples: + +* With Accountability module, so it's possible to filter Results +* Assemblies and Processes can have Scopes. It's used for filtering multiple assemblies in the main listing page (/assemblies or /processes). These can be hidden by unchecking the "Enable participatory space filters" in the xref:admin:configuration.adoc[admin's configuration page]. +* Filtering in the sidebar is possible in Budgets Projects, Initiatives and Proposals. In some of these components you can control if these filters are shown with the "Scopes enabled" checkbox in the component settings. This will also enable or disable the scope selector in the resource creation form. + +You can also configure a participatory space so the filtering will only concern one scope and its children scopes. For example, let's imagine your organization have 3 different scopes for 3 cities, each of them having children scopes for the cities neighbourhoods. +On a participatory space which concerns only one of the cities, you will be able to select only this scope and its children so that users do not see the scopes of other cities in the filter options. + +=== User interests and Newsletters + +A Participant can choose which Scopes she wants to follow in its account. + +image:account_my_interests.png[Account: my interests] + +This is used by the xref:admin:newsletters.adoc[Newsletters], in the "Select recipients to deliver" step, "Filter for users having activated any selected scope in their account's My Interests settings." section. + +image:newsletter_select_recipients.png[Newsletter: select recipients] \ No newline at end of file From d02c94718ae3685f0b1c7da8c732998a87ec116e Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:00:59 +0200 Subject: [PATCH 256/336] New translations spaces.adoc (German) --- docs/de/modules/admin/pages/spaces.adoc | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces.adoc diff --git a/docs/de/modules/admin/pages/spaces.adoc b/docs/de/modules/admin/pages/spaces.adoc new file mode 100644 index 0000000000..6e3fcfab76 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces.adoc @@ -0,0 +1,12 @@ += Spaces + +The participatory spaces are the channels that citizens can participate through when public decisions are being taken. By default +the platform is provided with participatory processes, initiatives, consultations, conferences, votings and assemblies, but +any organization can develop its own mechanisms through xref:develop:modules.adoc[Modules]. + +They are accessible through the main sidebar in the administration panel, and also through the main navigation menu in the +public interface. + +image:spaces_admin.png[Spaces in admin sidebar] + +image:spaces_visitor.png[Spaces visible in the public interface] \ No newline at end of file From 5d2f40d2c6b81c60c6d6c1e73e465f699b6fb63c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:00 +0200 Subject: [PATCH 257/336] New translations assemblies.adoc (German) --- .../admin/pages/spaces/assemblies.adoc | 308 ++++++++++++++++++ 1 file changed, 308 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces/assemblies.adoc diff --git a/docs/de/modules/admin/pages/spaces/assemblies.adoc b/docs/de/modules/admin/pages/spaces/assemblies.adoc new file mode 100644 index 0000000000..b660cc8154 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/assemblies.adoc @@ -0,0 +1,308 @@ += Assemblies + +An assembly is a group of members of an organization who meet periodically to make decisions about a specific area or +scope of the organization. + +Assemblies hold meetings, some are private and some are open. If they are open, it is possible to participate in them +(for example: attending if the capacity allows it, adding points to the agenda, or commenting on the proposals and decisions taken by this organ). + +Examples: A general assembly (which meets once a year to define the organisation's main lines of action as well as its +executive bodies by vote), an equality advisory council (which meets every two months to make proposals on how to improve +gender relations in the organisation), an evaluation commission (which meets every month to monitor a process) or a guarantee +body (which collects incidents, abuses or proposals to improve decision-making procedures) are all examples of assemblies. + +The main difference between xref:admin:spaces/processes.adoc[participatory processes] and assemblies is that assemblies don't +have phases, meaning that they don't have timelines. + +You can see a real world usage of assemblies in https://www.decidim.barcelona/assemblies[Decidim Barcelona], where you +can see the different Participation Organs, that are the regular spaces where the City Council meets with citizens and organizations +to get feedback. + +In this section, we'll explain how we can configure an Assembly in Decidim. + +== List + +To configure assemblies on the Decidim platform, click on btn:[Assemblies] in the admin sidebar menu. A list +will appear with the existing assemblies if there are any: + +image:assemblies_list.png[Assemblies list] + +You can filter by the ones that are: + +* Published / Unpublished +* Public / Private + +image:assemblies_list_filter.png[Assemblies list filtered] + +You can also search by title and control how many elements are in the list. + +You have 4 possible actions in this list after an Assembly is created: + +. Export: send by email the configuration for a given assembly. Can be imported in other Decidim installation. +. Duplicate: to duplicate this assembly. +. Configure: to edit the metadata and configuration for a assembly. +. Assemblies: to manage all the children assemblies for a assembly. +. Preview: how it will look once published. + +== New assembly form + +image:assemblies_new_form.png[New assembly form] + + +.New assembly form: General information +|=== +|Field |Type |Description + +|Title +|Required +|Title of the assembly. For instance, "General Committee". + +|Subtitle +|Required +|Subtitle. For instance, "Let's decide our priorities together" + +|Order position +|Required +|Which order will it have in relation with the other assemblies. Having a lower number means a higher priority. For instance, +if you have two assemblies, "Assembly a" with weight "10" and "Assembly b" with weight "0", then "Assembly b" will be first when ordering. + +|URL slug +|Required +|URL slugs are used to generate the URLs that point to this assembly. Only accepts letters, numbers and dashes, and must +start with a letter. Example: if your domain is 'example.org' and your slug 'general-committee' then your URL will +be https://example.org/assemblies/general-committee + +|Hashtag +|Optional +|Hashtag for Twitter + +|Short description +|Required +|A short explanation of what's your participatory process about. + +|Description +|Required +|A long explanation of what's your assembly about. + +|Purpose of action +|Optional +|Internal field that doesn't get shown publicly. To be removed in a future version. + +|Composition +|Optional +|Internal field that doesn't get shown publicly. To be removed in a future version. + +|Internal organisation +|Optional +|Internal field that doesn't get shown publicly. To be removed in a future version. + +|Announcement +|Optional +|The text you enter here will be shown to the user right below the assembly information. +|=== + + +.New assembly form: Duration +|=== +|Field |Type |Description + +|Date created +|Optional +|Information that's displayed in the assembly metadata sidebar. Expected format: dd/mm/yyyy + +|Included at +|Optional +|Information that's displayed in the assembly metadata sidebar. The date when this assembly was added to Decidim. It does +not necessarily have to be the same as the creation date. Expected format: dd/mm/yyyy + +|Duration +|Optional +|Information that's displayed in the assembly metadata sidebar. If the duration of this assembly is limited, select the +end date. Otherwise, it will appear as indefinite. Expected format: dd/mm/yyyy + +|Closing date +|Optional +|Information that's displayed in the assembly metadata sidebar. When this assembly closed. Expected format: dd/mm/yyyy + +|Closing date reason +|Optional +|Information that's displayed in the assembly metadata sidebar. Why this assembly closed. +|=== + + +.New assembly form: Images +|=== +|Field |Type |Description + +|Home image +|Optional +|Image that will be used in presentation cards of this assembly. Guidance for file: Has to be an image or a document. +For images, use preferably landscape images that does not have any text, the service crops the image. Maximum file size: 10MB +Allowed file extensions: jpeg jpg png + +|Banner image +|Optional +|Image that will be used inside of the assembly. Guidance for file: Has to be an image or a document. +For images, use preferably landscape images that does not have any text, the service crops the image. Maximum file size: 10MB +Allowed file extensions: jpeg jpg png +|=== + + +.New assembly form: Filters +|=== +|Field |Type |Description + +|Scopes enabled +|Optional +|Check if you want to have Scopes filtering in this assembly. + +|Scope +|Optional +|Which xref:admin:scopes.adoc[Scope] does this assembly belongs to. + +|Area +|Optional +|Which xref:admin:areas.adoc[Area] does this assembly belongs to. +|=== + + +.New assembly form: Metadata +|=== +|Field |Type |Description + +|What is decided +|Optional +|Information that's displayed in the assembly metadata sidebar. + +|How is it decided +|Optional +|Information that's displayed in the assembly metadata sidebar. + +|Scope metadata +|Optional +|Information that's displayed in the assembly metadata sidebar. + +|Promoter group +|Optional +|Information that's displayed in the assembly metadata sidebar. + +|Organization area +|Optional +|Information that's displayed in the assembly metadata sidebar. + +|Who participates +|Optional +|Information that's displayed in the assembly metadata sidebar. +|=== + + +.New assembly form: Visibility +|=== +|Field |Type |Description + +|Parent assembly +|Optional +|What is the assembly that this assembly belongs to. For instance in Metadecidim, the https://meta.decidim.org/assemblies/coordination-committee[Coordination Committee] +has the parent assembly of the https://meta.decidim.org/assemblies/general-assembly-association[General%20Assembly%20of%20the%20Decidim%20Association]. + +|Highlighted +|Optional +|Check if you want the assembly to have more visibility in the Assemblies public list. It'll also be visible in the +Assembly Content Block in the xref:admin:homepage.adoc[Homepage] configuration. + +|Private space +|Optional +|Check if this assembly should only be accessible by xref:admin:spaces/assemblies/private_participants.adoc[Private Participants] + +|Is transparent +|Optional +|Check if this assembly is private but should be visible to all the rest of participants. This means that other participants +or visitors will see it but they won't be able to interact with it. +|=== + + +.New assembly form: Other +|=== +|Field |Type |Description + +|Created by +|Optional +|Choose one of "City Council", "Public" or "Other". If it's Other, you can specify the name of the organization that created +this assembly. + +|Assembly type +|Optional +|Which xref:_assemblies_types[assembly type] is this assembly. + +|Related processes +|Optional +|Select other participatory processes that are related to this assembly. + +|Social +|Optional +|Which social networks profile does this assembly has. Can be Twitter, Facebook, Instagram, YouTube and/or GitHub. It's +displayed in the assembly metadata sidebar. + +|Show statistics +|Optional +|Check if you want to show the Statistics section. +|=== + +After you've initially created your assembly you have a submenu where you need to keep configuring more information +about your assembly. + +image:assembly_submenu.png[Assembly submenu in admin] + +Here you can keep configuring your process: + +. Info: the same form that we explained in this page. +. xref:admin:spaces/assemblies/components.adoc[Components] +. xref:admin:spaces/assemblies/categories.adoc[Categories] +. xref:admin:spaces/assemblies/attachments.adoc[Attachments] +. xref:admin:spaces/assemblies/members.adoc[Members] +. xref:admin:spaces/assemblies/admins.adoc[Assembly admins] +. xref:admin:spaces/assemblies/private_participants.adoc[Private participants] +. xref:admin:spaces/assemblies/moderations.adoc[Moderations] + +== Assemblies types + +For clasyfing the assemblies in different kinds, you can define Assembly types. These types can be filtered in the public +assemblies page. + +image:assemblies_type_filters.png[Filter by assembly type] + +image:assemblies_new_type_form.png[New assembly type form] + + +.New assembly type form +|=== +|Field |Type |Description + +|Title +|Required +|Title of the this assembly type. For instance, "Consultative". +|=== + +== Einstellungen + +At the moment there's only a setting for configuring the general behaviour of assemblies. + +image:assemblies_settings.png[Assemblies settings] + + +.Settings for assemblies form +|=== +|Field |Type |Description + +|Enable organization chart +|Checkbox +|Whether you want to show the organization chart in the assemblies list. +|=== + +The organization chart is shown in the bottotm of the assemblies page. + +image:assemblies_organization_chart.png[Assemblies organization chart] + +It allows a navigation in the assemblies tree, with the possibility to see the sub-assemblies that belongs to a parent assembly. + +image:assemblies_organization_chart_filtered.png[Assemblies organization chart filtered] \ No newline at end of file From 58cdea1be56156b7b4339ebbbcfbd6bdd2698397 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:01 +0200 Subject: [PATCH 258/336] New translations admins.adoc (German) --- docs/de/modules/admin/pages/spaces/assemblies/admins.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/de/modules/admin/pages/spaces/assemblies/admins.adoc diff --git a/docs/de/modules/admin/pages/spaces/assemblies/admins.adoc b/docs/de/modules/admin/pages/spaces/assemblies/admins.adoc new file mode 100644 index 0000000000..59313271ef --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/assemblies/admins.adoc @@ -0,0 +1 @@ +include::partial$page_admins.adoc[] \ No newline at end of file From deb39c95bed3a143f0112888d96ef35137a9ad20 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:02 +0200 Subject: [PATCH 259/336] New translations attachments.adoc (German) --- docs/de/modules/admin/pages/spaces/assemblies/attachments.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/de/modules/admin/pages/spaces/assemblies/attachments.adoc diff --git a/docs/de/modules/admin/pages/spaces/assemblies/attachments.adoc b/docs/de/modules/admin/pages/spaces/assemblies/attachments.adoc new file mode 100644 index 0000000000..493f7dc8c8 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/assemblies/attachments.adoc @@ -0,0 +1 @@ +include::partial$page_attachments.adoc[] \ No newline at end of file From 27795446f93c18a095d60ac4ae200bb40ecf794a Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:03 +0200 Subject: [PATCH 260/336] New translations categories.adoc (German) --- docs/de/modules/admin/pages/spaces/assemblies/categories.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/de/modules/admin/pages/spaces/assemblies/categories.adoc diff --git a/docs/de/modules/admin/pages/spaces/assemblies/categories.adoc b/docs/de/modules/admin/pages/spaces/assemblies/categories.adoc new file mode 100644 index 0000000000..3ee4fc09cc --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/assemblies/categories.adoc @@ -0,0 +1 @@ +include::partial$page_categories.adoc[] \ No newline at end of file From ade8de0bb9ff757029815dc12e426dbb61bef7b7 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:04 +0200 Subject: [PATCH 261/336] New translations components.adoc (German) --- docs/de/modules/admin/pages/spaces/assemblies/components.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/de/modules/admin/pages/spaces/assemblies/components.adoc diff --git a/docs/de/modules/admin/pages/spaces/assemblies/components.adoc b/docs/de/modules/admin/pages/spaces/assemblies/components.adoc new file mode 100644 index 0000000000..7a204dda0b --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/assemblies/components.adoc @@ -0,0 +1 @@ +include::partial$page_components.adoc[] \ No newline at end of file From c1a379f4bc7153e2bd0b3c21ea43335221186e26 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:05 +0200 Subject: [PATCH 262/336] New translations members.adoc (German) --- .../pages/spaces/assemblies/members.adoc | 72 +++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces/assemblies/members.adoc diff --git a/docs/de/modules/admin/pages/spaces/assemblies/members.adoc b/docs/de/modules/admin/pages/spaces/assemblies/members.adoc new file mode 100644 index 0000000000..64a7159a8f --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/assemblies/members.adoc @@ -0,0 +1,72 @@ += Assembly members + +Assembly members allow showing all the people or groups that belong to a given assembly. It's useful for being transparent. + +You can see an example in https://meta.decidim.org/assemblies/coordination-committee/members[Decidim Coordination Commitee Assembly in Metadecidim]. + +image:assembly_members.png[Assembly members of the Coordination Committee] + +== New assembly member form + +image:assembly_members_list.png[Assembly members admin list] + +For creating a new phase of a participatory process: + +. Sign in as administrator +. Go to the assemblies section in the sidebar +. Click on the assembly Edit action +. Click on the Members link in the sidebar +. Click on the "New member" button +. Fill the form + +image:assembly_members_new_form.png[Assembly members new form] + + +.New assembly member form +|=== +|Field |Type |Description + +|Participant type +|Required +|Wheter this assembly member is non-participant or existing participant. Does she already have an account created on the platform? + +|Full name +|Required if it's non-participant. +| + +|User or group +|Required if it's an existing participant. +|Type at least three characters to search. + +|Position +|Required +|Choose one of President, Vice president, Secretary, or Other. In case it's other, you can fill in the position title. + +|Weight +|Optional +|Which order will it have in relation to the other members. Having a lower number means a higher priority. For instance, if you have two members, "Member a" with weight "10" and "Member b" with weight "0", then "Member b" will be first when ordering. + +|Designation date +|Required +|When was this person or group assigned as a member of this assembly. Expected format: dd/mm/yyyy + +|Designation mode +|Optional +|How was this person designed. + +|Ceased date +|Optional +|When was this person or group ceased to be a member of this assembly. Expected format: dd/mm/yyyy + +|Gender +|Optional +|Which gender does this person most identify with. + +|Birthday +|Optional +|When was this person born. Expected format: dd/mm/yyyy + +|Birthplace +|Optional +|Where was this person born. +|=== \ No newline at end of file From 19473282fb3125eee671588c18d3ba0822a9a320 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:06 +0200 Subject: [PATCH 263/336] New translations moderations.adoc (German) --- docs/de/modules/admin/pages/spaces/assemblies/moderations.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/de/modules/admin/pages/spaces/assemblies/moderations.adoc diff --git a/docs/de/modules/admin/pages/spaces/assemblies/moderations.adoc b/docs/de/modules/admin/pages/spaces/assemblies/moderations.adoc new file mode 100644 index 0000000000..12d6ac0858 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/assemblies/moderations.adoc @@ -0,0 +1 @@ +include::partial$page_moderations.adoc[] \ No newline at end of file From 52dd6f10e5346b49ded088038d31dfaf22d59cc3 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:07 +0200 Subject: [PATCH 264/336] New translations private_participants.adoc (German) --- .../admin/pages/spaces/assemblies/private_participants.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/de/modules/admin/pages/spaces/assemblies/private_participants.adoc diff --git a/docs/de/modules/admin/pages/spaces/assemblies/private_participants.adoc b/docs/de/modules/admin/pages/spaces/assemblies/private_participants.adoc new file mode 100644 index 0000000000..16c939dfa3 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/assemblies/private_participants.adoc @@ -0,0 +1 @@ +include::partial$page_private_participants.adoc[] \ No newline at end of file From 516c0edbb4624c84c087ef136d8bef98db473ccc Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:08 +0200 Subject: [PATCH 265/336] New translations conferences.adoc (German) --- .../admin/pages/spaces/conferences.adoc | 169 ++++++++++++++++++ 1 file changed, 169 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces/conferences.adoc diff --git a/docs/de/modules/admin/pages/spaces/conferences.adoc b/docs/de/modules/admin/pages/spaces/conferences.adoc new file mode 100644 index 0000000000..405be42fa8 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/conferences.adoc @@ -0,0 +1,169 @@ += Conferences + +A conference is a collection of meetings arranged in a program, with a number of people invited as speakers, and other +information fields typical of large congresses or social events (registration, list of organizations that support or sponsor the +event, etc.). A conference can be a relevant event for an organization and its members, or take place as part of a participatory +process or follow a consultation. + +Examples: + +* A general assembly for an organization +* The annual meeting of a cooperative + +As a real world example you can see the anual Metadecidim conferences: + +image:spaces/conferences/example01.png[Decidim Fest 2020] + +* https://meta.decidim.org/conferences/decidimfest19[Decidim Fest 2019] +* https://meta.decidim.org/conferences/decidimfest2020[Decidim Fest 2020] +* https://meta.decidim.org/conferences/DecidimFest21[Decidim Fest 2021] + +== Create a new conference + +For adding a new conference, you need to: + +image:spaces/conferences/menu.png[Conferences menu] + +. Sign in as admin +. Go to admin panel +. In the main sidebar, click in the button "Conferences" +. Click in the button "Create a new conference" +. Configure the conference by filling the form + +image:spaces/conferences/new_conference.png[Create a new conference form] + + +.Create a new conference +|=== +|Field |Type |Description + +|Title +|Required +|What is the title of this conference. For instance "Decidim Fest 2021" + +|Slogan +|Required +|A subtitle for this conference. For instance, "Democracy, Technology and Global Justice" + +|URL slug +|Required +|URL slugs are used to generate the URLs that point to this conference. Only accepts letters, numbers, and dashes, and +must start with a letter. Example: if your domain is 'example.org' and your slug 'DecidimFest21' then your URL will be +https://example.org/conferences/DecidimFest21 + +|Hashtag +|Optional +|Hashtag for Twitter + +|Highlighted +|Optional +|Should this conference be more prominent than others? For instance, is this an ongoing or a conference that has happened years ago? + +|Short description +|Required +|A short explanation of what's your conference about. + +|Description +|Required +|A long explanation of what's your conference about. + +|Objectives +|Optional +|What are the objectives or goals for this conference? + +|Location +|Optional +|Where will this conference take place? + +|Home image +|Optional +|Preferrably a landscape image that does not have any text. The service crops +the image. Maximum file size: 10MB. Allowed file extensions: jpeg jpg png + +|Banner image +|Optional +|Preferrably a landscape image that does not have any text. The service crops +the image. Maximum file size: 10MB. Allowed file extensions: jpeg jpg png + +|Scopes enabled +|Optional +|Check if you want to have Scopes filtering in this conference + +|Scope +|Optional +|Which xref:admin:scopes.adoc[Scope] does this conference belongs to. + +|Show statistics +|Optional +|Check if you want to show the Statistics section. + +|Start date +|Required +|When will this conference start. Expected format: dd/mm/yyyy + +|End date +|Required +|When will this conference end. Expected format: dd/mm/yyyy + +|Registrations enabled +|Optional +|Check if you want to handle registrations on the platform. + +|Available slots +|Optional +|Leave it to 0 if you have unlimited slots available. + +|Registration terms +|Required if "Registrations enabled" is checked +|What are the terms of service or conditions that a participant must accept for registering in this conference? + +|Related participatory processes +|Optional +|Select the processes that are related to this conference. Use the *ctrl* function to select more than one option. + +|Related Assemblies +|Optional +|Select the assemblies that are related to this conference. Use the *ctrl* function to select more than one option. + +|Related Consultations +|Optional +|Select the consultations that are related to this conference. Use the *ctrl* function to select more than one option. +|=== + +== Creating the program + +For creating the program of the conference you need to create a new xref:components/meetings.adoc[Meeting component] with the +dates and times of the different talks, workshops, sessions, etc. After publishing the meetings, it will be visible in the landing page +and there'll be a special navigation for these meetings so they're ordered by date and time. + +image:spaces/conferences/program_frontend.png[Conferences program (frontend)] + +image:spaces/conferences/program_backend.png[Conferences program (backend)] + +Also if you they are "In person" meetings with a location then you'll have a list of the venues. + +image:spaces/conferences/program_venues_frontend.png[Conferences venues (frontend)] + +== Menu + +image:spaces/conferences/manage_conferences.png[Conferences list at admin panel] + +After you’ve initially created your conference you have a submenu where you need +to keep configuring more information about it. + +image:spaces/conferences/sidebar.png[Conferences sidebar] + +. Info: the same form that we explained in this page. +. xref:admin:spaces/conferences/components.adoc[Components] +. xref:admin:spaces/conferences/categories.adoc[Categories] +. xref:admin:spaces/conferences/attachments.adoc[Attachments] +. xref:admin:spaces/conferences/media_links.adoc[Media Links] +. xref:admin:spaces/conferences/partners.adoc[Partners] +. xref:admin:spaces/conferences/speakers.adoc[Speakers] +. xref:admin:spaces/conferences/registrations.adoc[Registrations] +.. xref:admin:spaces/conferences/registrations/types.adoc[Registration Types] +.. xref:admin:spaces/conferences/registrations/users.adoc[User Registrations] +.. xref:admin:spaces/conferences/registrations/invites.adoc[Invites] +.. xref:admin:spaces/conferences/registrations/certificates.adoc[Certificate of Attendance] +. xref:admin:spaces/conferences/admins.adoc[Conference admins] +. xref:admin:spaces/conferences/moderations.adoc[Moderations] \ No newline at end of file From a4333b487cd4b2e0174588782628729cbeb4d1c7 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:09 +0200 Subject: [PATCH 266/336] New translations admins.adoc (German) --- docs/de/modules/admin/pages/spaces/conferences/admins.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/de/modules/admin/pages/spaces/conferences/admins.adoc diff --git a/docs/de/modules/admin/pages/spaces/conferences/admins.adoc b/docs/de/modules/admin/pages/spaces/conferences/admins.adoc new file mode 100644 index 0000000000..59313271ef --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/conferences/admins.adoc @@ -0,0 +1 @@ +include::partial$page_admins.adoc[] \ No newline at end of file From 62f7e3cd65b0b797927789f3660e31d485413fdf Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:10 +0200 Subject: [PATCH 267/336] New translations attachments.adoc (German) --- .../pages/spaces/conferences/attachments.adoc | 81 +++++++++++++++++++ 1 file changed, 81 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces/conferences/attachments.adoc diff --git a/docs/de/modules/admin/pages/spaces/conferences/attachments.adoc b/docs/de/modules/admin/pages/spaces/conferences/attachments.adoc new file mode 100644 index 0000000000..d36f3e32d1 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/conferences/attachments.adoc @@ -0,0 +1,81 @@ += Attachments + +Attachments allow an administrator to upload static files to a conference. + +When a conference is launched, it is important to provide citizens with as much information as possible about them so +that they can participate with knowledge. That is why it is helpful to add files (Attachments) with the information that +is considered relevant. + +Optionally, these documents can be grouped in *Folders*. + +They can be found on the Conference "Media and links" section: + +image:spaces/conferences/attachments.png[Conferences attachments (backend)] + +image:spaces/conferences/media_links_frontend.png[Conferences attachments (frontend)] + +Read more about this in xref:admin:spaces/conferences/media_links.adoc[Media links]. + +== Create a new attachment + +image:spaces/attachments_admin.png[View the attachments of a conference in the admin interface] + +For creating a new phase of a conference: + +. Sign in as administrator +. Go to the conference section in the sidebar +. Click on the conference Edit action +. Click on the Attachments link in the sidebar +. Click on the "New attachment" button + +image:spaces/attachments_new_form.png[Create a new attachment form] + + +.Create attachment +|=== +|Field |Type |Description + +|Attachment or image name +|Required +|What is the title for this attachment. + +|Weight +|Optional +|Which order will it have in relation to the other attachments. Having a lower number means a higher priority. For instance, if you have two categories, "Attachment a" with weight "10" and "Attachment b" with weight "0", then "Attachment b" will be first when ordering. + +|Description +|Required +|A long description explaining what this file is about. + +|Folder +|Optional +|Which folder this attachment belongs to. + +|File +|Required +|Upload the file. Guidance for file: Has to be an image or a document. For images, use preferrably landscape images, the +service crops the image. For CSV files, the separator between columns must be a comma (","). Maximum file size: 10MB. Allowed +file extensions depends in your server configuration. +|=== + +== Create a new folder + +image:spaces/attachments_new_folder_form.png[Create a new folder for attachments form] + + +.Create folder +|=== +|Field |Type |Description + +|Name +|Required +|Name of the folder + +|Weight +|Optional +|Which order will it have in relation to the other folders. Having a lower number means a higher priority. For instance, if you have two folders, "Folder a" with weight "10" and "Folder b" with weight "0", then "Folder b" will be first when ordering. + +|Description +|Required +|A long description explaining what this folder is about. +|=== \ No newline at end of file From ae830d925a3a60c6af40739211e5310d24821e85 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:11 +0200 Subject: [PATCH 268/336] New translations categories.adoc (German) --- docs/de/modules/admin/pages/spaces/conferences/categories.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/de/modules/admin/pages/spaces/conferences/categories.adoc diff --git a/docs/de/modules/admin/pages/spaces/conferences/categories.adoc b/docs/de/modules/admin/pages/spaces/conferences/categories.adoc new file mode 100644 index 0000000000..3ee4fc09cc --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/conferences/categories.adoc @@ -0,0 +1 @@ +include::partial$page_categories.adoc[] \ No newline at end of file From 3cfd21d0c545a1ad067e20f608fa2d26ca94c407 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:12 +0200 Subject: [PATCH 269/336] New translations components.adoc (German) --- docs/de/modules/admin/pages/spaces/conferences/components.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/de/modules/admin/pages/spaces/conferences/components.adoc diff --git a/docs/de/modules/admin/pages/spaces/conferences/components.adoc b/docs/de/modules/admin/pages/spaces/conferences/components.adoc new file mode 100644 index 0000000000..7a204dda0b --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/conferences/components.adoc @@ -0,0 +1 @@ +include::partial$page_components.adoc[] \ No newline at end of file From fe3e127434678c0ce6b494eb0762778786bb6843 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:13 +0200 Subject: [PATCH 270/336] New translations media_links.adoc (German) --- .../pages/spaces/conferences/media_links.adoc | 45 +++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces/conferences/media_links.adoc diff --git a/docs/de/modules/admin/pages/spaces/conferences/media_links.adoc b/docs/de/modules/admin/pages/spaces/conferences/media_links.adoc new file mode 100644 index 0000000000..d39ad23e1d --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/conferences/media_links.adoc @@ -0,0 +1,45 @@ += Media links + +Conferences can have a section called "Media and links". It shows a list of media files and links that are associated to the conference. + +The media files are the files from the xref:admin:spaces/conferences/attachments.adoc[attachments] sections. +The media links are defined in a section in the admin panel of the conference. + +image:spaces/conferences/media_links_frontend.png[Conferences media links (frontend)] + +== Create a new media link + +image:spaces/conferences/media_links_backend.png[Conferences media links] + +For creating a new media link of a conference: + +. Sign in as administrator +. Go to the conferences section in the sidebar +. Click on the conference Edit action +. Click on the "Media links" link in the sidebar +. Click on the "New Media Link" button +. Fill the form + +image:spaces/conferences/new_media_link.png[Create a new conferences media link] + + +.New media link form +|=== +|Field |Type |Description + +|Title +|Required +|The title of the link + +|Link +|Required +|URL of the link + +|Date +|Required +|Published date of the link + +|Weight +|Optional +|Which order will it have in relation to the other links. Having a lower number means a higher priority. For instance, if you have two links, "Link a" with weight "10" and "Link b" with weight "0", then "Link b" will be first when ordering. +|=== \ No newline at end of file From 69164ea48a0518414c5684a8c05fabf4d93f8a66 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:14 +0200 Subject: [PATCH 271/336] New translations moderations.adoc (German) --- docs/de/modules/admin/pages/spaces/conferences/moderations.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/de/modules/admin/pages/spaces/conferences/moderations.adoc diff --git a/docs/de/modules/admin/pages/spaces/conferences/moderations.adoc b/docs/de/modules/admin/pages/spaces/conferences/moderations.adoc new file mode 100644 index 0000000000..12d6ac0858 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/conferences/moderations.adoc @@ -0,0 +1 @@ +include::partial$page_moderations.adoc[] \ No newline at end of file From 146dab10f9928de0161598f18922e9f8f3304e49 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:15 +0200 Subject: [PATCH 272/336] New translations partners.adoc (German) --- .../pages/spaces/conferences/partners.adoc | 47 +++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces/conferences/partners.adoc diff --git a/docs/de/modules/admin/pages/spaces/conferences/partners.adoc b/docs/de/modules/admin/pages/spaces/conferences/partners.adoc new file mode 100644 index 0000000000..e9d5fd13d6 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/conferences/partners.adoc @@ -0,0 +1,47 @@ += Partners + +The partners are the sponsors or supporters of a conference. They are listed on the Conference landing page. + +image:spaces/conferences/partners_frontend.png[Conferences partners (frontend)] + +== Create a new partner + +image:spaces/conferences/partners.png[Conferences partners] + +For creating a new partner of a conference: + +. Sign in as administrator +. Go to the conferences section in the sidebar +. Click on the conference Edit action +. Click on the Partners link in the sidebar +. Click on the "New partner" button +. Fill the form + +image:spaces/conferences/new_partner.png[Conferences partners form] + + +.New partner form +|=== +|Field |Type |Description + +|Name +|Required +|What is the name of this partner. + +|Partner type +|Required +|Choose one of these options: Main promotor or Collaborator + +|Weight +|Optional +|Which order will it have in relation to the other partners. Having a lower number means a higher priority. For instance, if you have two partners, "Partner a" with weight "10" and "Partner b" with weight "0", then "Partner b" will be first when ordering. + +|Link +| +| + +|Logo +|Required +|Guidance for image: Preferably a landscape image that does not have any text. The service crops the image. Maximum file size: 5MB +Allowed file extensions: jpg jpeg gif png bmp ico +|=== \ No newline at end of file From 5f8b804558ea2a7ffcfe1cc20925bb329e240c7d Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:16 +0200 Subject: [PATCH 273/336] New translations registrations.adoc (German) --- .../pages/spaces/conferences/registrations.adoc | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces/conferences/registrations.adoc diff --git a/docs/de/modules/admin/pages/spaces/conferences/registrations.adoc b/docs/de/modules/admin/pages/spaces/conferences/registrations.adoc new file mode 100644 index 0000000000..0aa2935425 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/conferences/registrations.adoc @@ -0,0 +1,12 @@ += Registrations + +As an administrator of a conference you can manage the registrations for the conference from the platform. + +For doing so, you have these admin sections: + +. xref:admin:spaces/conferences/registrations/types.adoc[**Registrations Types**] allows you to define which ways of registering participants +will have. For instance if there are a number of prices depending if the attendees are students or workers. +. xref:admin:spaces/conferences/registrations/users.adoc[**User Registrations**] allows you to confirm the requests for attending the conference. +. xref:admin:spaces/conferences/registrations/invites.adoc[**Invites**] allows you to invite participants to the conference. +. xref:admin:spaces/conferences/registrations/certificates.adoc[**Certificates of Attendance**] allows you to configure and send certificates +of attendance in PDF format to people that has gone to the conference. \ No newline at end of file From 033becbd1d5f8deee520c59f19416c0e0d52baad Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:17 +0200 Subject: [PATCH 274/336] New translations certificates.adoc (German) --- .../registrations/certificates.adoc | 39 +++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces/conferences/registrations/certificates.adoc diff --git a/docs/de/modules/admin/pages/spaces/conferences/registrations/certificates.adoc b/docs/de/modules/admin/pages/spaces/conferences/registrations/certificates.adoc new file mode 100644 index 0000000000..2e526c32a2 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/conferences/registrations/certificates.adoc @@ -0,0 +1,39 @@ += Certificates of Attendance + +Administrators can create Certificates of Attendance to participants. + +image:spaces/conferences/certificates_of_attendance.png[Conferences Certificate of Attendance (backend)] + + +.Certificate of Attendance form +|=== +|Field |Type |Description + +|Main logo +|Required +|Logo of the conference of the organization that makes the certificate of attendance. + +|Signature +|Required +|Image of the person that signs the certificate. + +|Sign date +|Required +|Date of the signature. Expected format: dd/mm/yyyy + +|Signature name +|Required +|Name of the person that signs the certificate. +|=== + +After the form is filled then there's a button to "Send certificates of attendance" to all the confirmed xref:admin:spaces/conferences/registrations/users.adoc[registrations] of the conference. + +image:spaces/conferences/certificates_of_attendance_button.png[Conferences Certificate of Attendance send button] + +Once it's sent it can't be resent. + +image:spaces/conferences/certificates_of_attendance_button_disabled.png[Conferences Certificate of Attendance send disabled button] + +The certificates of attendance are sent to the participants by email in PDF format. + +image:spaces/conferences/certificates_of_attendance_pdf.png[Conferences Certificate of Attendance (frontend)] \ No newline at end of file From 2fd8f6682e29e51f41ca1c4b80be8ae73d95fb97 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:18 +0200 Subject: [PATCH 275/336] New translations invites.adoc (German) --- .../conferences/registrations/invites.adoc | 38 +++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces/conferences/registrations/invites.adoc diff --git a/docs/de/modules/admin/pages/spaces/conferences/registrations/invites.adoc b/docs/de/modules/admin/pages/spaces/conferences/registrations/invites.adoc new file mode 100644 index 0000000000..bd02c5da95 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/conferences/registrations/invites.adoc @@ -0,0 +1,38 @@ += Invites + +Administrators can invite participants to join the conference. + +image:spaces/conferences/invites.png[Conferences user invites (backend)] + +== Flow + +. An administrator sends an invitation to join the conference to a non-existing or existing participant +. The participant accepts the invitation + +image:spaces/conferences/invite_participant_form.png[Invite a participant form] + + +.Invite participant form +|=== +|Field |Type |Description + +|Attendee type +|Required +|Wheter this invited person is a non-existing or existing participant. Does she already have an account created on the platform? + +|Name +|Required if it's a non-existing participant. +|Name of the invited person. + +|Email +|Required if it's a non-existing participant. +|Email of the invited person. + +|User +|Required if it's an existing participant. +|Type at least three characters to search. + +|xref:admin:spaces/conferences/registrations/types.adoc[Registration type] +|Required +|What xref:admin:spaces/conferences/registrations/types.adoc[registration type] does this participant will have. +|=== \ No newline at end of file From 1b529035af03b21df76c4edeaf460be2ddaf5e80 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:19 +0200 Subject: [PATCH 276/336] New translations types.adoc (German) --- .../conferences/registrations/types.adoc | 56 +++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces/conferences/registrations/types.adoc diff --git a/docs/de/modules/admin/pages/spaces/conferences/registrations/types.adoc b/docs/de/modules/admin/pages/spaces/conferences/registrations/types.adoc new file mode 100644 index 0000000000..1625887826 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/conferences/registrations/types.adoc @@ -0,0 +1,56 @@ += Registration types + +You can enable registrations in conferences, so it's easier to register to the whole conference, or by days, rather than +going meeting by meeting to enable registration for that particular event. + +After enabling registrations participants will have a button to register to the conference in the landing and the conference's header. + +image:spaces/conferences/registration_landing01.png[Registration button on landing page] + +image:spaces/conferences/registration_landing02.png[Registration button on landing page] + +If you want to enable registration you'll need to define and publish at least one registration type. + +image:spaces/conferences/registration_types_frontend_wo_user.png[Select registration type without a user account] + +== Create a new registration type + +For adding a new registration type, you need to: + +. Sign in as administrator +. Go to the conferences section in the sidebar +. Click on the conference Edit action +. Click on the "Registration types" link in the sidebar +. Click on the "New Registration type" button +. Fill the form +. Publish the registration type + +image:spaces/conferences/new_registration_type.png[Create a new registration type form] + +image:spaces/conferences/registration_types_backend.png[Manage registration types] + + +.Create a new registration type +|=== +|Field |Type |Description + +|Title +|Required +|What is the title of this registration type. + +|Weight +|Which order will it have in relation to the other types. Having a lower number means a higher priority. For instance, if you have two types, "Day 1" with weight "10" and "Day 2" with weight "0", then "Day 2" will be first when ordering. +|Description + +|Required +|Description for this registration type +|Price + +|Optional +|Define a price for this registration type. If you don't define a price, the price will be "Free". +|Select conference meetings +|=== + +If the participant is already logged in then she'll see her username and email in the registration page. + +image:spaces/conferences/registration_types_frontend_w_user.png[Select registration type with user account] \ No newline at end of file From 1fdd8925da1a893d8883b70fcb2265a50043d72e Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:20 +0200 Subject: [PATCH 277/336] New translations users.adoc (German) --- .../conferences/registrations/users.adoc | 27 +++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces/conferences/registrations/users.adoc diff --git a/docs/de/modules/admin/pages/spaces/conferences/registrations/users.adoc b/docs/de/modules/admin/pages/spaces/conferences/registrations/users.adoc new file mode 100644 index 0000000000..33dc8d6b46 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/conferences/registrations/users.adoc @@ -0,0 +1,27 @@ += User registrations + +After participants have registered, they will appear in this section. + +image:spaces/conferences/user_registrations.png[Conferences user registrations (backend)] + +As an administrator, you can: + +* Export the registrations +* Confirm a registration + +== Export + +It's possible to export the registrations in multiple formats: CSV, JSON, and XLSX (Excel). + +== Flow + +. A participant registers to the conference +. She receives a pending registration notification +image:spaces/conferences/user_registration_pending_notification.png[Notification for pending user registration] +. She receives a pending registration email +image:spaces/conferences/user_registration_pending_email.png[Email for pending user registration] +. An administrator reviews and confirms the registration with the image:action_check.png[Confirm] button +. The participant receives a confirmed registration notification +image:spaces/conferences/user_registration_confirmed_notification.png[Notification for confirmed user registration] +. She receives a confirmed registration email with an calendar file (.ICS). +image:spaces/conferences/user_registration_confirmed_email.png[Email for confirmed user registration] \ No newline at end of file From 00277829984ffa43586da7ceb2451ec20776f594 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:21 +0200 Subject: [PATCH 278/336] New translations speakers.adoc (German) --- .../pages/spaces/conferences/speakers.adoc | 68 +++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces/conferences/speakers.adoc diff --git a/docs/de/modules/admin/pages/spaces/conferences/speakers.adoc b/docs/de/modules/admin/pages/spaces/conferences/speakers.adoc new file mode 100644 index 0000000000..f62160a3e8 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/conferences/speakers.adoc @@ -0,0 +1,68 @@ += Speakers + +The speakers are people that are going to talk at the conference. + +image:spaces/conferences/speakers_frontend.png[Conferences speakers (frontend)] + +== Create a new speaker + +image:spaces/conferences/speakers.png[Conferences speakers] + +For creating a new speaker of a conference: + +. Sign in as administrator +. Go to the conferences section in the sidebar +. Click on the conference Edit action +. Click on the Speakers link in the sidebar +. Click on the "New Conference Speaker" button +. Fill the form + +image:spaces/conferences/new_speaker.png[Conferences speakers] + + +.New conference speaker form +|=== +|Field |Type |Description + +|Participant type +|Required +|Wheter this speaker is a non-participant or existing participant. Does she already have an account created on the platform? + +|Full name +|Required if it's non-participant. +|Name of the speaker. + +|User or group +|Required if it's an existing participant. +|Type at least three characters to search. + +|Related meetings +|Optional +|Which meetings does this speaker attend and participates actively? + +|Position +|Required +|Metadata for showing extra information about the speaker. + +|Affiliation +|Required +|Metadata for showing extra information about the speaker. + +|Short Bio +|Optional +|Metadata for showing extra information about the speaker. + +|Twitter handle +|Optional +|Metadata for showing extra information about the speaker. + +|Personal URL +|Optional +|Metadata for showing extra information about the speaker. + +|Avatar +|Optional +|Metadata for showing extra information about the speaker. + +Default image +|=== \ No newline at end of file From 3a8120acd52ed27bf8e7789fc705ad9644c007bf Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:23 +0200 Subject: [PATCH 279/336] New translations consultations.adoc (German) --- docs/de/modules/admin/pages/spaces/consultations.adoc | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces/consultations.adoc diff --git a/docs/de/modules/admin/pages/spaces/consultations.adoc b/docs/de/modules/admin/pages/spaces/consultations.adoc new file mode 100644 index 0000000000..452763a87f --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/consultations.adoc @@ -0,0 +1,3 @@ += Consultations + +include::partial$deprecated.adoc[] \ No newline at end of file From c6b91d71d5b20ef0d04ec9320c5af6cd98af0ab5 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:24 +0200 Subject: [PATCH 280/336] New translations initiatives.adoc (German) --- .../admin/pages/spaces/initiatives.adoc | 408 ++++++++++++++++++ 1 file changed, 408 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces/initiatives.adoc diff --git a/docs/de/modules/admin/pages/spaces/initiatives.adoc b/docs/de/modules/admin/pages/spaces/initiatives.adoc new file mode 100644 index 0000000000..46f1682500 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/initiatives.adoc @@ -0,0 +1,408 @@ += Initiatives + +An initiative is a special type of participatory process that can be promoted by anyone (independently of other channels or participation spaces) through the collection of (online and in-person) signatures for the organization to carry out a specific action (modify a regulation, initiate a project, change the name of a department or a street, etc.). + +The promoters of an initiative can define its objectives, gather support, debate, disseminate it and define meeting points where signatures can be collected from the attendees or debates open to other participants. + +Examples: An initiative can collect signatures to call for a consultation among all the people of an organization, or to create an assembly, or to call for a process of budget increase for a territory or area of the organization. During the process of collecting signatures, more people can add to this demand and carry it forward in the organization. + +Initiatives are to be distinguished from the other participation spaces because they can be used as a participatory tool or mechanism promoted by participants. In other words, the initiatives are mechanisms for semi-direct democracy through which participants can promote a certain action of common interest to the organization, by collecting a specific number of signatures. In this case, what the organization has to do is enable the promotion of these initiatives and offer the necessary technical support and advice to the people concerned. The role of the platform’s administrator, then, is somewhat different from that of the other participation spaces. + +In the first place, you will have to configure the various forms of initiatives. This could be specified in a regulation (like a municipal normative or state law), specifying the number of signatures required for processing the various types of initiatives. For example, an initiative for incorporating one or several items into the Municipal Council’s agenda evidently requires fewer signatures than another initiative for promoting a binding consultation. + +== 0. Initiative setup + +How initiatives work depends on two things: how the initiative module is configured through the xref:admin:initiatives_initializer.adoc[initializer] (in code) and how the initiative type is configured in the administration panel. + +Regarding initiatives type, **an administrator** needs to define one. For Initiatives to work on an organization there must be at least one initiative type created and configured with at least one initiative type scope. If there's only one type then the participant will not get the possibility to choose the initiative type, this step will be skipped in the initiative creation wizard. + +Some real examples from the city of Barcelona are: + +* To add an item to the Municipal Council or Districts agendas +* To perform a participatory process +* To create a new assembly +* To approve or modify a regulation +* To request the holding of a citizen consultation +* To call for assemblies (neighborhood councils or public audiences) + +=== New initiative type form + +image:admin_initiative_type.png[New initiative type form] + + +.Admin new initiative type form: General information +|=== +|Field |Type |Description + +|Title +|Required +|Title of the initiative type. For instance, "New park at city center". + +|Description +|Required +|Explanation of what can be done with this initiative type. + +|Banner image +|Required +|An image for this initiative type. NOTE: At the moment this is not used. +|=== + + +.Admin new initiative type form: Options +|=== +|Field |Type |Description + +|Signature type +|Optional +|Which kind of signature type will be allowed. Options are: Online, In-person and Mixed. The Mixed option allows a participant to choose which signature type will have the initiative. + +|Enable attachments +|Optional +|Whether it'll allow to upload attachments to initiatives. + +|Enable participants to undo their online signatures +|Optional +|Can a participant undo its signature when they already signed? + +|Enable authors to choose the end of the signature collection period +|Optional +|Can the authors of an initiative change the end of the signature collection period? + +|Enable authors to choose the area for their initiative +|Optional +|Can the authors choose the area of their initiative? + +|Enable child scope signatures +|Optional +|This config flag doesn't support offline votes, it enables sub-scopes and works with an authorization handler that associates a scope to the user, make sure you select that authorization, bellow in authorization settings. For it to work, scopes need to be configured in a hierarchical way : 1 Parent - N Child. + +|Only allow global scope initiatives creation +|Optional +|Tick this flag if you enabled "Child scope signature" and configured the global scope as your parent scope. By enabling this, scope selection will be skipped in the initiative creation wizard. + +|Enable promoting committee +|Optional +|Whether it will only allow individual initiatives (made by only one person) or allow collective initiatives (multiple promoters, being multiple individuals or a user group). + +|Minimum of committee members +|Optional +|When "Enable promoting committee" option is checked, defines the minimum number of promoter's committee member to send the initiative to technical validation + +|Collect participant personal data on signature +|Optional +|Adds a step to the signature process. When a participant clicks on the signature button, she'll be redirected to a form asking for some personal data. This will be used with the PDF export action after the recollection period has ended. + +|Legal information about the collection of personal data +|Depends on whether the option "Collect participant personal data on the signature" is checked +|Privacy notice and terms of use for the participant personal data during the signature process. +|=== + + +.Admin new initiative type form: Authorization settings +|=== +|Field |Type |Description + +|Authorization to verify document number on signatures +|Optional +|When a participant is making the signature process, will she be asked for an authorization? + +|Add SMS code validation step to the signature process +| +|During the signature process, will it ask for SMS validation? +|=== + +=== New initiative type scope form + +An initiative type can also have scopes associated. For Initiatives it needs at least one scope configured. + +image:admin_initiative_type_scope.png[New initiative type form] + + +.Admin new initiative type scope form +|=== +|Field |Type |Description + +|Scopes +|Required +|A Scope. An author can choose this scope in the creation of the initiative. + +|Signatures required +|Required +|Number of signatures the initiative need to have before the end period so it can be accepted. +|=== + +== 1. Create an initiative + +This action is done by **the author**. The author is a participant that creates the initiative. Depending on how the initiatives module is configured in the initializer or how the initiative type is configured, it may need to ask for authorization, or it will even not show the "New initiative" button. + +image:initiative_list.png[Initiatives list] + +For creating an initiative, a participant must click in the "New initiative" button. Then she'll have a wizard with multiple steps: + +=== 1.1 Choose the initiative type + +image:initiative_new_step1.png[Initiative creation: step 1] + +=== 1.2 Add title and description + +image:initiative_new_step2.png[Initiative creation: step 2] + +=== 1.3 [Optional] Similarity comparison + +Checks the rest of the initiatives if there are other similar initiatives. If there are, the system will show them before continuing. This is a way to avoid duplicates. + +=== 1.4 Finish + +image:initiative_new_step3.png[Initiative creation: step 3] + +image:initiative_new_step4.png[Initiative creation: step 4] + +=== Actions after it was created + +After the initiative was created, a participant can see the initiative page, but until the initiative is reviewed and accepted by an administrator, through the technical validation, it will not be published and visible for all the participants. + +image:initiative_show.png[Initiative show] + +In the sidebar a participant can make some actions: Edit, Print and Send to technical validation. + +image:initiative_actions.png[Initiative actions] + +==== Edit + +After the initiative was created and before it was sent to technical validation, **an author** can edit and correct the initiative if it has any error. + +image:initiative_edit.png[Initiative edit] + +==== Print + +An author can also print the initiative. + +image:initiative_print.png[Print an initiative] + +==== Technical validation + +After the author has reviewed how the initiative will look, she can send it to technical validation. + +image:initiative_send_to_technical_validation.png[Send initiative to technical validation] + +== 2. Send initiative to technical validation + +This action is done by **the author**. + +After it has been reviewed by the author, it can be sent to "Technical validation", but it depends in the configuration of the initiative type, in whether the options "Enable promoting committee" and "Minimum of committee members" are configured. + +=== Promoter's committee + +An initiative type can optionally be supported by a promoter's committee, with a minimum number of committee members. Once the user has created the initiative and before it can be sent for technical validation they need to invite committee members to promote it. + +When the user has created the initiative they will be given a link to share with possible committee members, which will look something like `/initiatives/.../committee_requests/new` + +When a prospective committee member opens the link, they can click a button which allows them to request to be part of the committee. The initiative author then needs to approve each request. The author can approve them by clicking on the "Edit" button of their initiative at the bottom of the form they can approve or reject committee members. + +image:initiative_commitee_members_send_to_technical_false.png[Initiative promotor committee: edit screen] + +The initiative cannot be sent to technical validation until it meets the minimum number of committee members required. You can find the invitation link in the edit form. + +image:initiative_edit_commitee_members.png[Initiative promotor committee: edit screen] + +Share the invitation link with the people you'd like to have on your committee. + +image:initiative_commitee_members_ask.png[Initiative promotor committee: edit screen] + +The people invited with the link will be able to read the initiative and ask to be part of the committee. + +image:initiative_commitee_members_sent.png[Initiative promotor committee: edit screen] + +The request is sent and the author can then and accept or refuse it in the initiative edit form. + +image:initiative_commitee_members_approve.png[Initiative promotor committee: edit screen] + +image:initiative_commitee_members_send_to_technical_true.png[Initiative promotor committee: edit screen] + +Once enough people have joined the promoter committee the initiative author can send it for +technical validation. + +== 3. Publish an initiative + +This action is done by **an administrator**. + +After the initiative was sent to technical validation by a participant, an administrator can view all the initiatives in the admin panel and make some corrections. + +image:initiative_admin_list.png[Admin initiatives list] + +=== Actions + +Regarding the actions in an initiative, an administrator can "Preview", "Edit", "Answer" or "Print" an initiative: + +image:initiative_admin_list_actions.png[Initiative admin list actions] + +|=== +|Icon |Name |Definition + +|image:action_preview.png[Preview icon] +|Preview +|To see how it's shown in the frontend to participants. + +|image:action_edit.png[Edit icon] +|Edit +|Edit form for Initiative. + +|image:action_answer.png[Answer icon] +|Answer +|Allows to answer an Initiative. + +|image:action_print.png[Print icon] +|Print +|Allows to print. +|=== + +=== Components + +Once an initiative has been created it gets the Meetings and Page component enabled by +default. The initiative author has no control over these - an admin will need to manage +them. All of the other usual components may be added by an admin too. + +image:initiative_admin_show.png[Admin initiative show page] + +There are also other features inside initiatives, like Attachments and Moderations for the comments. + +image:initiative_admin_sidebar.png[Admin initiative sidebar] + +=== Publish + +After the initiative was reviewed and technically approved by an admin, for instance for checking that what the initiative is asking is legal or abides to the normative (ie it's municipal competency), then it can be published: + +image:initiative_admin_actions.png[Admin initiative actions] + +== 4. Sign an initiative + +This action is done by **a participant**. + +After the initiative was published, it'll be visible in the initiatives listing page (/initiatives): + +image:initiative_list_published.png[Initiative list after it was published] + +image:initiative_admin_show_published.png[Admin initiative show after it was published] +image:initiative_show_published.png[Initiative show after it was published] + +And authorized participants can sign it: + +image:initiative_admin_show_published_detail.png[Admin initiative show after it was published (detail)] + +image:initiative_show_signed.png[Initiative show after it was signed] + +== 5. Export signatures + +This action is done by **an administrator**. After the initiative has started to get signatures, there's an option for exporting a PDF of the signatures: + +image:initiative_actions_export.png[Initiative actions with Export to PDF] + +image:initiative_actions_export_pdf.png[Initiative exported PDF] + +== 6. Answer an initiative + +After the initiative has collected all the signatures then it can be answered by an administrator. An initiative answer don't have different types. + +image:initiative_backend_answer.png[Initiative backend answer] + +image:initiative_frontend_answer.png[Initiative frontend answer] + +== Initiative statuses + +For better understanding all the status, this is a summary: + +|=== +|Status |Explanation + +|Created +|The initiative has been created but is not yet public for every visitor or the rest of the participants. + +|Technical validation +|The initiative needs to be reviewed by an administrator. From here, it can be "discarded" or "published" + +|Expired +|The initiative wasn't reviewed by an administrator and wasn't approved, and the maximum time for validation has passed. + +|Discarded +|The initiative was reviewed by an administrator and was discarded, so it's not published. + +|Published +|The initiative was reviewed by an administrator and was approved, so it's published. + +|Rejected +|The period for signature recollection has ended and there weren't enough signatures. + +|Accepted +|The period for signature recollection has ended and there were enough signatures. +|=== + +[plantuml] +@startuml +:Created; +:Technical validation; +if (has passed the maximum validation time?) then (yes) + #pink:Expired; + kill; +elseif (validated?) then (no) + #pink:Discarded; + kill; +else (yes) + #palegreen:Published; + if (enough signatures?) then (no) + #pink:Rejected + (not enough signatures); + kill; + else (yes) + #palegreen:Accepted + (enough signatures); + stop; + endif; +endif +@enduml + +Finally, these are all the relevant settings in every moment in the initiatives life cicle: + +[plantuml] +@startuml +(*) --> "Create a new initiative" +if "Has only one type?" then +--> [Yes] "Fill initiative form" +else +--> [No] "Select initiative type" +--> "Fill initiative form" +Endif +partition Created { + if "Is the User a UserGroup?" then + --> [Yes] "Send to Technical Validation" + else + --> [No] Collect the minimum number of committee members (2 by default) + --> "Send to Technical Validation" + Endif +} +partition Validating { + if "Has passed the maximum time for validation (60 days by default)?" then + --> [Yes] "Expired" + else + --> [No] if "Is accepted by an administrator?" then + --> [No] "Discarded" + else + --> [Yes] "Publish" + endIf + endIf +} +partition Published { + --> "Signature process" + if "Has passed the configured time window for validation (60 days by default)?" + --> [Yes] "Expired" + else + --> [No] Export PDF to signatures + --> Check signatures with offline signatures for duplicates (if the Initiative has them) + --> if "Has the initiative get the number of signatures required?" then + --> [No] Rejected + else + --> [Yes] Accepted + endIf + endIf +} +--> (*) +@enduml \ No newline at end of file From 174b46d868054c83bee2a6182313e7c785762b53 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:26 +0200 Subject: [PATCH 281/336] New translations processes.adoc (German) --- .../modules/admin/pages/spaces/processes.adoc | 242 ++++++++++++++++++ 1 file changed, 242 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces/processes.adoc diff --git a/docs/de/modules/admin/pages/spaces/processes.adoc b/docs/de/modules/admin/pages/spaces/processes.adoc new file mode 100644 index 0000000000..f833ec1522 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/processes.adoc @@ -0,0 +1,242 @@ += Processes + +A participatory process is a sequence of participatory activities (e.g. first filling out a survey, then making proposals, +discussing them in face-to-face or virtual meetings, and finally prioritizing them) with the aim of defining and making a decision on a specific topic. + +Examples of participatory processes are: a process of electing committee members (where candidatures are first presented, +then debated and finally a candidacy is chosen), participatory budgets (where proposals are made, valued economically, +and voted on with the money available), a strategic planning process, the collaborative drafting of a regulation or norm, +the design of an urban space or the production of a public policy plan. + +A really important concept for making good use of Decidim is to understand the relationship between Phases and Components +in a participatory process in Decidim: + +image::process_steps_components.png[Relation between Steps and Components in a Process in Decidim] + +What this diagram is showing is that for a participatory process you can have 7 phases: + +. Configuration & Presentation +. Diagnostic +. Proposal Creation +. Proposal Selection +. Results +. Evaluation +. Monitoring + +Inside of every one of these Phases, there are some components (like Blog, Meetings, Survey, Debates, Proposals, Results). +Some of these Components allow some features depending on the Phase that we are. + +In this section, we'll explain how we can configure a Participatory Process in Decidim. + +== List + +To configure participatory processes on the Decidim platform, click on btn:[Processes] in the admin sidebar menu. A list +will appear with the existing processes if there are any: + +image::processes_list.png[Participatory processes list] + +You can filter by the ones that are: + +* Published / Unpublished +* Public / Private + +image::processes_list_filter.png[Participatory processes list filtered] + +You can also search by title and control how many elements are in the list. + +You have 4 possible actions in this list after a Participatory Process is created: + +1. Export: send by email the configuration for a given process. Can be imported in other Decidim installation. +1. Duplicate: to duplicate this process. +1. Configure: to edit the metadata and configuration for a process. +1. Preview: how it will look once published. + +== New process form + +image::processes_new_form.png[New participatory process form] + + +.New participatory process form: General information +|=== +|Field |Type |Description + +|Title +|Required +|Title of the participatory process. For instance, "Participatory Budgeting 2020". + +|Subtitle +|Required +|Subtitle. For instance, "Let's decide our priorities together" + +|URL slug +|Required +|URL slugs are used to generate the URLs that point to this process. Only accepts letters, numbers and dashes, and must +start with a letter. Example: if your domain is 'example.org' and your slug 'participatory-budget-2020' then your URL will +be https://example.org/processes/participatory-budget-2020 + +|Hashtag +|Optional +|Hashtag for Twitter + +|Short description +|Required +|A short explanation of what's your participatory process about. + +|Description +|Required +|A long explanation of what's your participatory process about. + +|Announcement +|Optional +|The text you enter here will be shown to the user right below the process information. +|=== + + +.New participatory process form: Duration +|=== +|Field |Type |Description + +|Start date +|Optional +|When this process start. You have a calendar widget to choose the day. Expected format: dd/mm/yyyy + +|End date +|Optional +|When this process start. You have a calendar widget to choose the day. Expected format: dd/mm/yyyy +|=== + + +.New participatory process form: Images +|=== +|Field |Type |Description + +|Home image +|Optional +|Image that will be used in presentation cards of this process. Guidance for file: Has to be an image or a document. +For images, use preferably landscape images, the service crops the image. Maximum file size: 10MB + +|Banner image +|Optional +|Image that will be used inside of the process. Guidance for file: Has to be an image or a document. +For images, use preferably landscape images, the service crops the image. Maximum file size: 10MB +|=== + + +.New participatory process form: Metadata +|=== +|Field |Type |Description + +|Promoter group +|Optional +|Information that's displayed in the process metadata sidebar. + +|Organization area +|Optional +|Information that's displayed in the process metadata sidebar. + +|Scope metadata +|Optional +|Information that's displayed in the process metadata sidebar. + +|Who participates +|Optional +|Information that's displayed in the process metadata sidebar. + +|What is decided +|Optional +|Information that's displayed in the process metadata sidebar. + +|How is it decided +|Optional +|Information that's displayed in the process metadata sidebar. +|=== + +image::process_frontend_metadata.png[Process frontend metadata] + +image::process_backend_metadata.png[Process backend metadata] + + +.New participatory process form: Filters +|=== +|Field |Type |Description + +|Scopes enabled +|Optional +|Check if you want to have Scopes filtering in this process. + +|Scope +|Optional +|Which xref:admin:scopes.adoc[Scope] does this process belongs to. + +|Scope filter depth +|Optional +|Restrict the scope filter depth; The filter will show from general to the selected scope type. This is only relevant if +you have complex relations in Scopes children (like a Russian Doll). For instance if you have a Grandmother -> Mother -> +Child, this setting allows you to choose the Mother, so the participants can only choose the Child. This would be the +case for instance if you have Provinces -> Cities -> Districts, and the process is about a particular City. + +|Area +|Optional +|Which xref:admin:areas.adoc[Area] does this process belongs to. +|=== + + +.New participatory process form: Visibility +|=== +|Field |Type |Description + +|Processes group +|Optional +|Enables to make groups of multiple participatory processes. Ideally for processes that are related between them, for +instance multiple squares in a City or multiple documents using the same participatory rules. + +|Private space +|Optional +|Check if this process should only be accessible by xref:admin:spaces/processes/private_participants.adoc[Private Participants] + +|Promoted +|Optional +|Check if you want the process to have more visibility in the Process public list. It'll also be visible in the +Participatory Process Content Block in the xref:admin:homepage.adoc[Homepage] configuration. This is accessible in the +btn:[Edit] action in a Process. +|=== + + +.New participatory process form: Filters +|=== +|Field |Type |Description + +|Related processes +|Optional +|Select other participatory processes that are related to this one. +|=== + + +.New participatory process form: Filters +|=== +|Field |Type |Description + +|Show statistics +|Optional +|Check if you want to show the Statistics section. + +|Show metrics +|Optional +|Check if you want to show the Metrics section. +|=== + +After you've initially created your process you have a submenu where you need to keep configuring more information +about your participatory process. + +image::process_submenu.png[Process submenu in admin] + +Here you can keep configuring your process: + +. Info: the same form that we explained in this page. +. xref:admin:spaces/processes/phases.adoc[Phases] +. xref:admin:spaces/processes/components.adoc[Components] +. xref:admin:spaces/processes/categories.adoc[Categories] +. xref:admin:spaces/processes/attachments.adoc[Attachments] +. xref:admin:spaces/processes/admins.adoc[Process admins] +. xref:admin:spaces/processes/private_participants.adoc[Private participants] +. xref:admin:spaces/processes/moderations.adoc[Moderations] \ No newline at end of file From 26346a310327f4ecdf792c9da9bbb27d2e5f8ecf Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:27 +0200 Subject: [PATCH 282/336] New translations admins.adoc (German) --- docs/de/modules/admin/pages/spaces/processes/admins.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/de/modules/admin/pages/spaces/processes/admins.adoc diff --git a/docs/de/modules/admin/pages/spaces/processes/admins.adoc b/docs/de/modules/admin/pages/spaces/processes/admins.adoc new file mode 100644 index 0000000000..59313271ef --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/processes/admins.adoc @@ -0,0 +1 @@ +include::partial$page_admins.adoc[] \ No newline at end of file From f3299a0f8c0cd4cfca933d1a98abc088b6da2e2d Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:28 +0200 Subject: [PATCH 283/336] New translations attachments.adoc (German) --- docs/de/modules/admin/pages/spaces/processes/attachments.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/de/modules/admin/pages/spaces/processes/attachments.adoc diff --git a/docs/de/modules/admin/pages/spaces/processes/attachments.adoc b/docs/de/modules/admin/pages/spaces/processes/attachments.adoc new file mode 100644 index 0000000000..493f7dc8c8 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/processes/attachments.adoc @@ -0,0 +1 @@ +include::partial$page_attachments.adoc[] \ No newline at end of file From 7792eb073a5ce499298b5f6ddc094360ff6c04d8 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:29 +0200 Subject: [PATCH 284/336] New translations categories.adoc (German) --- docs/de/modules/admin/pages/spaces/processes/categories.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/de/modules/admin/pages/spaces/processes/categories.adoc diff --git a/docs/de/modules/admin/pages/spaces/processes/categories.adoc b/docs/de/modules/admin/pages/spaces/processes/categories.adoc new file mode 100644 index 0000000000..3ee4fc09cc --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/processes/categories.adoc @@ -0,0 +1 @@ +include::partial$page_categories.adoc[] \ No newline at end of file From e50152808c67ba30090e68056097b72348bb7a4f Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:30 +0200 Subject: [PATCH 285/336] New translations components.adoc (German) --- docs/de/modules/admin/pages/spaces/processes/components.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/de/modules/admin/pages/spaces/processes/components.adoc diff --git a/docs/de/modules/admin/pages/spaces/processes/components.adoc b/docs/de/modules/admin/pages/spaces/processes/components.adoc new file mode 100644 index 0000000000..7a204dda0b --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/processes/components.adoc @@ -0,0 +1 @@ +include::partial$page_components.adoc[] \ No newline at end of file From 9a2d91ba306282c10e64c445918340fa63b2dfd4 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:31 +0200 Subject: [PATCH 286/336] New translations groups.adoc (German) --- .../admin/pages/spaces/processes/groups.adoc | 113 ++++++++++++++++++ 1 file changed, 113 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces/processes/groups.adoc diff --git a/docs/de/modules/admin/pages/spaces/processes/groups.adoc b/docs/de/modules/admin/pages/spaces/processes/groups.adoc new file mode 100644 index 0000000000..315bedeaa7 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/processes/groups.adoc @@ -0,0 +1,113 @@ += Process groups + +A group of processes proves useful for subdividing large participatory processes into subprocesses according to a criteria, +for instance the xref:admin:scopes.adoc[scope] of every process. + +As an example you can see the https://www.decidim.barcelona/processes_groups/4[Barcelona City Council's Neighborhoods Plan, Pla de Barris]. +This is is a 150 million euro shock plan that aims to reduce inequalities within the city. There are 10 related processes, one for each involved neighborhood. + +image::processes_group_example.png[Participatory process group example] + +== New process group form + +For creating a new process group: + +. Sign in as administrator +. Go to the Processes section in the sidebar +. Click on the Process groups link in the sidebar +. Click on the "New process group" button +. Fill in the form + +image::processes_group_list.png[Participatory process groups list] + +image::processes_group_new_form.png[New participatory process group form] + + +.New participatory process group form: General information +|=== +|Field |Type |Description + +|Title +|Required +|Title of the participatory process group. For instance, "Participatory Budgeting". + +|Description +|Required +|A long explanation of what's your participatory process about. + +|Related processes +|Optional +|Which are the processes that are related to this one? They will be used for populating +the Content Blocks in the Landing page of this Process group. For selecting multiple you'll +need to use the *ctrl* function. + +|Image +|Optional +|Image that will be used in presentation cards of this process group. Guidance for image: +Preferably a landscape image that does not have any text. The service crops the image. +Maximum file size: 10MB. Allowed file extensions: jpeg jpg png +|=== + + +.New participatory process group form: Metadata +|=== +|Field |Type |Description + +Hashtag +Website + +|Promoter group +|Optional +|Information that's displayed in the process metadata content block. + +|Organization area +|Optional +|Information that's displayed in the process metadata content block. + +|Scope metadata +|Optional +|Information that's displayed in the process metadata content block. + +|Who participates +|Optional +|Information that's displayed in the process metadata content block. + +|What is decided +|Optional +|Information that's displayed in the process metadata content block. + +|How is it decided +|Optional +|Information that's displayed in the process metadata content block. +|=== + + +.New participatory process group form: Visibility +|=== +|Field |Type |Description + +|Promoted +|Optional +|Check if you want the process to have more visibility in the Process public list. It'll also be visible in the +ParticpipatoryProcess Content Block in the xref:admin:homepage.adoc[Homepage] configuration. This is accessible in the btn:[Edit] action in a Process. +|=== + +== Landing page + +One of the main features of a process group is to be able to configure the Lnading page, through Content blocks, just like +the general homepage of the platform. This means that you can enable or disable different sections of the landing page and also +configure some fo these sections. + +image::processes_group_landing.png[Participatory process group landing page] + +* Title, description and hashtag +* Metadata +* Image, text and Call to Action button. Configurable. +* Proposals. You can configure how the elements will be sorted: by most recent or random. +* Results. You can configure how the elements will be sorted: by most recent or random. +* Upcoming events +* Statistics +* Participatory processes +* First HTML block +* Second HTML block +* Third HTML block \ No newline at end of file From 2cc70998ef9ed2bf2f4a6d60b691048be1497f22 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:32 +0200 Subject: [PATCH 287/336] New translations moderations.adoc (German) --- docs/de/modules/admin/pages/spaces/processes/moderations.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/de/modules/admin/pages/spaces/processes/moderations.adoc diff --git a/docs/de/modules/admin/pages/spaces/processes/moderations.adoc b/docs/de/modules/admin/pages/spaces/processes/moderations.adoc new file mode 100644 index 0000000000..12d6ac0858 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/processes/moderations.adoc @@ -0,0 +1 @@ +include::partial$page_moderations.adoc[] \ No newline at end of file From f575581da64007d2fcc2376e0a9343e38c4b91de Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:33 +0200 Subject: [PATCH 288/336] New translations phases.adoc (German) --- .../admin/pages/spaces/processes/phases.adoc | 89 +++++++++++++++++++ 1 file changed, 89 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces/processes/phases.adoc diff --git a/docs/de/modules/admin/pages/spaces/processes/phases.adoc b/docs/de/modules/admin/pages/spaces/processes/phases.adoc new file mode 100644 index 0000000000..c9c58c5173 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/processes/phases.adoc @@ -0,0 +1,89 @@ += Phases + +A participatory process is a sequence of phases ordered in time. Depending on which phase of the process timeline you +are, then you can enable or disable some features. + +Ideally, the Phases of a Participatory Process are always the same and are not changed, so participants can know what are +the rules and timeframe and can organize their lives to know when it'd be best for them to participate in this process. + +As a guideline, the standard structure of a participatory process may be as follows: + +. Presentation +. Diagnosis +. Proposal creation and debate +. Proposals prioritization +. Proposals evaluation +. Monitoring + +Participants can find the link to different phases of a participatory process in the header of the participatory process, +in the link "Process phases". Here they can see the full description and explanation of the phases. The active phase +will be highlighted. + +image:process_phases_header.png[Header with processes phases link] + +image:process_phases.png[Process phases explanation] + +== Create a new phase + +image:process_phases_list.png[Phases of a participatory process] + +For creating a new phase of a participatory process: + +. Sign in as administrator +. Go to the participatory process section in the sidebar +. Click on the participatory process Edit action +. Click on the Phases link in the sidebar +. Click on the "New phase" button + +image:process_phases_new_form.png[Create a new participatory process phase form] + + +.Create meeting +|=== +|Field |Type |Description + +|Title +|Required +|What is the title for this phase. + +|Description +| +|A long description explaining what's this phase for. + +|Start date +| +|Which day this phase will start. Expected format: dd/mm/yyyy + +|End date +| +|Which day this phase will end. Expected format: dd/mm/yyyy + +|Call to Action path +| +|Where will the button link to. For instance, it could point to the new proposal creation form. Use partial paths, not full +URLs here. Accepts letters, numbers, dashes, and, slashes, and must start with a letter. If not set, the button will not be shown. + +|Call to Action text +| +|What will the button say. For instance, it could be "Create a proposal". If not set, the button will not be shown. +|=== + +== Actions + +After a phase was created you have these actions: + +|=== +|Icon |Name |Definition + +|image:action_activate.png[Activate icon] +|Activate +|To make this phase the active one. + +|image:action_edit.png[Edit icon] +|Edit +|To edit this phase. + +|image:action_delete.png[Delete icon] +|Delete +|To delete this phase. +|=== \ No newline at end of file From a6fd854d7d483de208229144088eeaf2a518e0a1 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:34 +0200 Subject: [PATCH 289/336] New translations private_participants.adoc (German) --- .../admin/pages/spaces/processes/private_participants.adoc | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/de/modules/admin/pages/spaces/processes/private_participants.adoc diff --git a/docs/de/modules/admin/pages/spaces/processes/private_participants.adoc b/docs/de/modules/admin/pages/spaces/processes/private_participants.adoc new file mode 100644 index 0000000000..16c939dfa3 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/processes/private_participants.adoc @@ -0,0 +1 @@ +include::partial$page_private_participants.adoc[] \ No newline at end of file From 7d26de978a9f1d4b1850b5b81da9559582ccd473 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:35 +0200 Subject: [PATCH 290/336] New translations votings.adoc (German) --- docs/de/modules/admin/pages/spaces/votings.adoc | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 docs/de/modules/admin/pages/spaces/votings.adoc diff --git a/docs/de/modules/admin/pages/spaces/votings.adoc b/docs/de/modules/admin/pages/spaces/votings.adoc new file mode 100644 index 0000000000..4ee78af415 --- /dev/null +++ b/docs/de/modules/admin/pages/spaces/votings.adoc @@ -0,0 +1,3 @@ += Votings + +include::admin:partial$development.adoc[] \ No newline at end of file From 20b39c7554819fb5b4342db156ddfca4971bec33 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:36 +0200 Subject: [PATCH 291/336] New translations system.adoc (German) --- docs/de/modules/admin/pages/system.adoc | 124 ++++++++++++++++++++++++ 1 file changed, 124 insertions(+) create mode 100644 docs/de/modules/admin/pages/system.adoc diff --git a/docs/de/modules/admin/pages/system.adoc b/docs/de/modules/admin/pages/system.adoc new file mode 100644 index 0000000000..b52b8da96d --- /dev/null +++ b/docs/de/modules/admin/pages/system.adoc @@ -0,0 +1,124 @@ += System + +Every Decidim is multi-tenant by default. That means that you can have multiple organizations inside of your same installation. This is being used for instance for the Barcelona and Girona Provincials Governments, for offering Decidim installations to many small cities, or by the City of Barcelona, for giving service to lots of organizations (NGOs, cooperatives, etc). + +Even if you only have one Organization you also need to create one through the System Panel. It's available after you've installed Decidim, at `/system`. For instance if you domain is `example.org`, then it should be available at `http://example.org/system`. + +After you've freshly installed Decidim, you'll be redirected to the System panel log-in page: + +image::system-log_in.png[system panel log in] + +== 1. Create an admin account + +For accessing in this dashboard, you'll need to create a system admin account with the Rails console, as the instructions that you have in your `README.md` file: + +Open a console: + +[source, console] +.... +bin/rails console +.... + +Then create the systems' admin: + +[source, ruby] +.... +user = Decidim::System::Admin.new(email: , password: , password_confirmation: ) +user.save! +.... + +So for example, if your email is `system@decidim.org` and your password `decidim123456` that'd be: + +[source, ruby] +.... +user = Decidim::System::Admin.new(email: 'system@decidim.org', password: 'decidim123456', password_confirmation: 'decidim123456') +user.save! +.... + +IMPORTANT: Please don't use this password, is really insecure! + +== 2. Access the Dashboard + +After you've logged in, you'll see an empty dashboard: + +image::system-dashboard.png[system empty dashboard] + +== 3. Create a new organization + +Inside of the system panel, you need to create your Organization through the form: + +TIP: Please mind that some of these fields can't change through the System Form, as changing them could potentially leave your database in a broken state. You can change it through the console, but you'll be on your own. + + +.System New Organization form +|=== +|Field |Type |Description + +|Name +|Required +|Name of your organization. For instance, "Decidim Barcelona". + +|Reference prefix +|Required +|The reference prefix is used to uniquely identify resources across all organizations. It's for identifying different resources inside of Decidim. For instance, "BCN". You can change how it's created this reference through xref:configure:initializer.adoc[Decidim's initializer] (see **Custom resource reference**). + +|Host +|Required +|Fully qualified domain name. For instance, "example.org" or "decidim.barcelona". + +|Secondary hosts +|Optional +|Others domains or subdomains that point to this same installation. Normally this shouldn't be used. Enter each one of them in a new line. For instance, "example.com" + +|Organization admin name +|Required +|Name of the admin account. For instance, "Admin" + +|Organization admin email +|Required +|Email for the admin account. For instance, "admin@example.org" + +|Organization locales +|Required +|You'll need to configure at least one language. Decidim is multilanguage, meaning that you can have most of the admin contents with any number of languages. For seeing other languages you'll need to configure first the xref:configure:initializer.adoc[Decidim's initializer]. + +|Force authentication +|Optional +|Check if you want to **Force users to authenticate before access organization**. That means that they don't see any published content and they only have access to the log-in form. + +|Users registration mode +|Optional +|Control how you want the login / participant register or signup to work. See below. + +|Available authorizations +|Optional +|How you want to authorize and verify that your participants are who they say they are. It depends a lot on your Organization, country, etc. See xref:customize:authorizations.adoc[Authorizations customization]. + +|SMTP settings +|Optional +|Allows you to configure different SMTP servers for every Organzation in this installation. See xref:services:smtp.adoc[SMTP configuration]. + +|Omniauth settings +|Optional +|Allows you to configure through external OAUTH providers for every Organization in this installation. See xref:services:social_providers.adoc[Social providers configuration]. +|=== + +=== Users registration mode + +==== 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 (and you can disable that confirmation also if you want to through xref:configure:initializer.adoc[Decidim's initializer]) + +==== Don't allow participants to register, but allow existing participants to login + +This is for when you make a manual import of participants' accounts. + +==== Access only can be done with external accounts + +In the case where you have an external provider configured (like the `Omniauth settings`) and you want to have accounts from only this provider. + +== [Optional] 4. Edit an organization + +Finally, you can also Edit an organization, although some fields can not be changed as some contents in the database depends on them. + +For accessing your newly created Organization, you can do it going to the domain or subdomain that you've configured in `Host`. \ No newline at end of file From 82e6884c2245bb55f66c40fe002bb2c6537f416f Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:37 +0200 Subject: [PATCH 292/336] New translations components_list.adoc (German) --- .../admin/partials/components_list.adoc | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 docs/de/modules/admin/partials/components_list.adoc diff --git a/docs/de/modules/admin/partials/components_list.adoc b/docs/de/modules/admin/partials/components_list.adoc new file mode 100644 index 0000000000..3f51e2a0ba --- /dev/null +++ b/docs/de/modules/admin/partials/components_list.adoc @@ -0,0 +1,18 @@ +The platform currently have the following official components: + +* Accountability: allows to keep track of the results execution of a space. +It allows administrators to also relate them to the proposals and meetings that originated them. +* xref:admin:components/blog.adoc[*Blog*]: allows administrators to publish posts with news regarding a space. +* xref:admin:components/budgets.adoc[*Budgets*]: allows participants to vote in projects with amounts predefined. Used for +participatory budgeting processes. Allows to define different kind of rules, for instance a minimum percentage of the total budget or a minimum amount of projects. +* xref:admin:components/debates.adoc[*Debates*]: allows participants to have debates. Debates can be time limited or not. +* xref:admin:components/elections.adoc[*Elections*]: to have end-to-end auditable elections in a space. Uses the same +external system as xref:admin:spaces/votings.adoc[Votings] space. +* xref:admin:components/meetings.adoc[*Meetings*]: gatherings in person or online through videoconferences platforms. +* xref:admin:components/pages.adoc[*Page*]: static pages with multi-language support. +* xref:admin:components/proposals.adoc[*Proposals*]: contributions posted by participants which can be given support. +* Sortitions: this allows different kind of proposals to be selected randomly. +For instance the proposals could be candidates who form part of a group (such as a committee). +* xref:admin:components/surveys.adoc[*Survey*]: for conducting surveys with different kinds of questions. + +In the cases where your needs are not covered by one of the above components, you can create your own component through a xref:develop:modules.adoc[Module]. \ No newline at end of file From de164c8cd8f0f3e52c805a7c276cf2ff9468ff20 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:38 +0200 Subject: [PATCH 293/336] New translations deprecated.adoc (German) --- docs/de/modules/admin/partials/deprecated.adoc | 4 ++++ 1 file changed, 4 insertions(+) create mode 100644 docs/de/modules/admin/partials/deprecated.adoc diff --git a/docs/de/modules/admin/partials/deprecated.adoc b/docs/de/modules/admin/partials/deprecated.adoc new file mode 100644 index 0000000000..ceaa4f0f37 --- /dev/null +++ b/docs/de/modules/admin/partials/deprecated.adoc @@ -0,0 +1,4 @@ +[CAUTION] +==== +This feature is deprecated and will be removed in the future. If you really depend in this feature and can't find an alternative way of working with this, please put in touch with us at hola [at] decidim [dot] +==== \ No newline at end of file From 09149294071a43fd27473eb1d853848e001adc3d Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:39 +0200 Subject: [PATCH 294/336] New translations development.adoc (German) --- docs/de/modules/admin/partials/development.adoc | 4 ++++ 1 file changed, 4 insertions(+) create mode 100644 docs/de/modules/admin/partials/development.adoc diff --git a/docs/de/modules/admin/partials/development.adoc b/docs/de/modules/admin/partials/development.adoc new file mode 100644 index 0000000000..1309f6aa16 --- /dev/null +++ b/docs/de/modules/admin/partials/development.adoc @@ -0,0 +1,4 @@ +[CAUTION] +==== +This feature is in active development. It is not ready for production use. +==== \ No newline at end of file From 1836ec00e8d620eb847685b8fcb46f83024d92f4 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:40 +0200 Subject: [PATCH 295/336] New translations legacy.adoc (German) --- docs/de/modules/admin/partials/legacy.adoc | 4 ++++ 1 file changed, 4 insertions(+) create mode 100644 docs/de/modules/admin/partials/legacy.adoc diff --git a/docs/de/modules/admin/partials/legacy.adoc b/docs/de/modules/admin/partials/legacy.adoc new file mode 100644 index 0000000000..22c10a6058 --- /dev/null +++ b/docs/de/modules/admin/partials/legacy.adoc @@ -0,0 +1,4 @@ +[CAUTION] +==== +This section hasn't been updated. It shows the content of an old version of Decidim. You can collaborate to improving the Documentation, please put in touch with us at hola [at] decidim [dot] org +==== \ No newline at end of file From 5466c1c047a8e9b41084c06c7034facd0a236b90 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:41 +0200 Subject: [PATCH 296/336] New translations page_admins.adoc (German) --- .../modules/admin/partials/page_admins.adoc | 67 +++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 docs/de/modules/admin/partials/page_admins.adoc diff --git a/docs/de/modules/admin/partials/page_admins.adoc b/docs/de/modules/admin/partials/page_admins.adoc new file mode 100644 index 0000000000..e4527970ba --- /dev/null +++ b/docs/de/modules/admin/partials/page_admins.adoc @@ -0,0 +1,67 @@ += Space Admins + +You can give permissions to users with special rights in a space, +so they can only have access to some of the administration pages in this space. +These roles are administrators, moderators, collaborators, or valuators. + +* Administrators: they can administer the space and change the space settings. +* Collaborators: they can see the space and its components before it's published and view the space settings. +They can't change anything. +* Moderators: they can see the reported contents of the space and hide or unhide them. +* Valuators: they can evaluate proposals. Used by participatory budgeting processes. + +To invite them, in the space's submenu, go to *Space admins* and click on *New space admin*. This depends in the kind of space +that you're, for instance for participatory processes it'd be *Process admins* and *New process admin*. + +== New space admin form + +image:spaces/admins_form.png[New space admin form] + + +.New space admin form +|=== +|Field |Type |Description + +|Name +|Required +|What is the name of the new admin. + +|Email +|Required +|What is the email of the new admin, so she can receive the invitation. + +|Role +|Required +|Which role does this admin will have in the participatory process? Can be any of Administrator, Collaborator, Moderator, or Valuator. +|=== + +== Roles + +=== Administrators + +A space administrator can administer the space and change the space settings. It can also invite new space administrators. + +image:spaces/admins_role_admin01.png[Process administrators view 01] + +image:spaces/admins_role_admin02.png[Process administrators view 02] + +=== Collaborators + +A space collaborator can only see the space before it's published. + +image:spaces/admins_role_collaborator.png[Process collaborators view] + +=== Moderators + +A space moderator can review the reported contents of the space and hide or unhide them. + +image:spaces/admins_role_moderator.png[Process moderators view] + +=== Process valuators + +A space valuator can review the proposals of the space. She can: + +* change the status of the proposals, by accepting or rejecting them +* add a monetary value to the proposals, so they can be voted with the budget component. + +image:spaces/admins_role_valuator.png[Process valuators view] \ No newline at end of file From da36df9df83a7a5dea824298e76343684505795e Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:42 +0200 Subject: [PATCH 297/336] New translations page_attachments.adoc (German) --- .../admin/partials/page_attachments.adoc | 77 +++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 docs/de/modules/admin/partials/page_attachments.adoc diff --git a/docs/de/modules/admin/partials/page_attachments.adoc b/docs/de/modules/admin/partials/page_attachments.adoc new file mode 100644 index 0000000000..0b7fab6042 --- /dev/null +++ b/docs/de/modules/admin/partials/page_attachments.adoc @@ -0,0 +1,77 @@ += Attachments + +Attachments allow an administrator to upload static files to a space. + +When a space is launched, it is important to provide citizens with as much information as possible about them so that they can participate with knowledge. That is why it is helpful to add files (Attachments) with the information that is considered relevant. + +Optionally, these documents can be grouped in *Folders*. For example, for a participatory process of remodeling a square, folders could be created with information about possible uses, with plans, with economic information, etc. + +They can be found on the Space homepage: + +image:spaces/attachments_folder.png[View the folder attachments in the public interface] + +image:spaces/attachments.png[View the attachments in the public interface] + +== Create a new attachment + +image:spaces/attachments_admin.png[View the attachments in the admin interface] + +For creating a new attachment of a space: + +. Sign in as administrator +. Go to the space section in the sidebar +. Click on the space Edit action +. Click on the Attachments link in the sidebar +. Click on the "New attachment" button + +image:spaces/attachments_new_form.png[Create a new attachment form] + + +.Create attachment +|=== +|Field |Type |Description + +|Attachment or image name +|Required +|What is the title for this attachment. + +|Weight +|Optional +|Which order will it have in relation to the other attachments. Having a lower number means a higher priority. For instance, if you have two categories, "Attachment a" with weight "10" and "Attachment b" with weight "0", then "Attachment b" will be first when ordering. + +|Description +|Required +|A long description explaining what this file is about. + +|Folder +|Optional +|Which folder this attachment belongs to. + +|File +|Required +|Upload the file. Guidance for file: Has to be an image or a document. For images, use preferrably landscape images, the +service crops the image. For CSV files, the separator between columns must be a comma (","). Maximum file size: 10MB. Allowed +file extensions depends in your server configuration. +|=== + +== Create a new folder + +image:spaces/attachments_new_folder_form.png[Create a new folder for attachments form] + + +.Create folder +|=== +|Field |Type |Description + +|Name +|Required +|Name of the folder + +|Weight +|Optional +|Which order will it have in relation to the other folders. Having a lower number means a higher priority. For instance, if you have two folders, "Folder a" with weight "10" and "Folder b" with weight "0", then "Folder b" will be first when ordering. + +|Description +|Required +|A long description explaining what this folder is about. +|=== \ No newline at end of file From 5d7c11573df797c546966262aee469a429853c84 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:43 +0200 Subject: [PATCH 298/336] New translations page_categories.adoc (German) --- .../admin/partials/page_categories.adoc | 56 +++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 docs/de/modules/admin/partials/page_categories.adoc diff --git a/docs/de/modules/admin/partials/page_categories.adoc b/docs/de/modules/admin/partials/page_categories.adoc new file mode 100644 index 0000000000..67571c88bd --- /dev/null +++ b/docs/de/modules/admin/partials/page_categories.adoc @@ -0,0 +1,56 @@ += Categories + +Categories (and subcategories) are used for classifying resources inside of a space. + +An administrator can define them, can be assigned to when creating resources, and then participants can filter the +different resources by these categories. For instance, they can be set up in proposals, meetings and debates. + +As an example of this mechanism in action you can see it in https://meta.decidim.org/processes/roadmap/f/122/[Propose new functionalities for Decidim software] process: + +. Administrators have defined the categories in the process. +. Participants can create proposals that have one category. +. Participants can filter by these categories and navigate among all the proposals. + +image:spaces/categories_sidebar.png[Filter categories in proposals] + +image:spaces/categories_form.png[Select a category when creating a proposal] + +NOTE: Once a category is in use it cannot be removed, as there are resources that are using it. + +Decidim has other ways to classify resources, for instance xref:admin:scopes.adoc[Scopes] and Hashtags. +The main difference is that Categories can be defined in a given space, Scopes are global for all the platform, and Hashtags +are defined by the participants. + +Categories can be nested, meaning that a category can have subcategories. + +== Create a new category + +For configuring a new category, go to the space admin panel and click on the "Categories" tab. + +image:spaces/categories.png[View categories in a space admin page] + +Then click in "Add category" and fill the form. + +image:spaces/categories_new_form.png[Create a new category form] + + +.Create category +|=== +|Field |Type |Description + +|Name +|Required +|What is the name for this category. + +|Weight +|Optional +|Which order will it have in relation to the other categories. Having a lower number means a higher priority. For instance, if you have two categories, "Category a" with weight "10" and "Category b" with weight "0", then "Category b" will be first when ordering. + +|Description +|Required +|A long description explaining what this category is about. + +|Parent +|Optional +|What is the parent category. +|=== \ No newline at end of file From 509df4b37310516ce6929d4744af996a6b1b07ea Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:45 +0200 Subject: [PATCH 299/336] New translations page_components.adoc (German) --- .../admin/partials/page_components.adoc | 52 +++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 docs/de/modules/admin/partials/page_components.adoc diff --git a/docs/de/modules/admin/partials/page_components.adoc b/docs/de/modules/admin/partials/page_components.adoc new file mode 100644 index 0000000000..5544cc7a1e --- /dev/null +++ b/docs/de/modules/admin/partials/page_components.adoc @@ -0,0 +1,52 @@ += Components + +include::partial$components_list.adoc[] + +To configure components, click on *Components* from the space submenu. A list will appear showing the components +that have already been configured for the space. + +image::spaces/components.png[Components of space] + +To configure a new component, click on *Add component* from the upper right part of the screen and select the type of +component you wish to configure from the drop-down menu. + +image::spaces/components_new_dropdown.png[Add a component in a space] + +== Actions + +|=== +|Icon |Name |Definition + +|image:action_manage.png[Manage icon] +|Manage +|To manage all the resources inside of a component. For instance, all the Proposals of a Proposal component, the Meetings +in a Meeting component, etc. + +|image:action_publish.png[Publish icon] +|Publish +|To publish a component. This means that the component will be visible to the public. + +|image:action_unpublish.png[Unpublish icon] +|Unpublish +|To unpublish a component. This means that the component will be invisible to the public. + +|image:action_configure.png[Configure icon] +|Configure +|To configure a component with the specific rules. Depends in the component type. For instance, in the case of Meetings: +are comments enabled, participants can create meetings, etc. + +|image:action_permissions.png[Permissions icon] +|Permissions +|To configure which xref:customize:authorizations.adoc[Authorization] will be necessary to make certain actions in +this component. For instance, in the case of Proposals, which Verification will be necessary to create a new proposal or +to give supports. + +|image:action_share.png[Share icon] +|Share +|To share privately before publishing this component. Useful for reviewing with other people inside of your organization. + +|image:action_delete.png[Delete icon] +|Delete +|To delete this component. If there are contents most of the components will not let you delete them so it doesn't break +relations with other resources. In those cases it's recommended to just unpublish the component. +|=== \ No newline at end of file From 2d694c2e2ad2119ec2134474e20981280ae31d01 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:46 +0200 Subject: [PATCH 300/336] New translations page_moderations.adoc (German) --- docs/de/modules/admin/partials/page_moderations.adoc | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 docs/de/modules/admin/partials/page_moderations.adoc diff --git a/docs/de/modules/admin/partials/page_moderations.adoc b/docs/de/modules/admin/partials/page_moderations.adoc new file mode 100644 index 0000000000..aeed3aac33 --- /dev/null +++ b/docs/de/modules/admin/partials/page_moderations.adoc @@ -0,0 +1,9 @@ += Moderation + +Moderations inside of a space work like xref:global_moderations.adoc[Global moderations]. + +The main difference is that if you want so you can invite Moderators of this specific +space and they will only have access to the reports made for +contents of this space. + +Moderators are a kind of space admins. See it for instance for xref:spaces/processes/admins.adoc[participatory processes admins]. \ No newline at end of file From eb52731194c86f1471767148f67b9618c995faaf Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:47 +0200 Subject: [PATCH 301/336] New translations page_private_participants.adoc (German) --- .../partials/page_private_participants.adoc | 75 +++++++++++++++++++ 1 file changed, 75 insertions(+) create mode 100644 docs/de/modules/admin/partials/page_private_participants.adoc diff --git a/docs/de/modules/admin/partials/page_private_participants.adoc b/docs/de/modules/admin/partials/page_private_participants.adoc new file mode 100644 index 0000000000..90580396be --- /dev/null +++ b/docs/de/modules/admin/partials/page_private_participants.adoc @@ -0,0 +1,75 @@ += Private participants + +There are cases where you want to have a closed census of the participants in a space. For instance this could be a space +for a small group of people, or the members of a comission inside of a big organization. For these cases you can +use the private participants feature. + +image:spaces/private_participants.png[Private participants list] + +For inviting private participants of a space: + +. Sign in as administrator +. Go to the space's section in the sidebar +. Click on the space Edit action +. Click on the "Private participants" link in the sidebar +. Click on the "New participatory space private user" or "Import via CSV" buttons + +== New participatory space private user + +image:spaces/private_participants_new_form.png[New private participant form] + + +.New participatory space private user form +|=== +|Field |Type |Description + +|Name +|Required +|What is the name of the new participant. + +|Email +|Required +|What is the email of the new participant. +|=== + +== Import via CSV + +image:spaces/private_participants_csv_import.png[Import private participants via CSV] + +This form allows you to bulk import the participants of a space. + +It must have two columns with email in the first column of the file and the name in the last column of the file (email, name) +of the users that you want to add to the participatory space. Some tips: + +* The file should not have headers. That means that you do not have to add a column that says "email, name" +* You must avoid using invalid chars like `<>?%&^*#@()[]=+:;"{}\|` in user name. +* The separator between columns must be a comma (",") + +== Actions + +After the participants has been invited, you can resend or delete the invitation. + +image:spaces/private_participants_actions.png[Private participants actions] + +|=== +|Icon |Name |Definition + +|image:action_resend_invitation.png[Resend invitation] +|Resend invitation +|If the invitation wasn't accepted, send it again to the user + +|image:action_delete.png[Delete invitation] +|Delete invitation +|Revoke the invitation sent to the user +|=== + +== Invitation + +When a participant was invited she'll get an email with a link for accepting the invitation: + +image:spaces/private_participants_email_invite.png[Email invitation of a private participant] + +After clicking in this email, she'll have to fill a form for setting her password, accepting the Terms of Service and giving +her consent if she wants to receive newsletters. + +image:spaces/private_participants_user_registration_form.png[User registration form of a private participant] \ No newline at end of file From de98b9d083967725c30679103525bd747e93ff7d Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:48 +0200 Subject: [PATCH 302/336] New translations under-construction.adoc (German) --- docs/de/modules/admin/partials/under-construction.adoc | 4 ++++ 1 file changed, 4 insertions(+) create mode 100644 docs/de/modules/admin/partials/under-construction.adoc diff --git a/docs/de/modules/admin/partials/under-construction.adoc b/docs/de/modules/admin/partials/under-construction.adoc new file mode 100644 index 0000000000..8af7720c26 --- /dev/null +++ b/docs/de/modules/admin/partials/under-construction.adoc @@ -0,0 +1,4 @@ +[NOTE] +==== +This section hasn't been written yet. You can collaborate to improving the Documentation, please put in touch with us at hola [at] decidim [dot] org +==== \ No newline at end of file From 7d78833ccc44ac283a7b8fade2edd797a6cc51d0 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:50 +0200 Subject: [PATCH 303/336] New translations documentation.adoc (German) --- .../contribute/pages/documentation.adoc | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 docs/de/modules/contribute/pages/documentation.adoc diff --git a/docs/de/modules/contribute/pages/documentation.adoc b/docs/de/modules/contribute/pages/documentation.adoc new file mode 100644 index 0000000000..ba8b6938b5 --- /dev/null +++ b/docs/de/modules/contribute/pages/documentation.adoc @@ -0,0 +1,19 @@ += Documentation + +To contribute to the documentation (for instance, this same page that you're reading), you can do it through two ways: editing on GitHub directly or editing locally. + +== Edit on GitHub + +This is the recomended way if you just want to make a quick fix (for instance, a typo or some clarification on a single page). For doing this you'll need to click in the "Edit this page" link in the top of every page. + +image::documentation-edit.png[Edit this page link] + +It'll open the page for editing in GitHub interface and after you've finished it'll guide you to make a Pull Request so maintainers can review your contribution. + +== Edit locally + +If you want to propose lots of changes in the documentation, or if you want to review your changes locally before sending them because you want to review things like formatting, you can install the environment for having the documentation site locally. + +Then you'll need to fork the repository, make a branch and propose your changes as a Pull Request so maintainers can review it. As you see this can be a hassle if you want to make small changes, so the prefered way would be to do it initially with the "Edit this page" link mehod. + +Read the full instructions on how to install this documentation website locally in the https://github.com/decidim/documentation/[Decidim Documentation GitHub repository]. \ No newline at end of file From 94c7b18fdef83372e5de9a7de593337b6b5d149a Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:51 +0200 Subject: [PATCH 304/336] New translations governance.adoc (German) --- .../modules/contribute/pages/governance.adoc | 45 +++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 docs/de/modules/contribute/pages/governance.adoc diff --git a/docs/de/modules/contribute/pages/governance.adoc b/docs/de/modules/contribute/pages/governance.adoc new file mode 100644 index 0000000000..c1617e40e9 --- /dev/null +++ b/docs/de/modules/contribute/pages/governance.adoc @@ -0,0 +1,45 @@ += Governance + +== About the code + +For making new features, you can made a https://decidim.org/modules[new module] for your own application. If you want to publish it on the website, you can https://decidim.org/contact[send us an message]. + +If you want to add a new feature or a change on the codebase, the process is: + +. Suggest your change in https://meta.decidim.barcelona/processes/roadmap[Metadecidim] +. Wait until Product Team reviews and accept the feature, as it's important to be consistent with the rest of the software, comply with the Social Contract, etc. +. Then you can make the Pull Request. +. The PR will get reviewed by: +.. Product Team: will review the functionality +.. Mantainers: will review the code quality + +image::workflow-features.png[new feature workflow process] + +Some things that you need to take in account about this process: + +* If you make the PR without Product Team approval then you could get rejected (after investing lots of time on developing). +* Proposals can receive endorsements, although these are not decisive for a proposal to be included on the roadmap. The endorsements serve as indicators of the interest of the proposal or the need it covers. The comments to the proposals are also enabled, to collectively elaborate the initial idea and bring it to a productive result. +* Every Thursday the Product team reviews all new proposals that have been published the previous week +* If no funding is available it is included in the backlog of the corresponding component or module. + +== About the organization + +Decidim was initially created by the city of Barcelona, but quickly it evolved through the help of Localret and other entities and administrations from Catalonia, such as Diputació de Barcelona (Barcelona Provincial Government), and other catalan cities: Terrassa, Sabadell, Gavà, L'Hospitalet de Llobregat, Badalona and Sant Cugat. You can read more about the history in xref:understand:about.adoc[About]. + +Since our first version in 2017 we've detected that it's necessary for the sustainability of the project to not depend in a given institution such as the city of Barcelona, as that could be problematic for the future. Other open source projects made by public institutions that didn't have a strong community or a sustainability strategy get shut down or slowly die without funding. + +Making this kind of open source software from the public institutions and through public contracting law is really difficult and one other issue that we want to tackle with this new organization is about having resources for contracting in-house developers. + +With all this on mind, we started with the https://meta.decidim.org/processes/decidim-gov[Metadecidim Governance participatory process] starting in November 2017: + +**** +A process open to the entire Community regarding the decision-making and representative bodies that we must equip ourselves with in order to build an autonomous, transparent and democratic organisation for the Decidim Project. + +The objective is to define an organizational and representation system (internal organs and how they are chosen) that can be transformed into an autonomous entity or association from which the whole community participates and can manage the project at multiple levels + +The Decidim project needs a system of its own governance that allows it to enjoy sufficient autonomy to continue growing in a sustainable manner, which is why it has to be provided with decision-making and conflict resolution bodies. +**** + +As a result of this participatory process, on February 2019 the Decidim Free Software Association (_Associació de Software Lliure Decidim_ in catalan) was created. You can read more about the https://meta.decidim.org/assemblies/general-assembly-association[General Assembly of the Decidim Association]. + +On 2021, the Decidim Association https://decidim.org/blog/2021-02-09-the-government-of-catalonia-barcelona-city-council-and-the-free-software-association-decidim-sign-a-collaboration-agreement-to-promote-democratic-participation-with-free-and-open-technologies/[has signed a collaboration agreement with the Government of Catalonia and Barcelona City Council to promote the development of the platform]. \ No newline at end of file From 7cde9dd4488eb836f84e129bf9e9b935b06c69f0 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:52 +0200 Subject: [PATCH 305/336] New translations index.adoc (German) --- docs/de/modules/contribute/pages/index.adoc | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 docs/de/modules/contribute/pages/index.adoc diff --git a/docs/de/modules/contribute/pages/index.adoc b/docs/de/modules/contribute/pages/index.adoc new file mode 100644 index 0000000000..8c48fa9bd7 --- /dev/null +++ b/docs/de/modules/contribute/pages/index.adoc @@ -0,0 +1,9 @@ += Contribute + +You don't need to know how to code to contribute to Decidim, just having available time and attitude. + +Learn more about https://github.com/decidim/decidim/blob/develop/CONTRIBUTING.adoc[How to contribute to Decidim] in GitHub. + +* xref:contribute:governance.adoc[Governance] +* xref:contribute:translations.adoc[Translations] +* xref:mitwirken:documentation.adoc[Documentation] \ No newline at end of file From 86760e602611543de733af19757d3e8ea33f1a96 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:53 +0200 Subject: [PATCH 306/336] New translations translations.adoc (German) --- .../contribute/pages/translations.adoc | 55 +++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 docs/de/modules/contribute/pages/translations.adoc diff --git a/docs/de/modules/contribute/pages/translations.adoc b/docs/de/modules/contribute/pages/translations.adoc new file mode 100644 index 0000000000..a06acc9fb4 --- /dev/null +++ b/docs/de/modules/contribute/pages/translations.adoc @@ -0,0 +1,55 @@ += Translations + +For translating Decidim we use a web platform called Crowdin, accesible in https://translate.decidim.org/ + +At the moment is translated in more than 18 languages: Catalan, Czech, Dutch, Finnish, French, German, Greek, Hungarian, +Italian, Japanese, Latvian, Norwegian, Polish, Portuguese, Romanian, Slovak, Spanish and Swedish. + +As Decidim is a living and in constant development process is necessary to maintain, improve and specially update the translations when there's a new release. For doing so: + +== Existing language + +You can ask for permission in the language of your choosing, for instance for Esperanto: + +image::translation-join-01.png[Join to Decidim Translations] + +image::translation-join-02.png[Message in Join Decidim Translations] + +== New language + +If your language isn't created yet, then we need to do it as it's necessary to make some adjustments. You need to contact us by the https://decidim.org/contact[contact form]. + +== How it works + +If you're curios, in the technical level we have a bot (the great decidim-bot) that periodically makes a PR to the relevant branches (last releases and develop). + +image::translation-bot.png[Decidim Bot in GitHub] + +If you want to try a new translation before it gets released, then you can do so by pointing to the xref:install:update.adoc#_from_git_repositories[relevant branch], for instance `chore/l10n/develop`. + +=== Checking locales + +You can make sure new translations are complete for all languages in your application with: + +[source,console] +---- +bin/rails decidim:check_locales +---- + +By default this will check against develop branch. If you're pointing to other branch in your Gemfile, then you can use the TARGET_BRANCH environment variable: + +[source,console] +---- +TARGET_BRANCH=release/0.22-stable bin/rails decidim:check_locales +---- + +Be aware that this task might not be able to detect everything, so make sure you also manually check your application before upgrading. + +If you have 100% in your Crowdin language then you can be pretty sure that everything is translated. + +== Rules + +* All the translations always start from English. If you want to propose changes to the English language then you need to do it in the Ruby on Rails translations files directly (like `decidim-core/config/locales/en.yml`) +* For every language (except English), you can't do changes in the Ruby on Rails translations files directly (for instance `decidim-core/config/locales/es.yml`) as these translations could get invalidated by decidim-bot in the future. See "How it works" section. +* We try to speak of Participants instead of Users when it's possible +* On Spanish and Catalan we follow https://en.wikipedia.org/wiki/Gender_neutrality_in_Spanish[Gender Neutrality] \ No newline at end of file From f4e7db0566369e710957b058ed70335d62921370 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:54 +0200 Subject: [PATCH 307/336] New translations components.adoc (German) --- .../de/modules/features/pages/components.adoc | 183 ++++++++++++++++++ 1 file changed, 183 insertions(+) create mode 100644 docs/de/modules/features/pages/components.adoc diff --git a/docs/de/modules/features/pages/components.adoc b/docs/de/modules/features/pages/components.adoc new file mode 100644 index 0000000000..2e847c7acf --- /dev/null +++ b/docs/de/modules/features/pages/components.adoc @@ -0,0 +1,183 @@ += Components + +:page-partial: + +*Components* are participatory mechanisms that allow interactions among the platform Participants within each of the Participatory Spaces. + +== Proposals + +*Proposals* are Decidim's most important component. They can be defined as the minimum decision unit. + +Proposals can be made by any of the following *types of creators*: + +* by the *official organisation* managing the platform +* by registered *individual participants* +* by a *group* of registered participants +* from a *meeting* as a result of a discussion or collective deliberation + +Once a proposal has been published, it can be *moderated*, *amended* or *withdrawn* by its author(s). + +Proposals can be *accepted*, *rejected* or kept in an *evaluating* state. Proposals can also be imported to a new phase, so they can be re-written or elaborated in different stages. + +Other features associated with proposals include: + +* *Proposal creation wizard*: While a proposal is being created, the participant is accompanied through the process, which is divided into different steps, with contextual help and previews before the proposal is published. +* *Modification and withdrawal of proposals*: a proposal’s author can modify and/or withdraw it before the support stage opens. +* *Version control*: this makes it possible to keep a record of all the changes made to a proposal, as well as code-generation to verify the proposal’s integrity. +* *Detecting similarities*: This allows anyone making a new proposal to find similar ones previously made on the platform, thereby avoiding duplications. +* *Connections between proposals*: proposals made can be connected to one another using links in the comments section, showing related proposals as cards and giving notifications on the existence of a new connection. +* *Endorsement of proposals*: participants and collectives can endorse proposals and such public endorsement will be shown within the proposal. Followers of the endorsers will be notified that the followed endorsed the proposal. +* *Amendments*: any participant can edit a proposal’s text and a sub-proposal will be created in Amendment Mode (as Pull Request in Github). This sub-proposal can gather endorsements and supports. Besides, the proposal’s author can accept or reject the amendment (or sub-proposal). Where a sub-proposal is rejected, its author can convert it into an official proposal. +* *Collaborative draft for proposals*: Decidim permits collaboration and co-creation over proposals. It incorporates the following features: +** Creating rough drafts with numerous authors. +** Listing of collaborative drafts +** Comments in drafts +** Asking for help from and accepting the help of other collaborators + +== Endorsements + +include::admin:partial$development.adoc[] + +Participants can endorse proposals. Such endorsements can be interpreted as votes, signatures or any other format that demonstrates a positive agreement in accordance with the political will itself. +Participants can issue a single endorsement for each proposal they wish. The number of endorsements can be limited for each participant. +There is no limit to the number of proposals that can be endorsed. + +If the endorsement is a vote, it is possible to configure from the administration panel the *display settings for the voting results*, either during or solely after the voting period. + +There is a *special form used to vote for participatory budgets* which allows participants to vote by "spending" an amount equivalent to the budget in question among the proposed projects. The number of votes is limited here by the selected projects’ accumulated spending amount. + +== Results + +The *results* component is used to turn proposals into results and give official responses to them. +It is possible to merge various proposals into a single result or to create different results related to the same original proposal. + +Results gather information about the original proposal(s), like the meetings where they were created, discussed and debated and the endorsements received. + +== Debates + +Discussions and debates can be opened on questions and specific issues established by administrators or participants. + +== Surveys + +The *surveys* component can be used to design and publish surveys and to display and download their results. + +* *Survey configuration tool*: allows administrators to create questions and answers (open, test types, multiple selection etc.) and launch the survey, as well as download the responses in CSV format. +* *Survey interface for participants*: allows participants to respond to survey questions. + +== Sortitions + +The *sortition* component allows to select a number of proposals (e.g. candidates for a jury) with random, yet reproducible, procedures that guarantees non-biased and uniform distributions. + +== Informative pages + +The *pages* component is used to create informative pages with rich text formatting, embedded pictures and videos. + +== Blogs + +The *blog* component makes possible the creation of posts or news associated with a participatory space, and to navigate them chronologically. + +*Comments associated* with blog entries will be treated like the platform’s other comments, as described below. + +== Newsletter + +The *newsletter* component makes possible to send emails to everyone registered in the platform or, more selectively, to those who participate in a specific space who have agreed, under the terms and conditions of use, to receive this information newsletter email. Personalised emails are sent out addressed directly to the name of the user in the language chosen by the user by default. + +Participants will automatically and directly be able to *unsubscribe* through the email itself by clicking on a link in it and it will also be possible to *track the number of visits* generated by the newsletter. + +== Meetings + +The *meeting* component offers organizations and participants the opportunity to: + +* convene meetings, defining its structure and content +* *categorise* the meeting within a space. +* create *proposals associated with meetings* +* *publish* minutes +* upload *photos* of the meeting + +Meetings relating to a participatory space (a specific process or an assembly) can be shown on a *map* and be *ordered by date or category*. Besides, all the meetings can be shown in *calendar mode*, with the possibility of exporting them to a mobile phone calendar or other apps. + +Some of the meeting component’s advanced features include: + +* *Registration and attendance system*: +** This allows to manage the *type of registration* (open and automatic, closed and accessible only to certain types of participants, etc.), to establish the **number of places **available for attendees, to reserve a place, to do *manual registrations*, sent out *Invitations*, to define the *conditions* that need to be accepted in order to be able to attend the meeting (e.g. image rights release), and *registering the attendance* of participants. +** It allows participants *to register* for a meeting, request *a family reconciliation service* (playroom, childcare space) and to obtain an *accreditation code* for attending at a meeting. +** Those registered who have attended a meeting will have *special access* enabling them to evaluate the meeting or make comments, etc. +** Participants or administrators will be able to receive *notifications* on registration-period openings, the number of places remaining for registrations, reminders of meetings, and the publication of minutes. +* *Managing agendas*: allows to define the duration of meetings, to create agenda’s items and sub-items, title, content, and estimated duration. Participants can propose agenda items. +* System for *drafting, publishing and validating meeting minutes* [IMPORTANT NOTE:This is currently implemented differently]: +** Minutes can be uploaded in video, audio or text format. +** Minutes in text mode are associated with a *collaborative writing board* integrated into Decidim. +** Minutes go through 4 *stages of preparation*: 1. Collaborative writing during the meeting; 2. Preparing the official draft of the minutes; 3. Draft-amendment stage; 4. Publication and final validation of the minutes. +** Minutes can be *commented on* using the comments component. +** *Accompanying documents* may also be added to the minutes. +* *Auto-convening*: verified participants will be able to convene meetings directly through the platform , with support from a certain number of other participants, the meeting will be publicly activated and convening participants will have access to the administration panel [IMPORTANT: not implemented yet] +* *Displaying and exporting meetings*: meetings can be displayed in map mode (for spaces or generally on the platform) or in calendar mode, and can be exported to agenda and calendar managers (in iCalendar format). + +== Search engine + +*The search engine* allows participants to perform searches across all of the platform’s indexable content, both generally and specifically, by searching within a specific participatory process or inside its components (proposals, results, etc.), through advanced searches. + +== Secondary components + +There are other components that only exist on top of basic components are. These components are: + +=== Comments + +The *comments* component enables participants to take part on a deliberative process on an issue or proposal. +Participants can respond to them, endorse them and receive notifications about responses. +Comments can be *ranked* in chronological order or by number of votes in favour. + +=== Participatory texts + +Participatory texts are defined as an ordered collection of proposals that make up a document with complete text. Participation in the text stems from interaction with the proposals that form it. This component basically allows three operations: + +* *Breaking down a text document into ordered proposals* from a document in ODT, XDOC, MarkDown and HTML formats. If the text is structured in sections and subsections, ordered proposals will be created from the lower level subsection; if the text is not structured, a proposal will be created for each paragraph of text. The interface allows proposals to be re-edited, merged, separated, given titles, etc. +* *Composition of proposals in a unified text*: based on a series of proposals, these may be ordered and generate a unified and downloadable text. +* *Viewing and interacting* with documents composed of proposals: A collection of proposals will be shown as a unified text and may be amended or comments can be added in the margin. + +=== Accountability + +The *accountability* component works like a project management system built into the platform. . It offers the possibility of: + +* subdividing results into projects or sub-projects +* defining and applying progress in implementation statuses (0% to 100% implemented) around their implementation +* displaying the extent of the results’ implementation grouped by categories and scopes + +Results, projects and statuses can be updated through a CVS, or manually by the administration interface. + +=== Conferences + +The *conference* component allows an organization to join up a series predefined meetings (chats, workshops etc.) related to a participatory space. + +Configuration settings include: + +* Conference-page generator, which enables the creation of an *internal website* with information about the event. +* The option to generate an *interactive and downloadable programme* on the event (where there are guest speakers, it will include their name, position, organisation, a small biography and links to other websites). +* Email *invitations*. +* Registration system +* *Automatic diploma and certificates of attendance creation* for those who request it, through a support panel that an administrator can verify. +* Links to the event *video and materials* platforms in the programme and documents. +* Automatic links to digital-media websites covering the event. +* The ability to following events through *social networks* (e.g. by incorporating a Twitter feed). + +== Participatory Spaces and Components + +*Participatory Spaces* and *Components* can be combined in different ways. +For example, the various phases of a Participatory Budgeting Process (Participatory Space) can combine *Components* like this: + +1. At an early phase public *Meetings* can be opened for citizens to analyze different needs classified by districts. +1. In turn these *Meetings* can lead to the design of a *Survey*. +1. The *Survey* results can then be used to define a set of categories for projects to be proposed. +1. The *Proposal* component can then be activated for Participants to create and publish their projects as solutions to the identified needs. +1. These *Proposals* can then be commented and, after two weeks of deliberation, *voting* can be activated to select among the projects with a budget-expenditure system. +1. Participants can then be called to a public *Meeting* to evaluate the results. +1. An assessment *Survey* can be launched afterwards for those who could not attend the *Meeting*. +1. Finally, the *Accountability* component may be activated to monitor the degree of execution of the selected projects, and people can comment on it. + +== Displaying components: Cards + +Component items have their individual page but are also displayed as *cards* throughout the platform. + +[#card-anatomy-fig] +._Decidim's proposal card anatomy._ +image::card-anatomy.png[] \ No newline at end of file From 4dfc7a5a12be0bcaf592230109f09ea771c37625 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:56 +0200 Subject: [PATCH 308/336] New translations general-description.adoc (German) --- .../features/pages/general-description.adoc | 63 +++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 docs/de/modules/features/pages/general-description.adoc diff --git a/docs/de/modules/features/pages/general-description.adoc b/docs/de/modules/features/pages/general-description.adoc new file mode 100644 index 0000000000..c54b27a835 --- /dev/null +++ b/docs/de/modules/features/pages/general-description.adoc @@ -0,0 +1,63 @@ += General description and introduction to how Decidim works +:page-partial: + +http://decidim.org[Decidim], from the Catalan for "let's decide", is a digital infrastructure for participatory democracy, built entirely and collaboratively as free software. More specifically, Decidim is a web environment (a _framework_) produced in _Ruby on Rails_ that allows users to create and configure a website platform or portal, to be used in the form of a social network, for democratic participation. The portal allows any organization (local city council, association, university, NGO,trade union, neighborhood or cooperative) to create massive democratic processes for strategic planning, participatory budgeting, collaborative regulatory design, urban spaces design and elections. It also enables the organization of in-person meetings, signing up for them, the publication of minutes, proposing points for the agenda and receiving notifications of the results. Decidim can also help organizing governing bodies, councils or assemblies, the convening of consultations and referendums or channeling citizen or member initiatives to impact different decision making processes. All together Decidim makes possible to digitally structure a complete system of participatory democratic governance for any organization. + +To understand in detail how Decidim operates, a distinction must be made between participatory _spaces_ and _components_ (see <>). + +[#functional-architecture-fig] +._Summary diagram of Decidim's functional architecture showing a combination of components in participatory spaces. The "Vote*" component allows a variety of voting systems, expressions of support or allegiance for a proposal._ +image::functional-architecture-en.svg[width=2000] + +* *Participatory spaces.* These are the frameworks that define how participation will be carried out, the _channels_ or means through which citizens or members of an organization can process requests or coordinate proposals and make decisions. _Initiatives_, _Processes_, _Assemblies_ and _Consultations are all participatory spaces. Specific examples of each of these include: a citizen initiative for directly changing a regulation (_Initiative_); a general assembly or workers’ council (_Assembly_); a participatory budgeting, strategic planning, or electoral process (_Processes_); a referendum or a call to vote “Yes” or “No” to change the name of an organization (_Consultation_). +* *Participatory components.* These are the participatory _mechanisms_ that allow a series of operations and interactions between the platform users within each of the participatory spaces. The following are participatory components: _comments, proposals, amendments, votes, results, debates, surveys, sortitions, pages, blogs, newsletters_ and _meetings_. Other components that build on top of basic components are: _participatory texts_, _accountability_ and _conferences_. + +[#spaces-components-fig] +._Decidim displays participatory spaces on the top menu (dark) and components are displayed on the bottom menu (white)._ +image::spaces-components.png[] + +The ways in which spaces and components interact is the following. Users of the platform (participants) interact through participatory mechanisms known as components which afford a variety of features for the various participatory _spaces_. In other words, participatory _spaces_ such as _Initiatives_, _Assemblies_, _Processes_ and _Consultations_ have components at their disposal which work together as participatory mechanisms. The more notable components include in-person _meetings_, _surveys_, _proposals_, _debates_, _results_ and _comments_. So, for example, the various phases of a participatory budgeting process can combine components in the following way: at an early phase public meetings can be opened for citizens to analyze different needs classified by districts. In turn these meetings can lead to the design of a survey. The survey results can then be used to define a set of categories for projects to be proposed. The proposal component can then be activated for participants to create and publish their projects as solutions to the identified needs. These proposals can then be commented and, after two weeks of deliberation, voting can be activated to select among the projects with a budget-expenditure system. Participants can then be called to a public meeting to evaluate the results, and an assessment survey can be launched afterwards for those who could not attend the meeting. Finally, the accountability component may be activated to monitor the degree of execution of the selected projects, and people can comment on it. What makes Decidim particularly powerful is this combination of components within spaces, which provides an organization with a complete toolkit to easily design and deploy a democratic system and adapt it to the organization's needs. + +Decidim's top navigation bar displays the different types of active *spaces* of the platform. *Processes* is a space that allows to create, activate/deactivate, and manage various participatory processes. These are distinguished from other spaces by being structured in different phases within which all of the components can be incorporated. Examples of participatory processes are: an election process for members of a committee, participatory budgeting, a strategic planning process, the collaborative writing of a regulation or norm, the design of an urban space or the production of a public policy plan. *Assemblies* is a space that offers the possibility of setting decision-making bodies or groups (councils, working groups, committees, etc.) that meet up periodically, detailing their composition, listing and geolocating their meetings, and allowing to take part in them (for instance: attending if the seating capacity and nature of the assembly so permits, adding items to the agenda, or commenting on the proposals and decisions taken by that body). *Consultations* is a space that makes it possible to coordinate referendums, trigger discussions and debates, get voting results published; it can be connected to a secure e-voting system. *Initiatives* is a space that allows participants to collaboratively create initiatives, define their trajectory and goals, gather endorsements, discuss, debate and disseminate initiatives and define meeting points where signatures can be collected from attendees or debates opened to other members of the organization. Initiatives is a special kind of space by which members of the organization can trigger actions that are generally restricted to elected bodies or platform administrators, by collecting (digital) signatures. The organization can define the types of initiatives and set up the number of signatures that are required to trigger the expected result (e.g. to call for a consultation). + +The *components* (also called features) are displayed as a second level menu with white background within spaces (as displayed in <>). The *collaborative draft* for proposals facilitates the collaborative creation of proposals as well as the monitoring and control of changes throughout the process. The *proposals* component allows a user to create a proposal using a creation wizard, compare it with existing ones, publish it in the platform and include additional information like geolocation or attached documents and images. This component also makes possible to navigate, filter and interact with a set of proposals. The proposal component has plenty of configuration options, and different features can be activated or de-activated in time. One such feature is *voting* or *support*: it offers organizations the possibility of activating different voting or support systems around proposals: unlimited, limited to a given threshold, weighted, cost-based, etc. Proposals can also be imported to a new phase, so they can be re-written or elaborated in different stages, where they can also be subject to *amends* which can be voted separately, accepted and merged or rejected, to improve proposals democratically. The *results* component is used to turn proposals into results and give official responses concerning their acceptance or rejection, merging various proposals into a single result or creating different results related to the same original proposal. The *accountability* component offers the possibility of subdividing results into projects, defining and applying progress statuses around their implementation, as well as displaying the extent of the results’ implementation grouped by categories and scopes. In this sense the accountability component works like a project management system built into the platform. The *surveys* component can be used to design and publish surveys and to display and download their results. The *sortition* component allows to select a number of proposals (e.g. candidates for a jury) with random, yet reproducible, procedures that guarantees non-biased and uniform distributions. The *comments* component enables users to add comments, to identify the comment as being in favor, against or neutral in relation to the commented object, to vote comments, respond to them and to receive notifications about responses. The *participatory texts* component can be used to convert lengthy text documents into various proposals or results and, vice versa, to compose and display a unified text based on a collection of proposals or results. This makes possible to work with a full document as continuous text in participatory manner. The *pages* component is used to create informative pages with rich text formatting, embedded pictures and videos. The *blog* component makes possible the creation of posts or news, and to navigate them chronologically. The *meeting* component offers organizations and participants the opportunity to convene meetings, determine their location and time, registration and management of attendees, to define the structure and content of the meeting as well as publishing the minutes, and the resulting proposals. The *conference* component allows an organization to create a website for a big event by joining up a series predefined meetings (chats, workshops etc.), putting together a unified program and managing attendees. The *newsletter* component makes possible to send emails to everyone registered in the platform or, more selectively, to those who participate in a specific space. + +Participants can carry on different *types of actions* within the platform: + +[start=0] +. They can *navigate* and search for information +. They can *create* contents of different types (e.g. proposals and debates). +. They can *vote, support or sign* all three modes allow for participants to aggregate their preference or will for a specific consultation question, proposal or initiative respectively (the difference between these three types of actions involve different levels of security and anonymity: signatures can be audited and attributed to a participant, supports cannot, in order to prevent coercion, while votes involve higher cryptographic guarantees than supports). +. They can *comment* on any object of the platform (proposals, debates, results, sortitions, etc.). +. They can *endorse* any content, meaning that they can publicly declare they support it or find it relevant, with the participants following it then receiving notifications. +. They can *follow* other participants, a participatory process, an initiative, a specific proposal, etc. and receive notifications. +. They can *sign up* for a meeting. +. They can also *share* and *embed* content out of the platform, sharing the link to other social networks and embedding content on other sites. + +Component items (e.g. a proposal, a blog post, a meeting) have their individual page but are also displayed as *cards* throughout the platform, cards being a major design interface to interact with components. <> displays a proposal card with the different types of data and interactions identified within the card. + +[#card-anatomy-fig] +._Decidim's proposal card anatomy._ +image::card-anatomy.png[] + +The users who participate in Decidim can be grouped into three different categories: + +* *Visitors* have access to all of the platform's content without having to sign up or provide any information. +* *Registered* participants can create content and comments, sign-up for meetings, endorse content, follow other participants and objects of the platform, customize their profile and receive notifications, mentions and private messages. By choosing a username and password, accepting the user agreement, and providing an email account (or using an account for several social networks) participants become registered. Registered participants can also have their account officialized (meaning their username is accompanied by a special symbol indicating they really are who they claim they are on their profile). +* *Verified* participants can make decisions. In order to fall under this category they must first be verified as members of the organization, citizens of the municipality, or constituents of the decision-making group (an association, community, collective etc.). Decidim offers different ways to carry out this verification. Once verified, participants will be able to take decisions by supporting proposals, signing initiatives and voting in consultations. + +Administrators can *manage permissions* for registered or verified users selectively. For example proposal creation can be activated for both registered and verified users but supports to proposals only for verified users. It is also possible (although rarely recommended) to consider all registered users as verified and to grant them decision making powers. + +There are different types of administrators: *administrators* of the whole platform or of specific spaces and components, they can also be *moderators* (with the exclusive power of moderating proposals, comments or debates) or *collaborators* that can read unpublished content, create notes and responses to proposals. + +Participants can register as an *individual* or as a *collective* (associations, working groups, etc. within the main organization). User *groups* might also be created so that individuals can be associated to a *group*. Decidim allows participants belonging to such a group to express or act individually or embodying the group identity: when an action is carried the platform prompts the participant to choose wether she wants to act as herself or as the group she belong to. + +Participants can not only navigate the content of Decidim through the top menu and move down the architectural hierarchy, from a space to its different components; they can also get information through the *search engine*, or via *notifications*. Participants can also talk to each other by internal messaging or *chat*. + +The participant's *profile* makes possible to read notifications, manage followers, and monitor different gamification and engagement badges. + +The *home page* of the platform is fully customizable: it can display different types of banners, call-to-action buttons, it can also display statistics and interactive visualizations, activity streams, and maps with the upcoming meetings. + +The content of the platform can be classified by different criteria. A participatory space and its contents (e.g. a participatory process or the proposals within) can be (independently) assigned a *scope*. Scopes are defined for the whole platform, and they can be thematic or territorial (for example, an assembly can be assigned to a specific theme or subject, like "ecology", and to a specific territory, like a district within a city). Content within a space-instance can be assigned to a *category* or sub-category (e.g. topics) that are specific for such a space-instance. For example, the categories "sport facilities", "parks" and "schools" can be created for a participatory budgeting process, and proposals will be assigned to these categories. *Hashtags* can also be freely created and introduced in the body text almost anywhere in the platform (proposals, debates, comments, process description, etc), both by participants and administrators, to classify content and make it searchable. + +Unlike other existing platforms, Decidim’s architecture is *modular*, *scalable*, easy to *configure*, and *integrated* with other tools or apps (data analysis, maps, SMS, mail, social networks, etc.). The platform has been designed in such a way that processes, assemblies and mechanisms can be set up easily and deployed from an administration panel. No knowledge of programming is required to install, configure and activate it. The participatory spaces and components can be developed, activated and deactivated independently. \ No newline at end of file From 265a457bc03984282d55c51aa5708a06cdbf6e5c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:57 +0200 Subject: [PATCH 309/336] New translations general-features.adoc (German) --- .../features/pages/general-features.adoc | 77 +++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 docs/de/modules/features/pages/general-features.adoc diff --git a/docs/de/modules/features/pages/general-features.adoc b/docs/de/modules/features/pages/general-features.adoc new file mode 100644 index 0000000000..176164832f --- /dev/null +++ b/docs/de/modules/features/pages/general-features.adoc @@ -0,0 +1,77 @@ += General features + +:page-partial: + +Below, we will outline a series of the platform’s general features and characteristics which do not appear in the spaces or components, or in the features directly associated with participants. + +== Installation and settings + +Decidim **can be easily installed **using the command prompt in any GNU/Linux server with the following installed services: PostgreSQL 9.4+, Ruby 2.4.1, NodeJS with yarn (JavaScript dependency manage), ImageMagick and PhantomJS. An automatic installation script allows you to deploy the whole dependency system, libraries, databases and other automatically required services in Heroku or Docker [feature expected for 2018Q4]. + +The portal’s *settings* are **customisable **in the following fields that are filled out on a form from the administration panel: Name of the portal, social network profiles (Twitter, Facebook, Instagram, YouTube, Github); brief description; welcome text; default language; home image; the organisation’s logo; favicon; reference prefix (unique identifier that will apply to the portal’s elements) and the organisation’s URL. + +== Integration with other services and compatibility/creation of additional services + +Decidim can be easily integrated with the following services that can be installed or configured with Decidim: + +* *OpenStreetMap*: to show events and proposals with geo-location +* *Piwik*: website traffic analysis +* *Pad*: collaborative real-time writing boards (technology to be determined) +* *Digital identity and signature*: integration with OAuth2 digital-identity management system, systems based on blockchain and recognised institutional digital identity and signature management systems. +* *Distributed filing system*: Disseminating or copying proposals or other elements from the platform in a distributed filing system (blockchain or IPFS type) [Missing feature]. +* *Microblogging*: integration/compatibility with a standardised and open microblogging protocol/service such as GNU Social or StatusNet type for participants’ activities (proposals, observations and messages) [Missing feature]. + +Decidim automatically generates the following services besides the ones that can be browsed on the website or accessed through an API: + +* *SMTP*: sending emails. +* *Calendar*: integration and compatibility with calendar-management systems and automatic creation and updating of events calendars, etc. + +== Multitenancy + +The multitenancy of the platform can be used on the basis of a single installation. In other words, a single instance of Decidim software allows to deploy as many portals (tenants) as you want under specific settings for each of the tenants. That way an organisation can create participatory portals for its sub-organisations or various organisations can share a server and reduce the maintenance costs of its portals. + +== Multi-language + +Decidim is a *multi-language* platform. Its available languages will be configured during its installation. Menus, administrative forms and, generally, the platform's fixed texts are available in several languages (Spanish, Catalan, Basque, Italian, French, Dutch and Finnish). A **collaborative translation **system in https://crowdin.com/project/decidim enables new languages to be incorporated into the platform. + +As for content, once the official languages of the instance have been set during the installation, all the content that is created from the administration panel has the option of being generated in these languages. The administration panel allows *content to be managed in several languages* through tabs. The content generated by users is displayed on the platform in a single language (the one chosen by the participant through the language selector in the upper part of the menus or automatically through its browser's language settings). + +== Statistics, open data and downloads + +Besides the application programming interface (API) which automatically provides access to public data, Decidim’s home page features a *general statistics table* with the following fields: number of participants, processes, proposals, results, meetings, observations and votes. + +Another *statistics table for each participatory process* shows the number of meetings, proposals, votes and results of a specific process. + +The administration panel lets you **export the proposals, results and observations **of a participatory process in CSV and JSON format and responses to surveys for processing and/or integration with other management systems. Participants can **download the results of a participatory process and the extent of its implementation **through a CSV file. + +Decidim also has a **data-display component **at its disposal on the platform’s general level and on a specific level (showing data from a specific Participatory Space) [Feature expected for 2018Q2-3, AjB-Lote2Mod4]. The following are included among the graphics that are displayed: + +* **Interactive graphics **in the form of a time line showing the development of the various components’ counters. +* *Heat map* of all the meetings, proposals or other content with geo-location tags. +* **Interactive diagrams **(bar or pie charts) with the results of a process (amounts of each of the participatory budget projects, filter by category and status of the proposals - whether selected or not, etc.) + +All of these displays are accompanied by an **option for downloading data **in CSV format [Feature expected for 2018Q2-3, AjB-Lote2Mod4]. + +== API, adaptable website design and mobile app + +Decidim has an application programming interface or API which is a series of independent service calls and data from Decidim's website interface. This allows third parties to develop services on the platform, automatically release data or develop new interfaces, or integrate other services with decidim. + +The API comes with *documentation* and a *formal participatory ontology* [Not completed] + +Decidim's website *design* is completely *adaptable* (_responsive_), using _mobile-first_ design philosophy (designed first for mobiles and later extended to desktop systems and tablets). + +Both the website's design and the API enable the development of mobile apps for Decidim, and a *Mobile App* is expected to be developed soon. + +== Content-classification systems + +As for content classification, the following to be distinguished and adjusted in Decidim: fields, categories and labels (or tags). + +*Scopes* are generic throughout the platform and divided up into *territorial* and **topic **types. Territorial areas, once defined, allow the spaces’ elements to be classified by territory (e.g. if a process or a body or an initiative affects a district or two, the entire city, a region or country, depending on the organisation). Topic areas are likewise defined for the entire platform and allow classification of the various elements of the participatory spaces. + +*Categories and subcategories* are used for classifying content within the various spaces and are defined for each of the levels of the spaces. So, for example, a participatory process may include several categories and subcategories (the process administrator defines them) whereas the process’ meetings, surveys, proposals and other components can be classed under these categories. + +In contrast to fields and categories, *labels* or tags are cross-cutting and freely defined by participants and can apply to any level or component. Labels can be created, embedded and defined in the administration panel. A label-suggestion system allows the people taking part to choose labels similar to the ones that are they are suggesting for labelling any of the platform's elements. Elements can be browsed by labels and the most popular labels displayed. + +== Contextual help system, usability and evaluation tests + +Decidim includes *editable contextual help* for guiding individual and administrative participants in using the platform. It also includes a **automatic evaluation surveys** to be conducted on participants for the purposes of identifying usability and participatory-procedure errors and improving the democratic quality experience of the software . \ No newline at end of file From ebf50b8f10b7ce1ff273919c88409cee4d4f312c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:58 +0200 Subject: [PATCH 310/336] New translations participants.adoc (German) --- .../modules/features/pages/participants.adoc | 53 +++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 docs/de/modules/features/pages/participants.adoc diff --git a/docs/de/modules/features/pages/participants.adoc b/docs/de/modules/features/pages/participants.adoc new file mode 100644 index 0000000000..305e9fafeb --- /dev/null +++ b/docs/de/modules/features/pages/participants.adoc @@ -0,0 +1,53 @@ += Participants + +:page-partial: + +*Participants* of Decidim can be grouped into three different categories: + +* *Visitors* have access to all of the platform's content without having to sign up or provide any information. +* *Registered* participants can submit proposals and comments, sign-up for meetings, endorse content, follow other Participants and receive notifications, mentions and private messages. +Users may register *directly* on the platform or through gateways of other *social networks* (Facebook, Twitter or Google+). To register directly, users will need to associate a email account and a password to the user-account. + Registered participants can also have their account officialized (meaning their username is accompanied by a special symbol indicating they really are who they claim they are on their profile). +* *Verified* participants can make decisions. Decidim offers different ways to carry out this verification. + +Administrators can *manage permissions* for *Registered* users and *Verified* users selectively. For example, _proposal creation_ can be activated for both Registered and Verified users but _supports to proposals_ only for Verified users. + +== Public registration of administrative activity + +The manual verification of participants, as well as other administrative actions can create vulnerability or may enable the administrators to use the platform in an abusive manner. To avoid it, Decidim includes a *public register of administrative activities* so these actions can be publicly and transparently audited. + +== User profile and personal settings + +There is a **user-profile page **where participants can make **changes to their data **(such as email account, password etc.), upload and enable an *avatar* image, set notifications or delete their account. + +The user-profile page also allows participants to add *additional information* to include interests and skills, voluntarily and by selecting the level of visibility of that information. This allows personal notifications to be sent and participants can be matched with others for collaborations. + +== Monitoring and notifications + +Participants receive *automated notifications* regarding the content they have created: responses to comments and comments on their proposals, as well as the results of their proposals (whether accepted or rejected). + +Besides automated notifications, participants can decide to **follow any element** of the system (other proposals, results, processes, assemblies, initiatives, groups or users etc.), and receive notifications. + +== Communication among participants + +**Instant messages **can be sent to participants through the platform, who will receive an email notification. + +*Mentions* can also be added (in the comments section) to any registered user and a notification will be automatically sent. + +== User groups + +Participants can register with the platform as members of one or several organisations/collectives. Once the organisation and membership status have been verified, participants can carry out actions (make proposals or submit comments, etc.), with their user or with the organisation name. + +User groups can also manage user permissions and administration roles assigned to groups, as well as private debate spaces or share information among group users, for example, who attended an in-person meeting. [Feature currently missing] + +== Engagement + +Decidim has a series of features geared to _gamifying_ the platform, to *attract and keep a growing number of participants interested*, as well as to promote practices that boost democratic quality and collective intelligence in participation [the gamification system is expected for 2018Q2-3, AjB-Lote1]. + +The gamification system includes two modes, one centred on users and the other on proposals. + +* The **user-centred **mode incorporates a *points system* based on several criteria (degree of detail of its user profile, number of invitations to others on the platform, number of proposals made and commented on, number of comments, number of endorsements obtained, number of followers, etc.) + +The combination of these and other indicators is used for generating gamification routes for each user and defining threads such as: most participatory person in the district, leadership in discussions and debates, etc. + +* Gamification *centred on proposals/initiatives* allows promoters, signatories and followers to boost interaction with them by incorporating several *metrics* (number of times that the proposal is shared in social networks, degree of controversy (number of positive and negative comments), quality of deliberation (depth of observation tree), number of hits received, etc. \ No newline at end of file From 8dc9233eacdda23b3166f7f5f52cb7ea059a3caf Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:01:59 +0200 Subject: [PATCH 311/336] New translations participatory-spaces.adoc (German) --- .../features/pages/participatory-spaces.adoc | 66 +++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 docs/de/modules/features/pages/participatory-spaces.adoc diff --git a/docs/de/modules/features/pages/participatory-spaces.adoc b/docs/de/modules/features/pages/participatory-spaces.adoc new file mode 100644 index 0000000000..69a8dcab3e --- /dev/null +++ b/docs/de/modules/features/pages/participatory-spaces.adoc @@ -0,0 +1,66 @@ += Participatory spaces + +:page-partial: + +Participatory spaces define the main participatory channels. They are displayed in the platform's main upper menu. + +The basic logic behind Decidim's structure is that *components work together in the participatory spaces*. There are different types of spaces (initiatives, processes, consultations and assemblies) and various instances within each type (a process for an election and another for participatory budgets, council body for neighbourhoods and another for workers, an initiative to call for a change in legislation and another for something to be included in a plenary meeting agenda, etc.). + +== Processes + +Participatory processes require a general *configuration* form with the following fields: Title or name of the process; short name for URL; hash tag (used as a reference for communications on social networks); short description; long description; home page image; banner image; date of start and finish; field; promoter group (responsible for the participatory process on a political level, may be the local authority or a group made up of the authority’s experts/politicians and associations and other organisations); who it is aimed at; goal of the participatory process and participatory structure. The participatory process allows *accompanying documents* to be added. + +Participatory processes are divided into *stages* (e.g. 1. Information and convening stage; 2. diagnostics stage; 3. proposals stage; 4. prioritisation stage; 5. decision stage; 6. evaluation stage and 7. results-monitoring stage). Each stage includes the following configuration fields: title, description, start date, end date. + +*Highlights of announcements or texts* may also be displayed in the processes, both on the home page and in the heading of each component (proposals, discussions and debates, etc.) Different messages can be configured depending on the particular stage of a process. + +A *participatory process configuration tool* enables the simple activation and deactivation of stages and their components. Decidim's process configuration tool is one of its most powerful features, enabling total flexibility in designing participatory processes according to the various realities and forms of citizen participation. + +The feature of **process groups **enables various processes to be grouped, such as by the Participatory Budgets of different districts or neighbourhoods. + +Participatory processes may have one of the following *process statuses*: 0) published or unpublished; 1) open (started); 2) closed (the participatory process has ended but its results are still under way; 3) finished (both the process and its results phase are complete) and 4) future (has not yet started). + +A process can be **highlighted** (which increases its visibility on the homepage). + +There is also the possibility to **copy participatory processes** from the administration panel. This feature enables process models to be designed and copied so that certain details can be configured within the new processes, avoiding the need to create them from scratch. + +== Assemblies + +Decidim allows the **creation and configuration** of participatory or government *assemblies* (government or participatory bodies; councils; work groups, etc.) defined as structured participant groups which, whether on an individual or representative level, meet up periodically, with the authority to make proposals and decisions. + +The *assemblies section* allows you to see a full list of all of the assemblies that are activated and configured from the administration panel. The basic *settings* require the following fields to be completed for each body: name; image; scope (global, territorial or sectoral); body’s function (purpose of action); type of body (government, executive, consultative / advisory, participatory, work group, commission etc.); creation date; created on the initiative of (City Council, citizens or others); duration (indefinite or fixed, in the latter case, finishing date); date of inclusion in Decidim; date of closure and reason; how it is organised (functions, powers etc.); composition; if it can be joined and how to do that; method of choosing members; type/ function of members within the body; composition of internal work groups as monitoring or advisory committees; characteristics of the body; the body's social networks (name of social network and link) and the body’s next meetings. + +* *Convening meetings*: enables to send automatic meeting invitations, collaboratively create agendas, and register attendance. For a complete list of features see the "meetings" component. +* *Assembly’s characteristics*: open, public, transparent and other characteristics regarding the level of participation that the assembly allows. +* *Composition:* This enables the composition of the body to be defined in greater detail, using the profiles of participants associated with the body as well as other characteristics. A display of the body’s structure is automatically generated based on the composition of participating members: +** *Types of members*: Chair, deputy chair, secretaries, others +** *Membership origin*: by draw; direct election; representation from another assembly; government representation etc. +** *Internal work groups*: for the creation of sub-assemblies. Work groups will be able to relate to the body they belong to +** *Characteristics*: Open/closed; transparent; with various access permits. +* *Display*: allows us to view internal data about each body as well as the associations between assemblies +** *Composition*: the structure of a body is shown in the form of a circle diagram +** *Organisation charts*: allow us to view the hierarchy or network of assemblies and their associations. +* *Map and calendar*: allow us to view the location of all the assemblies on a map and calendar +* *Involvement with other spaces and components* +** *Involvement with processes*: assemblies can be promoter groups, start a process or make proposals within a process. A body’s composition may be the result of a process (for electing posts) +** *Proposals and results*: a body can generate its own proposals or results. +*** It shows how the proposal was agreed on (by consensus, majority, number of votes etc.). +** *Meetings*: assemblies will have a list of associated meetings, but some features may jump from one meeting to another, such as citizen initiatives to include an item in an agenda. Likewise, it must be possible to view minutes separately from the meeting, as they are associated directly with the body . + +== Initiatives + +*Initiatives*. This participatory space allows citizens to make proposals and collect the *requisite number of signatures and/or endorsements* depending on type (the various types are set out in the municipal regulations), giving rise to the start of the administrative procedure for its processing and citizen monitoring. + +Initiatives operate as follows: + +* Any person or citizen association can make a citizen-initiative proposal. There are *several types of initiatives* with various numbers of endorsements/signatures required for their processing (these are all configurable). From the initiative-creation page, a description of each of the methods, the number of signatures required and examples (e.g. explanatory videos) can be viewed. +* To avoid duplicates, once an initiative has been created, the system will present suggestions for **similar initiatives** before continuing with the following step. Once similar proposals have been ruled out, the specific form will be shown for each type of initiative, along with the minimum number of endorsements required. The creator then has an URL at their disposal which can be used to invite others to join in and endorse the initiative. A map is also displayed showing the locations of meeting points to collect signatures should there be any. +* Once the the initiative has been created, the initiative will move to a **technical moderation and validation** stage, where the City Council’s staff can respond in various ways (by approving it, rejecting it or suggesting amendments). +* Initiatives can be monitored and **notifications received on updated** statuses, in addition to which their individual promoter or group can periodically send information newsletters to other uses of the platform who have opted to follow the initiative. +* On reaching the specified end date, an initiative can have two possible states: +** *Rejected*: where it fails to reach the minimum number of signatures, a message will be shown stating "does not meet the number of signatures required" and the initiative's creator will be notified. +** *Accepted*: where it has achieved a sufficient number of signatures or endorsements it will be accepted and the corresponding procedure will start. + +== Consultations + +Consultations (a voting procedure where all of the organisation’s participants are called to vote on specific questions), allows participants **to find out about current or prospective consultations**, *discuss and debate* the consultation’s subject area and *monitor* the results. It also provides a *gateway to an e-voting system* which is external to Decidim but integrated in the interface in order to manage and verify identities. \ No newline at end of file From 5ada2d12ebecf0e2240717d9374092666544baa6 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:02:00 +0200 Subject: [PATCH 312/336] New translations catalan.adoc (German) --- docs/de/modules/publications/pages/catalan.adoc | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 docs/de/modules/publications/pages/catalan.adoc diff --git a/docs/de/modules/publications/pages/catalan.adoc b/docs/de/modules/publications/pages/catalan.adoc new file mode 100644 index 0000000000..129537fc69 --- /dev/null +++ b/docs/de/modules/publications/pages/catalan.adoc @@ -0,0 +1,5 @@ += Catalan Publications + +== Media + +* Barandiaran, X. E., Monterde, A., & Pin, G. (2016). Decidim.barcelona: autonomía, participación y software libre - Software libre. In Xarxaip (Ed.), _Programari lliure i de codi obert-Societat lliure i govern obert._ (pp. 31–32). http://softwarelibre.xarxaip.cat/18.html \ No newline at end of file From 60e696f16a2dd4471a0df3d6123eb5618ba25c2d Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:02:01 +0200 Subject: [PATCH 313/336] New translations english.adoc (German) --- .../modules/publications/pages/english.adoc | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 docs/de/modules/publications/pages/english.adoc diff --git a/docs/de/modules/publications/pages/english.adoc b/docs/de/modules/publications/pages/english.adoc new file mode 100644 index 0000000000..15df7cacb3 --- /dev/null +++ b/docs/de/modules/publications/pages/english.adoc @@ -0,0 +1,19 @@ += English Publications + +IMPORTANT: Barandiaran, X., Calleja-López, A. & Monterde, A. (2018). Decidim: political and technopolitical +networks for participatory democracy. __Decidim’s project white paper__. (You can http://ajbcn-meta-decidim.s3.amazonaws.com/uploads/decidim/attachment/file/2005/White_Paper.pdf[download an alpha version of the document here]) + +== Academic + +* Borge, R., Balcells, J. , Padró-Solanet, A. (2019) "A model for the analysis of online citizen deliberation: Barcelona case study", International Journal of Communication. 13, pp. 5671–5695. https://ijoc.org/index.php/ijoc/article/view/10805/2873 + +== Media + +* Preville, P. (2019, November 13) _How Barcelona is leading a new era of digital democracy_ https://medium.com/sidewalk-talk/how-barcelona-is-leading-a-new-era-of-digital-democracy-4a033a98cf32 +* Graham, T. (2018, May 18) - _Barcelona is leading the fightback against smart city surveillance_ https://www.wired.co.uk/article/barcelona-decidim-ada-colau-francesca-bria-decode +* Barandiaran, X. E., & iaran. (2018, April 24). _What is Decidim?_ https://xabier.barandiaran.net/2018/04/24/what-is-decidim/ + +pass:[
][.biblio-abstract-label]#Abstract.# Many people ask what is this project called “Decidim” to which I have devoted my last two year of work with complete dedication. I wanted to share a brief summary here. This text is the…pass:[
] +* Stark, K. (2017, May 9). _Barcelona’s Decidim Offers Open-Source Platform for Participatory Democracy Projects_. https://www.shareable.net/blog/barcelonas-decidim-offers-open-source-platform-for-participatory-democracy-projects + +pass:[
][.biblio-abstract-label]#Abstract.# The word Decidim translated from Catalan means we decide, and it’s the name of Barcelona’s digital infrastructure for participatory democracy. One part functional database and one part political statement, organizers say Decidim is key to a broad digital transformation that is taking place in Barcelona — its institutions, markets, and economy.pass:[
] +* _Decidim: Free Open-Source participatory democracy for cities and organizations | Hacker News_. (n.d.). Retrieved January 21, 2019, from https://news.ycombinator.com/item?id=18952328 +* Oikos Denktank. (n.d.). _(W)E-Democracy - speaker 5 (1) - E-democratic cities - Arnau Monterde and Xabier E. Barandiaran_. Retrieved August 30, 2017, from https://www.youtube.com/watch?v=qrQ8ij4Ekag \ No newline at end of file From 19f622397e68bd112d8e64ef14d334b7a7b2126e Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:02:03 +0200 Subject: [PATCH 314/336] New translations french.adoc (German) --- docs/de/modules/publications/pages/french.adoc | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 docs/de/modules/publications/pages/french.adoc diff --git a/docs/de/modules/publications/pages/french.adoc b/docs/de/modules/publications/pages/french.adoc new file mode 100644 index 0000000000..6d095bf12a --- /dev/null +++ b/docs/de/modules/publications/pages/french.adoc @@ -0,0 +1,8 @@ += French Publications + +== Media + +* Politics, O. S. (2018a, March 7). _Decidim, la plateforme de participation citoyenne d’envergure européenne_. https://medium.com/open-source-politics/decidim-la-plateforme-de-participation-citoyenne-denvergure-europ%C3%A9enne-9b3cb92681e5 + +pass:[
][.biblio-abstract-label]#Abstract.# Cet article est basé sur une série de conversations que nous avons eues avec Pablo Aragon, Xabier Barandiaran, Josep Jaume[1] et de…pass:[
] +* Politics, O. S. (2018b, March 7). _Le Contrat Social de Decidim, un texte fondateur_. https://medium.com/open-source-politics/le-contrat-social-de-decidim-un-texte-fondateur-7a8916213270 + +pass:[
][.biblio-abstract-label]#Abstract.# Nous reproduisons ici, pour la première fois en français, le « Contrat Social » de la plateforme Decidim, traduit du catalan en passant…pass:[
] \ No newline at end of file From efbc53c5fcc82009695d8187713d6472c7a31b3b Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:02:04 +0200 Subject: [PATCH 315/336] New translations german.adoc (German) --- docs/de/modules/publications/pages/german.adoc | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 docs/de/modules/publications/pages/german.adoc diff --git a/docs/de/modules/publications/pages/german.adoc b/docs/de/modules/publications/pages/german.adoc new file mode 100644 index 0000000000..14d09475be --- /dev/null +++ b/docs/de/modules/publications/pages/german.adoc @@ -0,0 +1,10 @@ += German Publications + +== Media + +* Macher, J. (2020, March 4), _Barcelonas Erfolg mit der Plattform Decidim. Deutschlandfunk_ https://www.deutschlandfunk.de/wenn-buerger-politik-gestalten-barcelonas-erfolg-mit-der.795.de.html?dram:article_id=471680 +* Huber, P. (2019, May 29), _In Barcelona schreiben die Bürger das Regierungsprogramm selbst – und machen ihre Stadt sozialer_ https://kontrast.at/barcelona-smart-city-wirtschaft/ +* _Wie Barcelona eine offene “Smart City” im Dienste des Gemeinwohls plant_. (2018, September 9). https://netzpolitik.org/2018/freie-software-als-oeffentliches-gut-und-was-rathaeuser-dafuer-tun-koennen/ + +pass:[
][.biblio-abstract-label]#Abstract.# Im Interview spricht Francesca Bria, Barcelonas Chief Technology and Digital Innovation Officer, über “Digitale Soziale Innovation” und passende Strategien um die lokale Wirtschaft, Privatsphäre und die demokratische Teilhabe der Bürger*innen auch in einer “Smart City” langfristig zu sichern und zupass:[
] +* Macher, J. (n.d.). _Digital und demokratisch (neues deutschland)_. Retrieved December 7, 2019, from https://www.neues-deutschland.de/artikel/1129769.smart-city-digital-und-demokratisch.html + +pass:[
][.biblio-abstract-label]#Abstract.# In Barcelona bedeutet »Smart City«: Mehr Mitsprache für die Menschen. Andere Städte sind dem Beispiel gefolgt.pass:[
] \ No newline at end of file From 7bcddb1ad8b5c319e3c36e635d9cab2ce7240a00 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:02:05 +0200 Subject: [PATCH 316/336] New translations italian.adoc (German) --- docs/de/modules/publications/pages/italian.adoc | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 docs/de/modules/publications/pages/italian.adoc diff --git a/docs/de/modules/publications/pages/italian.adoc b/docs/de/modules/publications/pages/italian.adoc new file mode 100644 index 0000000000..4c85f3200d --- /dev/null +++ b/docs/de/modules/publications/pages/italian.adoc @@ -0,0 +1,6 @@ += Italian Publications + +== Media + +* _Perché Barcelona Smart City è un modello per il mondo. Intervista a Francesca Bria_. (2018, August 13). http://www.designatlarge.it/barcelona-smart-city-francesca-bria/ + +pass:[
][.biblio-abstract-label]#Abstract.# La sovranità tecnologica ai cittadini. Ecco come Barcelona Smart City è diventata un modello per il mondo. Intervista alla CTO Francesca Briapass:[
] \ No newline at end of file From 254323494e5c4b5708093d4c9d7d26572ea2f5bd Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:02:06 +0200 Subject: [PATCH 317/336] New translations spanish.adoc (German) --- .../modules/publications/pages/spanish.adoc | 34 +++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 docs/de/modules/publications/pages/spanish.adoc diff --git a/docs/de/modules/publications/pages/spanish.adoc b/docs/de/modules/publications/pages/spanish.adoc new file mode 100644 index 0000000000..165abbb338 --- /dev/null +++ b/docs/de/modules/publications/pages/spanish.adoc @@ -0,0 +1,34 @@ += Spanish Publications + +== Academic + +* Barandiaran, X. E., Calleja, A., Monterde, A., Aragón, P., Linares, J., Romero, C., & Pereira, A. (2017). Decidim: Redes políticas y tecnopolíticas para la democracia participativa. __Recerca__. Revista de pensament i anàlisi., 21, 137-150. https://doi.org/10.6035/Recerca.2017.21.8 +* Barandiaran, X. E. (2019). Tecnopolítica, municipalismo y radicalización democrática. In L. Roth, A. Monterde, & A. Calleja-López (Eds.), _Ciudades Democráticas. La revuelta municipalista en el ciclo post-15M_ (pp. 173–207). Icaria. http://ciudadesdemocraticas.tecnopolitica.net/ +* Borge, R., Balcells, J., Padró-Solanet, A., Batlle, A., Orte, A., & Serra, R. (2018) La participación política a través de la plataforma Decidim: análisis de 11 municipios catalanes. Paper presentado en el IX Congreso Internacional en Gobierno, Administración y Políticas Públicas GIGAPP. Madrid, 24-27 Septiembre. https://dryfta-assets.s3-accelerate.amazonaws.com/assets/congreso2018/abstractfiles/1536574598Laparticipacion_politica_a_traves_de_la_plataforma_Decidim.pdf +* Solà, J. (2018). _How are decisions made in Decidim.barcelona_ [Master Thesis, Pompeu Fabra]. https://repositori.upf.edu/handle/10230/36105 +* Barandiaran, X. E., Monterde, A., & Pin, G. (2016a). Decidim.barcelona: autonomia, participació i programari lliure. In Xarxaip (Ed.), _Programari lliure i de codi obert-Societat lliure i govern obert._ (pp. 31–32). +* Barandiaran, X. E., Monterde, A., & Pin, G. (2016b). Decidim.barcelona: autonomía, participación y software libre - Software libre. In Xarxaip (Ed.), _Programari lliure i de codi obert-Societat lliure i govern obert._ (pp. 31–32). http://softwarelibre.xarxaip.cat/18.html +* Aragón, P., Kaltenbrunner, A., Calleja-López, A., Pereira, A., Monterde, A., Barandiaran, X. E., & Gómez, V. (2017). Deliberative Platform Design: The Case Study of the Online Discussions in Decidim Barcelona. _Social Informatics_, 277–287. https://doi.org/10.1007/978-3-319-67256-4_22 + +pass:[
][.biblio-abstract-label]#Abstract.# With the irruption of ICTs and the crisis of political representation, many online platforms have been developed with the aim of improving participatory democratic processes. However, regarding platforms for online petitioning, previous research has not found examples of how to effectively introduce discussions, a crucial feature to promote deliberation. In this study we focus on the case of Decidim Barcelona, the online participatory-democracy platform launched by the City Council of Barcelona in which proposals can be discussed with an interface that combines threaded discussions and comment alignment with the proposal. This innovative approach allows to examine whether neutral, positive or negative comments are more likely to generate discussion cascades. The results reveal that, with this interface, comments marked as negatively aligned with the proposal were more likely to engage users in online discussions and, therefore, helped to promote deliberative decision making.pass:[
] + +== Media + +* Calleja-López, A., Monterde, A., & Barandiaran, X. E. (2017, October 18). _De las redes sociales a las redes (tecno)políticas: redes de tercera generación para la democracia del siglo XXI_ [Text]. http://tecnopolitica.net/content/de-las-redes-sociales-las-redes-tecnopol%C3%ADticas-redes-de-tercera-generaci%C3%B3n-para-la + +pass:[
][.biblio-abstract-label]#Abstract.# La sociedad deviene (en) red.pass:[
] +* _TIPS - Cultura digital - La democracia 2.0_. (2017, February 2). http://www.rtve.es/alacarta/videos/tips/tips-cultura-digital-democracia-20/3896837/ + +pass:[
][.biblio-abstract-label]#Abstract.# TIPS - Cultura digital - La democracia 2.0, Tips online, completo y gratis en RTVE.es A la Carta. Todos los programas de Tips online en RTVE.es A la Cartapass:[
] + +[[ref-4881969-FWFFK8LS]] +* Bravo, E. (2016, July 20). _Cómo mejorar Barcelona con la participación de sus ciudadanos_ [Magazzine]. http://www.yorokobu.es/barcelona-participacion/ + +pass:[
][.biblio-abstract-label]#Abstract.# El cricket es un deporte muy curioso. Los partidos pueden durar días y, entre sus reglas, está la de parar el juego para tomar el té. Una de las potencias en este deporte es Paquistán, país del que procede parte de la población inmigrante de Barcelona. Muchos de los miembros de esa comunidad llevan años […]pass:[
] +* Barandiaran, X. E., Pereira, A., Monterde, A., & Calleja-López, A. (2016). _Plan de desarrollo Decidim Barcelona_. Ajuntament de Barcelona City Council. https://decidim-barcelona.s3.amazonaws.com/uploads/decidim/attachment/file/54/Plan_desarrollo_decidim.pdf + +pass:[
][.biblio-abstract-label]#Abstract.# Este documento detalla el futuro desarrollo de la plataforma digital de participación de l´Ajuntament de Barcelona, decidim.barcelona (disponible en URL https://decidim.barcelona). Los principales objetivos de la plataforma son articular, estandarizar, visualizar y comunicar todos los procesos de participación del Ajuntament de Barcelona y de la ciudad ofreciendo un servicio de infraestructura digital para la democracia directa y participativa a todas las escalas territoriales y asociativas de Barcelona. El documento detalla los objetivos de la plataforma, el flujo de desarrollo, las funcionalidades previstas, y un código ético-político.pass:[
] +* Participa Pamplona. (2017a, July 18). _Decidim Barcelona (Xabier Barandiaran)_. https://www.youtube.com/watch?v=zQYvdwGsg8M + +pass:[
][.biblio-abstract-label]#Abstract.# 1a Jornada de tecnología y democracia (24/05/2017). Infraestructuras digitales para la democracia. Decidim Barcelona Xabier Barandiaran. Coordinador del proyecto Decidim, asesor de la Regiduría de Participación del Ayuntamiento de Barcelona. Teknologia eta demokraziari buruzko 1. jardunaldia (24/05/2017). Demokrazia partizipatiborako azpiegitura digitalak Decidim Barcelona Xabier Barandiaran. Decidim proiektuaren koordinatzailea eta Bartzelonako Udaleko Partaidetza zinegotziaren aholkulariapass:[
] +* Participa Pamplona. (2017b, July 18). _Hacia una democracia participativa inteligente y democrática (Asier Gallastegui y Asier Amezaga)_. https://www.youtube.com/watch?v=z4FTUt8wnRs + +pass:[
][.biblio-abstract-label]#Abstract.# 1a Jornada de tecnología y democracia (24/05/2017). Infraestructuras digitales para la democracia. Decidim Barcelona Xabier Barandiaran. Coordinador del proyecto Decidim, asesor de la Regiduría de Participación del Ayuntamiento de Barcelona. Teknologia eta demokraziari buruzko 1. jardunaldia (24/05/2017). Demokrazia partizipatiborako azpiegitura digitalak Decidim Barcelona Xabier Barandiaran. Decidim proiektuaren koordinatzailea eta Bartzelonako Udaleko Partaidetza zinegotziaren aholkulariapass:[
] +* Participa Pamplona. (2017c, July 18). _Metadecidim. Diseño participativo de la plataforma Decidim Barcelona (Andrés Pereira de Lucena)_. https://www.youtube.com/watch?v=I31yY4ip3rk + +pass:[
][.biblio-abstract-label]#Abstract.# 1a Jornada de tecnología y democracia (24/05/2017). Infraestructuras digitales para la democracia. Andrés Pereira de Lucena. Presidente de la asociación aLabs, coordinador técnico y arquitecto técnico de Decidim. Teknologia eta demokraziari buruzko 1. jardunaldia (24/05/2017). Demokrazia partizipatiborako azpiegitura digitalak Andrés Pereira de Lucena. aLabs elkarteko lehendakaria eta Dicidimen koordinatzaile teknikoa eta arkitekto teknikoa.pass:[
] +* Barandiaran, X. E., & Romero, C. (2018, May 17). _Presentació Decidim Ada Lovelace_. https://www.youtube.com/watch?v=-3eh_v339Cg +* Barcelona Activa. (n.d.). _Fòrum d’Economies Col·laboratives Procomuns 2017. Activitat paral·lela 3_. Retrieved January 13, 2018, from https://www.youtube.com/watch?v=IvDsgJcNxnQ +* Govern Digital. (n.d.). _CGDL2018 - Participació ciutadana: com fer de la política quelcom més proper_. Retrieved April 9, 2018, from https://www.youtube.com/watch?v=7LH6OItIrRU \ No newline at end of file From c6dfbd1c17c596a57414041b8b39f8fd3c5c0061 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:02:07 +0200 Subject: [PATCH 318/336] New translations index.adoc (German) --- docs/de/modules/releases/pages/index.adoc | 34 +++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 docs/de/modules/releases/pages/index.adoc diff --git a/docs/de/modules/releases/pages/index.adoc b/docs/de/modules/releases/pages/index.adoc new file mode 100644 index 0000000000..b8433a43af --- /dev/null +++ b/docs/de/modules/releases/pages/index.adoc @@ -0,0 +1,34 @@ += Releases + +Here you can find all the blog posts for every minor release. + +You can find all the releases (with minor and patches) at +https://rubygems.org/gems/decidim/versions[RubyGems.org] and +https://github.com/decidim/decidim/releases[GitHub]. + +* https://decidim.org/blog/2022-09-30-new-version-0-27-0/[Version 0.27 (2022-09-30)] +* https://decidim.org/blog/2022-02-22-new-version-0-26-0/[Version 0.26 (2022-02-22)] +* https://decidim.org/blog/2021-10-07-new-version-0-25-0/[Version 0.25 (2021-10-07)] +** xref:develop:guide_migrate_webpacker_module.adoc[Migrate to Webpacker a module] +** xref:develop:guide_migrate_webpacker_app.adoc[Migrate to Webpacker an instance app] +* https://decidim.org/blog/2021-03-26-new-version-0-24-0/[Version 0.24 (2021-03-26)] +* https://decidim.org/blog/2020-11-12-new-version-0-23-0/[Version 0.23 (2020-11-12)] +* https://decidim.org/blog/2020-09-02-new-version-0-22-0/[Version 0.22 (2020-09-02)] +* https://decidim.org/blog/2020-04-12-new-version-0-21-0/[Version 0.21 (2020-04-12)] +* https://decidim.org/blog/2020-02-06-new-version-0-20-0/[Version 0.20 (2020-02-06)] +* https://decidim.org/blog/2019-10-21-release-0-19-0/[Version 0.19 (2019-10-21)] +* https://decidim.org/blog/2019-07-03-release-0-18-0/[Version 0.18 (2019-07-03)] +* https://decidim.org/blog/2019-03-25-release-0-17-0/[Version 0.17 (2019-03-25)] +* https://decidim.org/blog/2019-01-14-release-0-16-0/[Version 0.16 (2019-01-14)] +* https://decidim.org/blog/2018-12-13-release-0-15-0/[Version 0.15 (2018-12-13)] +* https://decidim.org/blog/2018-08-30-release-0-14-0/[Version 0.14 (2018-08-30)] +* https://decidim.org/blog/2018-07-11-release-0-13-0/[Version 0.13 (2018-07-11)] +* https://decidim.org/blog/2018-06-13-release-0-12-0/[Version 0.12 (2018-06-13)] +* https://decidim.org/blog/2018-04-27-release-0-11-0/[Version 0.11 (2018-04-27)] +* https://decidim.org/blog/2018-03-29-release-0-10-0/[Version 0.10 (2018-03-29)] +* https://decidim.org/blog/2018-02-06-release-0-9-0/[Version 0.9 (2018-02-06)] +* https://decidim.org/blog/2017-12-21-release-0-8-0/[Version 0.8 (2017-12-21)] +* https://decidim.org/blog/2017-11-21-release-0-7-0/[Version 0.7 (2017-11-21)] +* https://decidim.org/blog/2017-09-21-release-0-6-0/[Version 0.6 (2017-09-21)] +* https://decidim.org/blog/2017-08-29-release-0-5-0/[Version 0.5 (2017-08-29)] +* https://decidim.org/blog/2017-07-17-release-0-4-0/[Version 0.4 (2017-07-17)] \ No newline at end of file From 2c20c6266ef37c86ffa2a2ff10b693f3e2d5963c Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:02:08 +0200 Subject: [PATCH 319/336] New translations about.adoc (German) --- docs/de/modules/understand/pages/about.adoc | 90 +++++++++++++++++++++ 1 file changed, 90 insertions(+) create mode 100644 docs/de/modules/understand/pages/about.adoc diff --git a/docs/de/modules/understand/pages/about.adoc b/docs/de/modules/understand/pages/about.adoc new file mode 100644 index 0000000000..7522cbfe2c --- /dev/null +++ b/docs/de/modules/understand/pages/about.adoc @@ -0,0 +1,90 @@ += About + +:experimental: +:icons: font +:page-partial: +:source-highlighter: highlightjs + +Decidim is a technopolitical project. A digital citizen-participation platform for a democratic city, made openly and collaboratively using free software.. It is a public commons infrastructure. Public because it enjoys a clear institutional impetus and commons because the code is open and free, in other words, anyone can see it, use it, copy it or amend it. It is a platform designed for coordinating citizen-participation processes and spaces, aimed at extending and facilitating access to citizen participation, opening new spaces for deliberation and collaboration in co-designing and co-producing public policies and new spaces for direct participation and democracy, thereby enabling disintermediation and cooperation between citizens, institutions and organisations of civil society. + +[#decidim.barcelona-fig] +._decidim.barcelona_. +image::decidim_barcelona_homepage.png[decidim.barcelona homepage] + +== Principles + +The Decidim platform has been designed and developed on the basis of a series of principles that promote further exploration and democratic innovation in the digital era as well as possibilities for improving, opening and developing citizen-participation policies and democratic forms of government at various levels, with special emphasis on the municipal scale. These principles are listed below: + +=== Technopolitical hybridisation + +This is key to preventing what we could define as “digital reductionism" (Calleja-López, 2017), a variant of technocentrism that puts the emphasis mainly or exclusively on the new participatory forms’ digital aspects and infrastructures, without dealing with the necessary powerful innovations in participatory practices, processes and culture that result from the hybridisation of face-to-face and digital participation. The hybrid approach attempts to connect spaces and activities taking place in decidim.barcelona with face-to-face spaces and activities and to consider the multiple variants that may arise for the purposes of boosting new forms of collective action. + +=== Enhanced and multi-modal participation + +The result of digital reductionism is to foster "click-participation" (Calleja-López, 2017), where participation becomes a definite phenomenon, first and foremost for its digital aspect, and, more specifically, for its convenience, speed and non-interference with other players and ideas. There is therefore a need to boost enriched forms of interaction between people in decidim.barcelona, ​​and between them, the platform’s contents and the hybrid participatory processes in a broader sense. This implies, on the one hand, enriching participatory processes with functions that go beyond voting (information and data displaying, deliberation etc.,) and, on the other, designing hybrid processes (e.g. Face-to-face meetings connected to the platform), which turn participation into an enhanced, comprehensive and multimodal participation, rather than reduced and “clicked”. + +=== Transparency and traceability + +With the exception of data that can affect user privacy, details of activities in participatory processes in digital media need to be absolutely traceable and public, if a new level of transparency in participation is to be fostered. Transparent participation and traceability are necessary conditions for confidence in these new processes. + +=== Opening/ releasing + +The principles of releasing and opening refer firstly to the platform’s code and functions, secondly to the processes’ data and contents and thirdly and more generically, to the processes themselves. This implies, in the first two cases, using the most exacting share-alike licenses and standards (e.g. Affero GPLv3 for code, CreativeCommons for content, Open Access Database Licences for data). Decidim needs to be a free-software platform that allows anyone to see, amend and reuse the code it is based on. In the case of processes, these principles connect to several others that we mention in this list, such as transparency and accessibility, and aim to make these processes as participatory and reappropriable as possible on multiple levels. + +=== Cross-cutting participation + +Dealing with many of the keys of success for recent initiatives such as 15M, decidim.barcelona's deployment and communication strategies and media processes need to be geared towards achieving legitimacy first and then participation, within reach of as many social and political groups as possible. + +=== Knowledge, technoscience and collective intelligence + +The new forms of participation should benefit from the possibilities that are offered by both popular and expert knowledge from citizens and data science (data occasionally from the participatory processes themselves) to improve decision-taking and participation. An informed and expert participation, capable of catalysing social knowledge. + +=== Collective and networked participation + +One of the central challenges to achieiving an “enhanced”, digitally mediated, participation, is boosting its collective dimension in the face of atomising tendencies, often resulting from remote-participation conditions. This implies using functions that boost interactions between users in collective processes, whether on a platform or face to face. Digital or face-to-face discussion and deliberation spaces are necessary for coordinating better participation. + +=== Public-commons orientation, reappropriation and recursive participation + +Democracy’s new digital infrastructures have to be a space belonging to, by and for the commons. If democracy is to be promoted, infrastructures themselves have to be radically democratic. This implies consideration of an innovative and alternative model to the one for privatising the public sphere. To this end, Decidim needs to be a digital infrastructure of public-commons construction, ownership and use. In other words, what we define as "technopolitical commons", technology open to participation from everyone and anyone in its design and management, governed through distribution and with collective-production and share-alike models. Compared to the closed and exclusive platforms controlled by big corporations, Decidim is a democratic infrastructure for democracy. + +=== Technopolitical accessibility and training + +It also needs to be a public service, which is why it is essential to ensure citizens have access and training for taking part and exploiting all its potential. Promoting its grassroots-empowered use and use by excluded social groups is a key challenge. Both decidim.barcelona and digital participatory processes have to be governed by more demanding accessibility standards (e.g. Those of the Web Accessibility Initiative, WAI). + +=== Independence, empowerment and affiliation + +If social movements have demonstrated something over the last few years it is the central role played by self-organised collective action in kick-starting and guiding processes of change. In this regard decidim.barcelona and the processes using the platform need to boost social independence and self-organisation. In addition, political affiliation has to be a requisite feature in many of the platform’s processes, given that it is a key element of the platform’s medium- and long-term public and operative legitimacy. In other words, both independent social processes and bottom-up processes that are affiliated to public institutions. + +== Brief history + +During its public presentation in September 2015, Decide Madrid, a digital participatory platform launched by Madrid City Council and based on Consul software, began to experiment with various participatory processes, such as public debates and citizen proposals. Launched by Barcelona City Council, the Decidim Barcelona project, which was also based on Consul but with major changes and adapted to new needs, was presented in February 2016. ​​Its original goal was to coordinate the participatory process for drafting the Municipal Action Plan (PAM) as well as other participatory processes in the city in the future. Some 25,000 people signed up to it in under two months, 10,860 proposals were submitted, 410 meetings held and over 160,000 votes in favour collected. In this way a collaboration and deliberation space opened up between citizens, social organisations and Barcelona City Council. + +A great deal of interest was expressed in many municipalities in going ahead with similar processes, taking advantage of the technology used, given its success and the fact it was free and reusable. To be more specific: Coruña City Council, through its A Porta Aberta platform for Participatory Budget processes; Oviedo City Council, through its Consulta Oviedo, with a space for citizen proposals, and Valencia City Council, through decidimVLC, for preparing participatory budgets. There were also numerous cases of local authorities and other institutions showing great interest in the decidim.barcelona project and its implementation, such as the city councils of Hospitalet, Badalona, ​​Terrassa and Gavà, as well as Barcelona Provincial Council and the Localret Consortium. + +This series of changes and adaptations led in turn to a new technological need involving the adaptation of technology dealing with local-authority diversity, independence and the medium-term sustainability of the platform. Hence the establishment of a scalable and decentralised (or modular) development strategy enabling the entire project to be flexible and grow over time as well as generate a development, functional design and support community, which is sustained at both municipal and (more importantly) inter-municipal levels. + +This led Barcelona City Council to thoroughly reconsider the platform’s architecture and carry out a complete rewrite of the software based on the above-mentioned principles and needs. This rewrite gave rise to the Decidim project, a generic,participatory democratic framework based on Ruby on Rails, whereby any group, organisation or institution that wanted to use it could do so with minimum technical requirements. + +== Open development and free software + +The Decidim platform project has been developed with free software (both at its initial stage, based on Consul, and after the code's complete rewrite) and all its development has been open, enabling its entire development to be traceable and followed right from the very beginning. + +Its creation from free software refers to the fact that the platform's source code has a AGPL v3 Licence or GNU Affero General Public Licence,footnote:[https://github.com/AjuntamentdeBarcelona/decidim/blob/master/LICENSE-AGPLv3.txt] which means the code has to allow for the possibility of its being consulted, copied, amended and reused, so long as the same licence is kept in any work or product derived from it. This is one of the licences that provides most freedom and is copyleft footnote:[Copyleft stands for a whole range of licences that can be applied to IT, artistic and other creations. Copyleft's supporters see copyright as a way of restricting people's right to make and redistribute copies of a work.[2] A copyleft licence, in fact, uses actual copyright legislation to ensure that everyone who receives a copy or derived work can use, amend and even distribute both the work and any derivative versions. In a strictly non-legal sense, then, copyleft is the opposite of copyright. (Wikipedia, 2017).]. In this regard, it makes sense for public authorities to make a clear commitment to this type of software, given that it is through such licences that we can receive social return on our public investments. + +The fact that the software has been openly developed means that the entire development process is transparent and accessible, in other words, that anyone can see, right from the start of the software's development, every change, contribution, community of developers involved etc. By the same token, transparency is becoming a fundamental principle not just in citizen participation but in software development too. + +All this has been done on a platform designed for open collaboration in software development known as GitHub.footnote:[https://github.com/] This platform enables access to codes and monitoring of the software's development. GitHub is designed to host Git repositories, though there are other alternatives to GitHub such as GitLab. + +== Decidim Barcelona + +Decidim Barcelona is the first instance of Decidim and the origin of the project. Decidim Barcelona came about from Barcelona City Council’s need to open up a technologically mediated citizen-participation process around the Municipal Action Plan (PAM), with three major goals: making a process that is transparent and traceable, expanding participation through the digital platform and integrating face-to-face and digital participation. + +This process received over 10,000 proposals and more than 160,000 votes in favour, with a final balance of 71% of citizen proposals accepted and included in PAM through over 1,600 initiatives. Decidim was originally designed exclusively for hosting this process though the need for extending it to other participation processes was quickly spotted. + +It was here that the idea for today's Decidim came about. A participatory platform that enables as many processes as people want, divided up into stages and with the possibility of setting several functions at each stage. The possibility was accordingly left open for designing new functions that could be integrated into the processes (surveys, collaborative-text drafting, result monitoring and so on), as well as the integration of new participatory spaces such as citizen initiatives and participation councils. + +Decidim Barcelona is currently (July 2017) hosting 12 participatory processes and already has some 26,600 participants, almost 12,000 collected proposals, 1,700 results, 670 face-to-face meetings and 185,000 votes in favour collected. The platform’s good results in Barcelona led to its extension to other municipalities, including Hospitalet de Llobregat, Sabadell, Badalona, Terrassa, Gavà, Sant Cugat, Mataró and Vilanova i la Geltrú. + +== Decidim Municipis + +Decidim is a multitenant platform, that is, a platform where as many instances can be used as needed, with a single installation. There are numerous successful examples of multitenant architectures in the world of software, such as the Wordpress free software for blogs project. It is especially useful for institutions that wish to provide Decidim as a third-party service. The Provincial Council's case is especially important as it can be used with a single installation - maintained, updated and sustained by a single entity - for as many local authorities as desired, thereby reducing installation and maintenance costs and providing technological solutions for improving citizen participation in medium-sized and small local authorities that would otherwise have much less access to such resources. \ No newline at end of file From c010314b39d3dd5ee83dc65c0937ef838acaf78d Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:02:09 +0200 Subject: [PATCH 320/336] New translations background.adoc (German) --- .../modules/understand/pages/background.adoc | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 docs/de/modules/understand/pages/background.adoc diff --git a/docs/de/modules/understand/pages/background.adoc b/docs/de/modules/understand/pages/background.adoc new file mode 100644 index 0000000000..d2b4cce858 --- /dev/null +++ b/docs/de/modules/understand/pages/background.adoc @@ -0,0 +1,29 @@ += Background + +:experimental: +:icons: font +:page-partial: +:source-highlighter: highlightjs + +== Citizen participation in the Network Society + +Becoming a network(ed) society. Information and communication technologies (henceforth, ICTs) and their associated practices are bringing about irreversible changes to the social and political landscape. From the smallest residents’ association to the most intensive electoral campaign, from a neighbourhood organisation or social movement to the European Union, political relations are being increasingly determined by the use of digital devices and technologies. It seems that the future of democratic participation and collective action will be through the development of digital platforms and hybrid processes, which renovate traditional practices and combine them with digital ones (Fuchs, 2007). + +This transition coincides with the decline of representative systems over the last few decades (Norris, 1999; Pharr & Putnam, 2000; Tormey, 2015), which has contributed to the questioning of the legitimacy and sense of democracy itself, reduced and often identified with this system (Crouch, 2004; Keane, 2009; Streeck, 2016). Several authors have used the terms “post-representation" to refer to the emptying of power and meaning of the representative institutions that go from globalisation to disaffection and divestment of citizens (Brito Vieira and Runciman, 2008; Keane, 2009; Rosanvallon , 2011; Tormey, 2015). The various attempts to boost participation have proved unequal to the task of reversing these trends (Keane, 2011; Tormey, 2015). + +This long-running political crisis comes on the back of the financial and economic crisis of 2008, and is directly linked to this earlier crisis. Even so, millions of people mobilised in the face of the crisis, intent not only on demanding but also on experimenting and building a real democracy. The key development here was the 15M network-movement. It is in the context of technological hypermediation that information and communication technologies, used in the 1980s and 1990s to accelerate financial flows and globalisation (Castells, 1996), became crucial spaces and devices for a multitudinous re-appropriation of policy, as well as democratic experimentation (Martinet Ros et al., 2015). + +After four years of numerous successes and failures, new political citizen initiatives in May 2015 managed to take power in Spain’s main cities, including Barcelona. In this respect they were riding on the tide of countries such as Iceland, where the economic crisis had led to a period of citizen re-appropriation of the institutions and fertile democratic innovation, based on an intense and creative use of ICTs. + +Since 15M, most of the experiments aimed at introducing new forms of participatory and deliberative democracy (Barber, 1984; Habermas, 1994, 1996; Della Porta 2013) have been technologically mediated. As can be seen from the case of Iceland (as well as others, such as Finland), the democratising processes of citizen mobilisation and empowerment require technopolitical coordination (Rodotà 1997; Martinet Ros et al., 2015) to achieve their maximum richness and capacity. Technopolitics stems from the politicisation of technologies and technological re-assemblage of politics as well as the co-development and co-production of politics and technologies. As for forms of technopolitical participation and deliberation, digital and face-to-face practices, spaces and processes connect to and feed back from one another, acquiring a multi-layered dimension. These participatory devices are geared towards increasing the number, variety and parity of players that "take part" in the city’s common government, expanding and enriching the areas, forms and periods in which it takes place and helping to boost a collective intelligence (Levy, 1997) capable of taking on the complexity of contemporary urban life. Technopolitics needs to tackle the numerous limits of what has been called “digital democracy" (Hindman, 2008) starting by freeing itself from the technocentric and technooptimistic narratives around digitally mediated participation. + +New participatory processes are being built within a context full of opportunities and fraught with risks. The 2015 government programme and Municipal Action Programme (PAM) for 2016-2019 drawn up for the city of Barcelona gives centre stage to participation and, more specifically, innovation and the development of new democratic participatory models. PAM, ​​the development of which involved thousands of people, meets a clear social demand that calls for ​​a thorough redesign of the democratic system and its participatory mechanisms. This, however, is occurring in a context defined by: a) large politically, economically and socially excluded population sectors; b) increasing difficulty accessing participation as a result of the economic-crisis situation; c) a crisis over the legitimacy and operability of the representative democratic system and public authorities; d) an enormous technological dependency on private corporate infrastructures and services; e) a legal and political context adverse to direct democracy, social independence and territorial sovereignty; f) an abysmal institutional disadvantage in understanding social complexities through techniques analysing social-behaviour data and models that big technological companies and digitally coordinated services possess. + +[[h.2et92p0]] +== Data Control and digital infrastructures for democracy + +In the context of new configurations of informational capitalism (Castells, 1996), so-called “data capitalism" (Lohr, 2015; Morozov, 2015) or "surveillance capitalism" (Zuboff, 2015), the new digital infrastructures of democracy run the risk of contributing to dynamics contrary to such principles as privacy and technological sovereignty. Exclusive, closed and opaque platforms geared towards exploiting social activities for corporate profit are operating as non-democratic spaces occupying more and more areas of social life. This model is particularly dangerous in relation to the new infrastructures and processes of democracy that we are talking about. + +Compared to the exclusive and corporate infrastructural model, the public commons model, which we believe decidim.barcelona’s development needs to be inspired by, ​​is geared towards developing platforms where design, ownership and management are free, open and participatory, shared between public workers and citizens (organised or not). Under this model, not only the platform's code but also the data that are generated in it are processed and appropriated according to the logic of public and common management. The opening-up of everything and anything to participation, the hallmark of the commons as a political principle (as opposed to the private and even state-public sphere --- Laval & Dardot, 2015), seems to be a basic condition for participatory infrastructures to be fully functional. Participation has to be recursive here: it needs to help to define and establish the infrastructural conditions of its own existence and to affect the design, development and management of digital participatory platforms as well as the processes and results (e.g. data) that are generated in them. + +Put in the hands of large digital-service corporations, the algorithmic organisation of social life and the area we are concerned with, political participation, poses a risk to democracy and technological sovereignty that only a public commons effort in digital infrastructures can reverse. Only platforms based on free, open, transparent, secure and public-commons management software offer guarantees when it comes to building democracies of greater quality. The democracy of the future has to be built, then, on democratic infrastructures. \ No newline at end of file From 070fb62a0d91a2e6e40d2b2185fa6445394ab05d Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:02:10 +0200 Subject: [PATCH 321/336] New translations social-contract-ca.adoc (German) --- .../understand/pages/social-contract-ca.adoc | 63 +++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 docs/de/modules/understand/pages/social-contract-ca.adoc diff --git a/docs/de/modules/understand/pages/social-contract-ca.adoc b/docs/de/modules/understand/pages/social-contract-ca.adoc new file mode 100644 index 0000000000..cedfaf7ea8 --- /dev/null +++ b/docs/de/modules/understand/pages/social-contract-ca.adoc @@ -0,0 +1,63 @@ += Contracte Social de Decidim + +[NOTE] +==== +Pots llegir el Contracte Social de Decidim en altres idiomes: xref:understand:social-contract-es.adoc[Castellano] - xref:understand:social-contract.adoc[English] + +Si vols traduïr-ho al teu idioma sisplau https://decidim.org/contact[contacta amb nosaltres]. +==== + +Codi de garanties democràtiques i de col·laboració oberta + +Aquest és el contracte social que tots el membres del projecte Decidim es comprometen a seguir. + +La utilització de la plataforma Decidim per part de qualsevol ajuntament o qualsevol altre ens municipal o supramunicipal, així com altres organitzacions, comporta l'assumpció total i íntegra d'aquest codi. + +== Programari lliure i continguts oberts + +El codi de la plataforma, així com els mòduls, llibreries o qualsevol altre codi que es desenvolupi per al seu funcionament, serà sempre programari lliure amb llicència https://www.gnu.org/licenses/agpl-3.0.en.html[Affero GPLv3 o posterior] en el cas dels nous desenvolupaments, i de llicències compatibles amb aquesta en el cas de reutilització d’altres codis. + +Així mateix, els continguts, dades, APIS i/o interfícies que el Decidim faci servir per interactuar amb qualsevol tipus d’usuari, compliran amb estàndards oberts i interoperables (ex. OpenID, RSS, OStatus, etc.), tendint sempre al màxim nivell d’integració amb els estàndards oberts més estesos. + +De cara a maximitzar la transparència i la col·laboració ciutadana en els processos, òrgans i mecanismes de participació, el contingut de textos, gràfiques, fonts tipogràfiques, àudio, vídeo o altres elements de disseny, es farà públic amb una llicència https://creativecommons.org/licenses/by-sa/4.0/legalcode[Creative Commons By-Sa]. + +Igualment les dades de la plataforma, especialment totes aquelles que es puguin recollir de manera sistemàtica a través de scrappers o altres tècniques de consulta massiva, seran publicades amb llicències http://opendatacommons.org/licenses/odbl[Open Data Commons Open Database License], en formats estandarditzats i accessibles (tipus CSV, JSON, etc.) i, sempre que sigui possible, amb eines que facilitin l’anàlisi i visualizació d’aquestes dades. + +== Transparència, traçabilitat i integritat + +La plataforma, així com la seva configuració, desenvolupament, implementació i ús actual o futur han de garantir i maximitzar en tot moment la transparència, la traçabilitat i la integritat dels diagnòstics, propostes, debats, decisions, o qualsevol altre objecte, mecanisme o procés de participació. + +Per transparència entenem que totes les dades relacionades amb aquests mecanismes i processos estiguin disponibles per a baixar, analitzar i tractar, seguint els formats i estàndards de compartició més exigents (accessibilitat, multi-format, etc.). + +La transparència serà una condició necessària pel seguiment dels processos i mecanismes de participació, però mai, i en cap cas, pel tractament de dades personals que vagin contra la defensa de la privacitat de la persona participant en la plataforma. + +Entenem per traçabilitat de les propostes la possibilitat de realitzar un seguiment complet, cap enrere (passat) i cap endavant (futur), de tot el que ha passat amb les propostes, plans, reglaments o qualsevol altre tipus d'objecte de decisió o participació inclòs en un procés o mecanisme. La plataforma ha de mostrar en tot moment com, per què, per qui i amb quin tipus de garanties un determinat objecte d'un procés de participació va ser descartat, aprovat o bloquejat. + +Entenem per integritat l'autenticitat d'un determinat contingut, i la garantia que aquest no ha estat manipulat o modificat sense que aquesta modificació quedi clarament registrada i sigui visiblement verificable i contrastable, amb l'objecte d'evitar la manipulació de les propostes o resultats dels processos o mecanismes de participació. + +== Igualtat d’oportunitats i indicadors de qualitat + +Al costat de les garanties anteriorment definides, la plataforma es compromet a garantir la igualtat d'oportunitats per a totes les persones, així com les seves propostes o altres contribucions que pugui acollir. La plataforma oferirà les mateixes oportunitats de partida a tots els objectes participatius (propostes, debats, etc.) perquè siguin vistos, discutits, comentats, valorats o tractats, sense discriminació de cap tipus. En aquest sentit la identitat digital de les persones usuàries de la plataforma serà sempre personal i intransferible, la verificació que otorgui drets de decisió a la plataforma ha de ser a més única, i serà l’ens responsable l’encarregat de garantir la no-suplantació d’una persona física o jurídica. + +Amb l’objectiu de garantir la qualitat democràtica de la plataforma es fomentarà l’ús d’indicadors de qualitat a partir dels processos i mecanismes de participació, així com l’activitat de les persones usuàries de la plataforma. També es fomentarà la compartició de la configuració dels diferents components així com de les dades obertes per a la definició d’aquests indicadors. + +La igualtat en la participació política de la ciutadania és un dels principis fonamentals del sistema democràtic i la plataforma, no només ha de garantir la igualtat d’oportunitats pel que fa als usos i funcionalitats, sinó també el dret d’accés. En aquest sentit cada ens promotor de la plataforma es compromet a impulsar aquelles accions que avancin en la direcció de facilitar i acompanyar l’accés a la plataforma a tota la ciutadania per igual de manera universal, propocionant les eines i els recursos adients per a que la plataforma estigui a l’abast de qualsevol persona que en vulgui fer ús. + +== Confidencialitat de les dades + +Es garanteix la confidencialitat i la privacitat de les dades personals que els ciutadans aporten per a participar en qualsevol de les funcionalitats i/o possibilitats de participació que ofereixi la plataforma DECIDIM en tot moment. En cap cas es cediran aquestes dades personals a tercers. Tampoc es farà un ús de les mateixes que vagi més enllà de l'estrictament necessari per a la gestió del registre d'usuaris o millores de la usabilitat de la plataforma. Sempre que la tecnologia de la plataforma ho permeti les expressions de preferències polítiques en els processos de decisió romandran inaccessible fins i tot per l’ administrador/a de la plataforma o els servidors. + +== Rendiment de comptes i responsabilitat + +S’adopta un compromís davant la ciutadania de respondre totes les aportacions i consultes en el mínim temps possible. També s’adopta el compromís de donar seguiment als resultats dels processos de participació, així com de donar resposta a aquelles demandes que específicament ho sol·licitin. Finalment s’assumeix el compromís d’estudiar la incorporació d’indicadors de seguiment dels processos de participació un cop estiguin finalitzats, per tal de poder avaluar de manera sistemàtica el seu desplegament. + +== Millora contínua i col·laboració interinstitucional + +S’adoptaran mecanismes de revisió i avaluació periòdica per facilitar la millora contínua de la plataforma. + +Es prioritzarà la col·laboració i l’intercanvi d’experiències entre institucions involucrades en el projecte, amb l’objectiu de millorar, corregir i generar nous desenvolupaments que ajudin a la millora contínua de la plataforma. + +En aquest sentit es facilitaran les condicions i entorns de col·laboració a l’hora de tirar endavant millores que apuntin a un benefici comú del conjunt de la plataforma, habilitant mecanismes de coordinació interinstitucional quan sigui necessari. +Condicions d’ús + +Totes els punts d’aquest codi han de quedar reflectits en les condicions d’ús que cada ens redacti per a la seva plataforma i mai entraran en contradicció. \ No newline at end of file From 3c6989373bab8949cf00e0c4a5113dffde9a9a02 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:02:11 +0200 Subject: [PATCH 322/336] New translations social-contract-es.adoc (German) --- .../understand/pages/social-contract-es.adoc | 63 +++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 docs/de/modules/understand/pages/social-contract-es.adoc diff --git a/docs/de/modules/understand/pages/social-contract-es.adoc b/docs/de/modules/understand/pages/social-contract-es.adoc new file mode 100644 index 0000000000..9f15eeba3b --- /dev/null +++ b/docs/de/modules/understand/pages/social-contract-es.adoc @@ -0,0 +1,63 @@ += Contrato social de Decidim + +[NOTE] +==== +Puedes leer el Contrato Social de Decidim en otros idiomas: xref:understand:social-contract-ca.adoc[Català] - xref:understand:social-contract.adoc[English] + +Si lo quieres traducir a tu idioma por favor https://decidim.org/contact[contáctanos]. +==== + +Código de garantías democráticas y colaboración democrática + +Este es el contrato social que todos los miembros del proyecto Decidim se comprometen a seguir. + +El uso y desarrollo de la plataforma Decidim por parte de una institución o grupo social de cualquier tipo implica la aceptación total e integral del presente contrato social y su compromiso con el mismo. + +== Software libre y contenido abierto + +El código de la plataforma, junto con los módulos, las bibliotecas o cualquier otro código que se desarrolle para su funcionamiento y utilización, será siempre un software de código abierto libre con una licencia de https://www.gnu.org/licenses/agpl-3.0.en.html[Affero GPLv3 o versiones posteriores], siempre que el código se cree de nuevo y con licencias que sean compatibles con el anterior código cuando este se reutilice. + +Del mismo modo, el contenido, los datos, las API o cualesquiera otras interfaces que se utilicen para interactuar con cualquier tipo de usuario debe seguir estándares abiertos e interoperables (OpenID, RSS, OStatus, etcétera), procurando siempre maximizar su integración con los estándares abiertos de uso más amplio. + +Con el fin de maximizar la transparencia y la colaboración ciudadana en procesos, órganos y mecanismos participativos, el contenido, así como texto, gráficos, fuentes, audio, vídeo u otros elementos de diseño se publicarán bajo una licencia https://creativecommons.org/licenses/by-sa/4.0/legalcode[Creative Commons By-SA]. + +Los datos disponibles en la plataforma, especialmente todos los datos que se pueden recopilar de manera sistemática a través de scrappers u otras técnicas de consulta masiva, se publicarán bajo licencia http://opendatacommons.org/licenses/odbl[Open Data Commons Open Database], en formatos estandarizados y accesibles (CSV, JSON, etcétera) y, siempre que sea posible, con herramientas que faciliten el análisis y la visualización de datos. + +== Transparencia, trazabilidad e integridad + +La plataforma y su configuración, desarrollo, implementación y uso actuales o futuros deben asegurar y maximizar en todo momento la transparencia, trazabilidad e integridad de documentos, propuestas, debates, decisiones o cualquier otro objeto, mecanismo o proceso participativo. + +Por transparencia entendemos que todos los datos relacionados con todos estos mecanismos y procesos participativos están disponibles para su descarga, análisis y tratamiento, siguiendo los estándares y formatos más exigentes para compartir información (accesibilidad, multiformato, etcétera). + +La transparencia es una condición necesaria para el seguimiento de los procesos y mecanismos participativos, pero en ningún caso debe aplicarse al tratamiento de los datos personales o contra la defensa de la privacidad de las personas que participan en la plataforma. + +Entendemos por trazabilidad la capacidad de hacer un seguimiento completo de propuestas, planes, regulaciones o cualquier otro objeto de participación o decisión, tanto pasados como futuros, incluidos en un proceso o mecanismo. La plataforma debe mostrar en todo momento cómo, por qué, a través de quién y con qué garantías se desestimó, se aprobó o se bloqueó un determinado tipo de objeto de un proceso participativo. + +Entendemos por integridad la autenticidad de un contenido específico, con la seguridad de que no ha sido manipulado o alterado sin que esta modificación esté claramente registrada y sea visiblemente verificable y auditable. El objetivo de la integridad es evitar la manipulación de propuestas o resultados de procesos o mecanismos participativos. + +== Igualdad de oportunidades e indicadores de calidad + +Junto con las garantías previamente definidas, la plataforma promete garantizar la igualdad de oportunidades para todas las personas, así como para sus propuestas u otras contribuciones que la plataforma pueda albergar. La plataforma ofrecerá iguales oportunidades de inicio a todos los objetos participativos (propuestas, debates, etcétera) para que se puedan conocer, debatir, comentar, evaluar o tratar sin que exista discriminación de ningún tipo. En este sentido, la identidad digital de los usuarios de la plataforma será siempre personal y no transferible, la verificación que confiere derechos de decisión sobre la plataforma también debe ser única y la responsable de asegurar la no representación de una persona o entidad será la entidad administrativa responsable de la plataforma. + +La plataforma debe promover, con el objetivo de garantizar su calidad democrática, el uso de indicadores de calidad desarrollados a partir de los datos obtenidos de los procesos participativos y los mecanismos y la actividad de los usuarios. Se promoverá que se comparta la configuración de los diferentes componentes, así como datos abiertos, para la definición de estos indicadores. + +La igualdad en la participación política de la ciudadanía es uno de los principios fundamentales de cualquier sistema democrático, y la plataforma no solo debe garantizar la igualdad de oportunidades con respecto a los usos y las funciones, sino también el derecho de acceso. En ese sentido, la entidad a cargo de la plataforma asume el compromiso de promover acciones enfocadas a proporcionar acceso y apoyo a la plataforma para todos los ciudadanos por igual de manera universal. Las herramientas y los recursos apropiados a la plataforma están disponibles para cualquiera que los quiera usar. + +== Confidencialidad de los datos + +Se garantizará en todo momento la confidencialidad y privacidad de los datos personales que las personas puedan proporcionar para participar en cualquiera de las funcionalidades o posibilidades de participación que la plataforma proporcione. Los datos personales no se transferirán, en ningún caso, a terceros. Tampoco se utilizarán más allá de lo estrictamente necesario para el registro de usuarios y mejoras en la usabilidad de la plataforma. Siempre que la tecnología de la plataforma lo permita, la expresión de las preferencias políticas o la voluntad en los procesos de toma de decisiones seguirá siendo inaccesible incluso para el administrador de la plataforma o el servidor o servidores que la alojan. + +== Compromiso y responsabilidad + +Se establecerá un compromiso con los ciudadanos para responder a todas las consultas y contribuciones en el menor tiempo posible. También se adoptará un compromiso para dar seguimiento a los resultados de los procesos participativos y responder a esas demandas específicamente. Por último, se adoptará el compromiso de estudiar la incorporación de indicadores para el seguimiento de los procesos de participación una vez finalizados con el fin de evaluar sistemáticamente su implementación. + +== Mejora continua y colaboración interinstitucional + +Se estipularán mecanismos de revisión y evaluación periódica para facilitar la mejora continua de la plataforma. + +Se dará prioridad a la colaboración y al intercambio de experiencias entre las instituciones involucradas en el proyecto con el objetivo de mejorar, fijar y construir nuevos desarrollos para la mejora continua de la plataforma. + +En este sentido, se facilitarán las condiciones y los entornos de colaboración cuando se avance en mejoras que apunten a un beneficio común de toda la plataforma, y se permitirán mecanismos de coordinación interinstitucionales cuando sea necesario. +Términos de uso + +Todos los puntos de este código deben reflejarse en el acuerdo de licencia de usuario final (EULA, por sus siglas en inglés), documento que cada organización que presta servicios utilizando Decidim establece con los usuarios y que nunca deberá ser contradicho. \ No newline at end of file From a54f668fd5adefbc7fe2d2275d3c2313c72fcada Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:02:13 +0200 Subject: [PATCH 323/336] New translations social-contract.adoc (German) --- .../understand/pages/social-contract.adoc | 60 +++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 docs/de/modules/understand/pages/social-contract.adoc diff --git a/docs/de/modules/understand/pages/social-contract.adoc b/docs/de/modules/understand/pages/social-contract.adoc new file mode 100644 index 0000000000..240f49069d --- /dev/null +++ b/docs/de/modules/understand/pages/social-contract.adoc @@ -0,0 +1,60 @@ += Decidim's Social Contract + +[NOTE] +==== +You can also read Decidim's Social Contract in other languages: xref:understand:social-contract-ca.adoc[Català] - xref:understand:social-contract-es.adoc[Castellano] + +If you want to translate it to your own language please https://decidim.org/contact[contact us]. +==== + +Code for democratic guarantees and open collaboration + +This is the social contract that all members of the Decidim community are committed to follow. + +By signing this Social Contract, any individual, institution or social group of any kind, commits to fulfill the principles established here when using, developing and participating in the community of Decidim. + +== Free software and open content + +The code of the platform, along with the modules, libraries or any other code that is developed for its functioning and deployment, will always be Free Open Source Software with an https://www.gnu.org/licenses/agpl-3.0.en.html[Affero GPLv3 license or later versions] whenever the code is newly developed and with licenses that are compatible with the above one when code re-used. + +Likewise, the content, data, APIs and/or any other interfaces that are deployed to interact with any type of user must follow open and interoperable standards (ex. OpenID, RSS, OStatus, etc.), always tending to maximize their integration with the most widely used open standards. + +In order to maximize transparency and citizen collaboration in participatory processes, organs and mechanisms, the content, text, graphics, fonts, audio, video or other design elements will be published under a https://creativecommons.org/licenses/by-sa/4.0/legalcode[Creative Commons By-SA]. + +The data available through the platform, especially all data that can be collected in a systematic way through scrappers or other techniques of massive consultation, will be published and licensed under http://opendatacommons.org/licenses/odbl[Open Data Commons Open Database License], published under standardized and accessible formats (such as CSV, JSON, etc.) and, whenever possible, with tools that facilitate the analysis and visualization of data. + +== Transparency, traceability and integrity + +The platform, and its current or future configuration, development, deployment and use must ensure and maximize, at all times, the transparency, traceability and integrity of documents, proposals, debates, decisions, or any other object, mechanism or participatory process. + +By _transparency_ we understand that all data related to all such participatory mechanisms and processes are available for download, analysis and treatment, following the most demanding standards and formats to share information (accessibility, multi-format, etc.). + +Transparency is a necessary condition for monitoring of participatory processes and mechanisms, but should never, in any case, be applied for the treatment of personal data or against the defense of the privacy of the people participating in the platform. + +We understand by _traceability_ the ability to fully track backward (past) and forward (future) what happened to the proposals, plans, regulations, or any other object of participation or decision included in a process or mechanism. The platform must at all times show how, why, by whom and with what guarantees a certain type of object of a participatory process was dismissed, approved or blocked. + +We understand by _integrity_ the authenticity of a specific content, and ensuring that it has not been tampered with or altered without this modification being clearly recorded and visibly verifiable and auditable. The goal of integrity is to avoid manipulation of proposals or results of participatory processes or mechanisms. + +== Equal opportunities and quality indicators + +Alongside the guarantees previously defined, the platform promises to ensure equal opportunities for all people, as well as for their proposals or other contributions the platform might host. The platform will offer equal starting opportunities to all participatory objects (proposals, debates, etc.) for them to be viewed, discussed, commented, evaluated or treated without discrimination of any kind. In this sense, the digital identity of the users of the platform will always be personal and not transferable, the verification that confers decision rights on the platform should also be unique, and it is the administrative entity in charge of the platform who should be responsible for ensuring non-impersonation of a person or entity. + +The platform should promote, with the aim of ensuring its democratic quality, the use of quality indicators developed on the basis of the data obtained from participatory processes, mechanism and user activity. Sharing of the setting of the different components as well as open data will be promoted for the definition of these indicators + +Equality in political participation of citizens is one of the fundamental principles of any democratic system and the platform, not only has to ensure equal opportunities with respect to the uses and functions, but also the access right. In this sense the entity in charge of the platform assumes the commitment to promote actions that advance in the direction of providing access and support to the platform for all citizens alike universally Giving tools and resources appropriate to the platform is available to anyone who wants to use. + +== Data confidentiality + +The confidentiality and privacy of the personal data that people might provide to participate in any of the functionalities and/or possibilities of participation that the platform provides shall be guaranteed at all times. In no case shall personal data be transferred to third parties. Personal data will not be used beyond what is strictly necessary for the purposes of user registration and improvements on the usability of the platform. Whenever platform technology makes it possible, the expression of political preferences or will in decision-making processes shall remain inaccessible even for the administrator of the platform or the server/s that host it. + +== Accountability and responsibility + +A commitment to citizens shall be taken to respond to all queries and contributions in the shortest time possible. A commitment shall also be adopted to follow-up the results of participatory processes and to respond to those demands which specifically request it. Finally, a commitment shall be taken to study the incorporation of indicators to monitor the participation processes once they are finalized, in order to systematically evaluate its implementation. + +== Continuous improvement and inter-institutional collaboration + +Mechanisms for periodic review and evaluation will be provided in order to facilitate the continuous improvement of the platform. + +Priority will be given to the collaboration and the exchange of experiences between the institutions involved in the project, with the aim to improve, fix and build new developments for the continuous improvement of the platform. + +In this sense, collaborative conditions and environments will be facilitated when moving forward improvements that point to a common benefit of the entire platform, enabling inter-agency coordination mechanisms when necessary. \ No newline at end of file From b5d931fb78f7c74cadf6eb87825cd3372f08f7d1 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:02:14 +0200 Subject: [PATCH 324/336] New translations decidim-a-brief-overview.adoc (German) --- .../pages/decidim-a-brief-overview.adoc | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 docs/de/modules/whitepaper/pages/decidim-a-brief-overview.adoc diff --git a/docs/de/modules/whitepaper/pages/decidim-a-brief-overview.adoc b/docs/de/modules/whitepaper/pages/decidim-a-brief-overview.adoc new file mode 100644 index 0000000000..886e8bd9f5 --- /dev/null +++ b/docs/de/modules/whitepaper/pages/decidim-a-brief-overview.adoc @@ -0,0 +1,16 @@ += Decidim: a brief overview +:experimental: +:icons: font +:page-partial: +:source-highlighter: highlightjs + +IMPORTANT: The content of this section is a fragment of Barandiaran, X., Calleja-López, A. & Monterde, A. (2018). Decidim: political and technopolitical +networks for participatory democracy. __Decidim’s project white paper__, pp. 7-26. (You can http://ajbcn-meta-decidim.s3.amazonaws.com/uploads/decidim/attachment/file/2005/White_Paper.pdf[download an alpha version of the document here]) + +*We have been busy building Decidim, it is now time to explain it*. The goal of this white paperfootnote:[A white paper is document that expresses the principles, vision, technical details and insights of a project with the goal of explaining, detailedly and contextually, its value, to help others understand, join and support the project.] is to explain in detail the nature of the Decidim project. The paper comes to fill a long lasting gap and outlines what the project is really about, why it is relevant, and how we (the Metadecidim community) have made it possible and developed it so far. It presents the Decidim platform, its features and design principles, but also other dimensions of the project, from the political to the technical. It also outlines the theoretical and political vision, as well as the practical and organizational work behind the project. This document also situates Decidim in a historical context defined by political struggle. Furthermore, it discusses some of the sociopolitical problems it tries to address and the possibilities it opens up looking forward. Authorship of this document entails not more, not less, than putting together, making explicit and elaborating a set of theoretical and practical principles and guidelines that have been developed by a multitude of participants in our community. + +*How to read this white paper and make it yours*. Readers might be interested on different dimensions of the project and we encourage you to find the chapter or section that best matches your interests. The introduction however is worth reading for any of you. We start with a brief explanation of what is Decidim, a definition of the project, how the platform works, the social contract that binds the project together, a description of the community and ecosystem behind it, the model of democracy that it embodies and the three dimensions of the project: the political, the technopolitical and the technical. We next move into the context in which Decidim has been developed to explain why we thought it was necessary to initiate or join this project, why it is relevant today both in the context of a crisis of democracy as we knew it and the context of an increasing control of social digital infraestructures by a few corporations. The rest of the paper is structured along the three planes or dimensions of the project: the political plane explains the model of democracy that Decidim embodies and makes possible, contrasting it with different limitations and models of contemporary democracy (representative democracy and party politics, technocracy and neoliberal models of governance, etc.) highlighting how Decidim makes possible to strengthen new and old forms of participatory democracy, collective intelligence and multitudinous political identities in public institutions and social organizations alike. The technopolitical planefootnote:[In short, by technopolitics we mean the intersection and hybridization of technology and politics. This is a conception of politics that focuses on the technical articulation of power, its structure and exercise, highlighting and intervening on devices, interfaces, codes, protocols, networks and methods in contrast with conceptions of politics that focuses on ideas, discourses, symbols and reasons. It is a conception of technology that focuses on its political dimensions, its mutability and its construction, highlighting and intervening in the power relationships, ideologies and logics in contrasts to views that understand it as value neutral and objective matters.] explains how this is made possible through the platform, its design principles, best configuration practices and the technological articulation of the project’s internal politics through the platform: the Metadecidim community. Finally, we extend into the details of the technical articulation of the project: how the software is produced, its architectural details, organizing protocols, legal licenses, collaborative practices, training programs, etc. + +include::what-is-decidim.adoc[leveloffset=+1] + +include::why-decidim.adoc[leveloffset=+1] \ No newline at end of file From 28983da0971039bfe72360660bee9f22d0cfac6f Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:02:15 +0200 Subject: [PATCH 325/336] New translations what-is-decidim.adoc (German) --- .../whitepaper/pages/what-is-decidim.adoc | 51 +++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 docs/de/modules/whitepaper/pages/what-is-decidim.adoc diff --git a/docs/de/modules/whitepaper/pages/what-is-decidim.adoc b/docs/de/modules/whitepaper/pages/what-is-decidim.adoc new file mode 100644 index 0000000000..e6c4a8d64a --- /dev/null +++ b/docs/de/modules/whitepaper/pages/what-is-decidim.adoc @@ -0,0 +1,51 @@ += What is Decidim? +:experimental: +:icons: font +:page-partial: +:source-highlighter: highlightjs + +.Video: https://youtu.be/f6JMgJAQ2tc[Decidim: Free Open-Source participatory democracy for cities and organizations]. +video::f6JMgJAQ2tc[youtube, width=720, height=390] + +Decidim [http://decidim.org[http://decidim.org]], from the Catalan "let's decide" or “we decide”, is a digital platform for participatory democracy. +More specifically, Decidim is a web environment (a _framework_) produced in _Ruby on Rails_ (a programming language) that allows anybody to create and configure a website to be used in the form of a political network for democratic participation. It is built entirely and collaboratively as https://en.wikipedia.org/wiki/Free_software[free software]. + +The platform allows any organization (local city council, association, university, NGO, neighbourhood or cooperative) to create mass processes for strategic planning, participatory budgeting, public consultation, collaborative design, etc. It also makes possible to connect traditional in-person democratic meetings with the digital world: sending meeting invites, managing registrations, facilitating the publication of minutes, etc. +In addition, Decidim enables the structuring of government bodies or assemblies (councils, boards, working groups), the convening of consultations, referendums or channelling citizen or member initiatives to trigger different decision-making processes. Yet, the Decidim project is much more than that. + +*Definition*: _Decidim is a public-common’s, free and open, digital infrastructure for participatory democracy_. + +- By “participatory democracy” we mean that form of “government of the people, for the people and by the people” in which people take part as equals or peers (from latin _pars_, part, and _capere_, to take). By taking part we mean that, under the current political model, people take the part _of_ the sovereign power that belongs to them. And this should be an equal part for each. Moreover, we also mean, under an alternative model, to take part _in_ the autonomy of the social and political life, in the construction of collective potency: the capacity to coordinate and commit to collective action. +- The term “digital infrastructure” makes reference to a set of tools, resources, data-sets, documents, codes (legal, computer, etc.), interfaces and services that are digitalized or made accessible by digital means. This infrastructure is primarily a software platform for participatory democracy. ++ + Participants can create proposals, sign and support them, comment, receive notifications, attend public meetings or receive the minutes of the session. Administrators can design participatory processes, define the structure of democratic organs (like councils or committees), configure types of initiatives or set up consultations. The infrastructure also includes documentation, design (icons, images, logos, etc.), legal documents, datasets or training resources, among others. All these make possible to deploy a participatory democratic system in any organization (be it a municipality, a cooperative, an association, a union or a community). +- By “free and open” we mean that the project’s goods (the assets of the infrastructure) do no fall under the form of private property that excludes others from accessing, using, copying, modifying and re-publishing or reusing these resources but, instead, displays all the legal, technical and social means necessary to share them and open them to collaboration. +- Finally, the term “public-commons” indicates that the project is mostly financed and made possible by public institutions and is managed and designed by an open community constituted by public-servants, members of different associations, university researchers and students, activists and staff from foundations, workers from different companies or simply volunteers that commit to the principles of the project. For this infrastructure to be a common’s it is important that these partners organize democratically in relation to the project. In this sense, Decidim is a reflexive infrastructure that uses the very infrastructure to democratize itself through the MetaDecidim community. + +*Platform features and functional architecture*. Since the digital platform displays and embodies both the means of project organization and its democratic principles, it is important to explain how the platform works. Users of the platform (participants) interact through participatory mechanisms known as _components_ within different participatory _spaces_ that channel their democratic power to specific results. Participatory spaces are the frameworks that define how participation will be carried out, the _channels_ or means through which citizens or members of an organization can process requests or coordinate proposals and make decisions. _Initiatives_, _Processes_, _Assemblies_ and _Consultations_ are all participatory spaces. Specific examples of each of these include: a citizen initiative for directly changing a regulation (_Initiative_); a general assembly or workers’ council (_Assembly_); a participatory budgeting, strategic planning, or electoral process (_Processes_); a referendum or call to vote “Yes” or “No” to change the name of an organization (_Consultation_). The more notable components that are combined into spaces to deliver participatory mechanisms include in-person _meetings_, _proposals_, _blogs, debates, static information pages, surveys_, _results_ and _comments_. So, for example, the various phases of a participatory budgeting process (where members of an organization are called to decide how to spend a budget) can combine components in the following way: at an early phase, public meetings can be opened for citizens to analyze different needs classified by districts. In turn these meetings can lead to the design of a survey. The survey results can next be used to define a set of categories for projects to be proposed. The proposal component might then be activated for participants to create and publish their projects as solutions to the identified needs. These proposals can be commented on. After a period of deliberation, the voting component can be activated to select among the projects using a budget-expenditure system. Participants can then be called to a public meeting to evaluate the results and an assessment survey can then be launched for those who could not attend the meeting. Finally, the accountability component can be activated to monitor the degree of execution of the selected projects and people can comment on it. This is but one example of how components are combined in a space, but there are many other combinatorial possibilities. What makes Decidim particularly powerful is this combination of components within spaces, which provides an organization with a complete toolkit to easily design and deploy a democratic system adapted to its needs. + +*The social contract*: All members and partners of the Decidim project must endorse and follow a “https://decidim.org/contract[social contract]” that defines a set of guiding principles. The social contract can be summarized as follows: 1. _Free software and open content_: Decidim will always remain free and open to collaboration, without legal or technical obstacles for the use, copy and modification. To ensure this we use a set of licenses: https://www.gnu.org/licenses/agpl-3.0.html[Affero GPLv3] for the code, https://creativecommons.org/licenses/by-sa/4.0/[CreativeCommons By-SA] for the content (text, images, design, etc.) and https://opendatacommons.org/licenses/odbl/1-0/[Open Access Database License] for data. This means that Decidim will always remain auditable, collaborable, transparent, appropriable and trustworthy, all of which is fundamental for a democratic infrastructure. 2. _Transparency, traceability and integrity_: the content of participation will always remain transparent, traceable and integral. This means that all the content must be accessible and downloadable, it should always be known what happens with each proposal, its origin, where it was incorporated or why it was rejected, and the content needs to be displayed without been manipulated, any modification (if required) must be registered and be accessible and auditable. 3. _Equal opportunities, democratic quality and inclusiveness_: the platform must guarantee the democratic quality, the non-discrimination and equal opportunities for each participant and proposals, including objective indicators. The platform must comply with accessibility standards, its use must favour the integration of online and offline participation and organizations must deploy the means for mediation and training of participants. 4. _Privacy with verification_: participants must retain privacy of their personal data combined with verification. Personal data should never be displayed, nor sold or transferred to third parties while, at the same time, the unicity and democratic rights of participants must be preserved (meaning there cannot be two verified users corresponding to the same individual with democratic rights and all participants with such rights must be verifiable). 5. _Democratic commitment, responsibility and collaboration_: institutions using Decidim must commit to respond on time, be accountable for decisions taken through the platform, and to openly collaborate on its improvement. + +*Instances*. The best known and intensively used instance of Decidim, as a digital platform for participatory democracy, is https://decidim.barcelona[www.decidim.barcelona], with (as of December 2018) more than 30,000 registered participants, more than 1.5 million page views, over 300,000 visitors, 35 participatory processes, 1,141 public meetings channelled through the platform and 13,297 proposals, out of which over 9,196 have already become public policies grouped into 5,485 results whose implementation level can be monitored by citizens. The instance that actively explores more functionalities is http://meta.decidim.org[meta.decidim.org], the community portal that designs and supports the project. There is also a demo site with the latest version available for exploration and a training instance open to anybody to learn how to configure, administrate and use the platform. There are currently more than 70 instances of Decidim for organizations of different sorts ranging from municipalities such as https://osallistu.hel.fi/[Helsinki] or https://erabaki.pamplona.es/[Pamplona], to regional governments like the https://participa.castillalamancha.es/[Junta de Castilla la Mancha] or the https://participa.gencat.cat/[Generalitat de Catalunya], national governments like the https://monopinion.belgium.be[Belgium Federal State], NGO networks such as https://assembly.fundaction.eu[Fundaction] or https://participa.quorumglobal.org/[QuorumGlobal], cooperatives like https://participa.somenergia.coop/[Som Energia], or the https://participons.debatpublic.fr/[National Commission for Public Debate] (_Commission Nationale du Débat Public_) in France. We have an https://decidim-monitor.herokuapp.com[online monitoring tool] that captures the relevant public data of known Decidim instances around the world. + +*A sustainable ecosystem*. Developed at Barcelona’s http://ajuntament.barcelona.cat/innovaciodemocratica/en[Laboratory for Democratic Innovation], Decidim is the result of the joint effort of a network of collaborating entities and multiple participants leaded by Barcelona’s City Council. Apart from the organizations that use the platform and whose participants and administrators report bugs and suggest improvements, there is a network of 17 different collaborating entities, from software companies to institutional consortia, from research institutions to civil associations. The https://meta.decidim.barcelona/[Metadecidim] community uses an instance of the Decidim platform to organize the different dimensions of the project. As of August 7th 2018 it has 379 registered participants, it hosts minutes of 126 public meetings, details of eight assemblies or working groups, four participatory processes (welcome process, bug reporting, feature proposals, and training workshop process) together with various initiatives and two consultations aimed at defining the roadmap and software design of the platform, bug reporting, community and project governance, research and development. Official documentation and code are developed on https://github.com/decidim[Github] where the project hosts more than 20 repositories with over 50 contributors. They all together generate a sustainable ecosystem that governs, produces and provides services over the platform (deployment, adaptation, configuration, training, consultancy, administration, etc.). + +*Democracy and social empowerment*: Decidim was born in an institutional environment (that of Barcelona City Council during Ada Colau’s mandate 2015-2019 and under the impulse of Gala Pin councillor for participatory democracy), directly aiming at improving and enhancing the political and administrative impact of participatory democracy in the state (municipalities, local governments, etc.). But it also aims at empowering social processes as _a platform for massive social coordination for collective action_ independently of public administrations. Anybody can copy, modify and install Decidim for its own needs, so Decidim is by no means reduced to public institutions. There are different ways in which participatory democracy infrastructures can boost social, economic and political self-organization. Decidim is starting to be used for these purposes: for the internal organization of consumer and producer cooperatives for example, it is also helping movements organize and to design strategic planning, and it might soon be used to coordinate massive strikes or other forms of social action. The modular nature of its architecture is also enabling these organizations to develop their own components and improvements (such as crowdfunding, membership management, etc.) and to plug them back into Decidim, expanding its potential. Decidim comes to fill the gap of public and common’s platforms, providing an alternative to the way in which private platforms coordinate social action (mostly with profit-driven, data extraction and market-oriented goals). Ultimately, Decidim aims to present an alternative to the existing model of digital economy sponsored by corporate digital platforms (Amazon, AirBnB, Uber, etc). + +*The political, the technical and the technopolitical*. As we have repeatedly stressed, Decidim is more than a technological platform. It has required to assemble a variety of codes, realities and dimensions that go beyond programming code. We define it as a “technopolitical project” where legal, political, institutional, practical, social, educational, communicative, economic and epistemic codes merge together. Ultimately, Decidim is in itself a sort of crossroad of the various dimensions of networked democracy and society, a detailed practical map of their complexities and conflicts. We distinguish three general planes or dimensions of the project: the _political_ (focused on the democratic model that Decidim promotes and its impact on public policies and organizations), the _technopolitical_ (focused on how the platform is designed, the mechanisms it embodies, and the way in which it is itself democratically designed), and the _technical_ (focused on the conditions of production, operation and success of the project: the digital factory, collaborative mechanisms, licenses, etc.). The political plane is best illustrated by the use of Decidim in a city or organization, the type of democratic processes and decisions that are made through it. In other words, it covers what kind of politics can be done using Decidim: what kind of governance, conflict and power relationships can be channelled through it, thus, the kind of democracy it is capable to produce. Its model instance is decidim.barcelona, what happens within, how it alters the political space of the city. The second plane, the technopolitical, includes matters concerning the digital architectural design of Decidim: its interfaces, features, design principles, data policies, user experience, etc. It is a primarily a reflexive space of how technologies structure political processes. It is embodied in the Metadecidim platform and the community that surrounds it. Finally, the technical plane encompasses issues concerning primarily the programming and legal codes (information and legal infrastructures), but is also includes issues of education and knowledge (epistemic infrastructures), spatial and working organization. All three dimensions are part of the project. + +.Systematization footnote:[We have chosen Barcelona here as a scale of reference, but it could be the EU, or any other political territory or democratic organization. The term “scale” does not refer here to territorial extension, but to the number of agents and organizational complexity: the political involves more complexity, more agents, more conflict, more diversity and width of decision to be made, the technopolitical is a smaller community scale, the technical is a laboratory or factory that covers a subset of this community.] of various aspects of the Decidim project in the political, technopolitical and technical planes with the city of Barcelona as a reference. +[cols="\"", ,, ,", options="header"] +|=== +|Plane +|Relation +|Platform +|Mode +|Scale + +|Political |Superstructure |decidim.barcelona |Co-decision |City + +|Technopolitical |Structure |Metadecidim |Co-design |Community + +|Technical |Infrastructure |github.com/decidim |Co-production |Laboratory +|=== \ No newline at end of file From b08cc54883957d022d99b51e896ee039bbd44e8b Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Wed, 27 Sep 2023 18:02:16 +0200 Subject: [PATCH 326/336] New translations why-decidim.adoc (German) --- .../modules/whitepaper/pages/why-decidim.adoc | 55 +++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 docs/de/modules/whitepaper/pages/why-decidim.adoc diff --git a/docs/de/modules/whitepaper/pages/why-decidim.adoc b/docs/de/modules/whitepaper/pages/why-decidim.adoc new file mode 100644 index 0000000000..97722615c2 --- /dev/null +++ b/docs/de/modules/whitepaper/pages/why-decidim.adoc @@ -0,0 +1,55 @@ += Why Decidim? + +:experimental: +:icons: font +:page-partial: +:source-highlighter: highlightjs + +The context that has given birth to Decidim is defined by two interconnected phenomena, each of which displays two poles. On the one hand, the last decades have witnessed a crisis of representative democracy (weakening of the Welfare State, subordination to market forces, inability to deal with global problems such as climate change, etc.) as well as the essay with some alternatives, such as grassroots organizations, new parties and institutional forms. On the other, the rise of cognitive capitalism, a system where the exploitation of information, knowledge, affects, and social relations has become core to the generation of economic value, is opposed by the emergence of free software, knowledge and culture. Both phenomena are deeply intertwined, and Decidim is born right at their very intersection, responding to the challenges and opportunities that they open for democracy. In this section, we briefly analyze these two phenomena, with a special focus on the way they impact contemporary democracy. + +== The contemporary crisis of democracy and its alternatives + +*Success and decline of liberal, representative democracies*. The basic structures of representative democracy have barely been updated in the last two centuries. The last three decades have seen both their success (with the multiplication of liberal democratic states all over the world) and their declinefootnote:[The decline has been ongoing for the last two decades, at least (Rosanvallon, 2008), and has been noticed across the “ideological and methodological spectrum” (Tormey 2015: 15). So much so that the crisis of liberal representative democracy has been identified with the crisis of democracy itself (Keane 2009; DellaPorta 2013). Different authors have denounced the technocratic tendencies and the neoliberal hegemony in this same period as heralding a stage of post-democracy (Crouch, 2004) or post-politics (Zizek, 1999; Rancière, 2001), while others, in a more limited way, have used the term "post-representation" to refer to the emptying of power and meaning of representative institutions by dynamics ranging from globalization and the dismantling of the welfare state to dis-affection and dis-empowerment (Brito Vieira and Runciman, 2008; Keane, 2009; Rosanvallon, 2011; Tormey, 2015). The meanings of “post-representation” are multiple, though, connected with different political readings of the crisis and the potential ways out of it, from those that give conjunctural interpretations to those that tie it to the transformations of modernity, its subjectivities and modes of sociality (Tormey, 2015).] (as diagnosed in a wide literature ranging from Pharr & Putnam, 1999 to Tormey, 2015). The decline has been expressed in various forms; we will mention two: practically, in the inability of contemporary democracies to deal with problems such as rising inequality (Piketty, 2014) or climate change (Klein, 2015); politically, in the decline of participation and trust in political parties and political representatives, as well as other political institutions (Mair, 2006; Castells, 2017). + +*Structural limits of representative democracy*: the triple challenge of complexity.footnote:[This section is a theoretical reconstruction of aspects that are historically embedded and power-laden.] The structure of modern democracies is based on representation (and, more specifically, electoral representation, Manin 1997, Van Reybrouck 2016), that is, on a series of mechanisms by which a few actors (political and administrative) are elected to manage public issues in the name of the whole of the citizenry, and are in principle accountable to it. Representation had its roots in medieval institutions, as a mechanism for nobles and knights to push their demands in exchange for consenting taxation (Pitkin, 1967). But it has proven its limits in coping with complexity and conflict: the complexity and conflictuality of society, of reality, and of organization. + +1. In social terms, it had to face the growth of the franchise, incorporating an ever more diverse constituency, and, in the last decades of the XXth century, the rise in cultural diversity, consumerism and the ideology of consumer choice in Western democracies (Laclau & Mouffe, 1985; Sennett, 1977, 1998) that generated an ever-growing variety of desires and perspectives to be listened to and articulated in government action. Furthermore, representation has proven open to systemic practices of nepotism or corruption, usually by powerful economic interests (Buchanan & Tullock, 1962; Peltzmann, 1976). In this context, representative mechanisms have ended up imposing the will of the few over the complex and conflictual wills of the people in public policy. +1. The second key challenge of complexity had to do with the reality. As the technoscientific transformation of reality accelerated, the responsibility and complexity of the problems facing public policy (f.i.: climate change) has only increased; and yet many of the systems for detecting social problems and mobilizing social knowledge to address them have remained oligarchic. The attack Friedrich Hayek (1944, 1945) launched on socialist planning can be launched against representative democracy too: reality is too complex for a centralized decision-making system. +1. The third challenge of complexity fed back into the previous two: it is the challenge (or meta-challenge) of communication and organization. Mobilizing and organizing the will, the knowledge, and the collective action of society into public policy faced numerous socio-technological limits: the millions of members composing a given social group could not express their will nor contribute their knowledge and effort to address their matters of concernfootnote:[Organization or knowledge may be insufficient to solve the problems facing democracy today. However, we there are reasons to believe they can contribute to do so.]. Still in the XXth century, the infrastructure required to bring an expression of will or knowledge of people distributed geographically or socioeconomically (f.i.: laborally) into a common problem or decision seemed out of reach. Even if they wanted, people could not gather in assemblies or other political processes: people were too many, lived far from each other, had their work schedules, and no free time at all. + +Representative democracy, where the many elect a few every four years, became a raw and oversimplified articulation of the will and knowledge of the many, in terms of the management by the few. So raw and simplified that it couldn’t solve the problems of society and became one of them: the people’s will was not represented or properly constructed but captured, the real problems were not solved by public representatives, but externalized to the market to be solved, and the problems generated by the market too often remained unsolved. + +*Social limits of representative democracy: the challenge of economic powers and the rise of neoliberalism*. The problems of representative democracy today are not of complexity only, though. They have as much to do with issues of social power. Many of the ailments of representative democracy in the last three decades can be rooted in three key shifts of power (DellaPorta, 2013: 23; Offe, 2011: 457): a shift of power from parties and parliaments to executive powers, reducing the meaning of parliamentary and party politics; from State to Market, with processes ranging from externalization and privatization of public services to the introduction of competition logics in public administration ( the process of “emptying out the State”, specially, the Welfare State, Rhodes, 1994), as well as the rise in power of global corporations; and from nation-states to international governmental organizations such as the EU, the IMF or the World Bank, frequently aligned with such corporations, emptying both States and democracies of much of their legitimacy and power (Laval & Dardot, 2017; Crouch, 2011; Sánchez Cuenca, 2014). Political parties have suffered particularly: from the mid XIXth to the mid XXth century, the mass party model was guided by clear programs and rooted in a thick social structure connected to grassroots spaces and organizations, unions, media, and so on. The catch all party model rising in the 80s, however, had pragmatic, variable programs and supported itself primarily in mass media (in particular, tv) and polls. A fragmentation of socioeconomic composition and the discourses around it, no more easily divisible into “capitalist and proletarians” (Laclau & Mouffe, 1985), as well as the rise of a mass-mediatized consumer society based on an exaggerated and depoliticising individualism (Sennett 1977, 1998) paved the way for such party transformations. The traditional mass party saw a steady decline of its grassroots in Western democracies until today. This emptying out of representative democracy was tied to the rise of neoliberalism[multiblock footnote omitted], and has brought a crisis of legitimacy and meaning of democracy itself, frequently identified with representation (Crouch, 2004; Streeck, 2016). The Great Regression of 2008 (Eichengreen & O’Rourke, 2009) and the austerity politics that followed it (Blyth, 2013) seemed to confirm this shift and its implications, with States first going into debt to save the financial sector and then applying (or being applied) austerity policies without or against citizen consultation, guaranteeing the sustenance of capital accumulation while losing more and more capacity for social provision (Jessop, 2015). + +*The alter-globalization challenge to the shift of power away from democracy*. These processes haven’t gone unchallenged. The last two decades have been a period of democratic movements of resistance. At the turn of the century, the alter-globalization movement called for an alternative to the rising neoliberal globalization, an alternative globalization tied to a radicalization of democracy, social justice, human rights, as well as economical and ecological sustainability (Klein, 1999; Stiglitz, 2002; DellaPorta & Tarrow, 2005). This “movement of movements” had socio-technical networks as a key part of its organization. It generated a “cultural politics of networking” where networks operated not only as technologies, but also as models for the definition of social norms and political forms (Juris, 2008): features such as free association and information, non-hierarchical and flexible organizations, globally distributed but synchronized, locally rooted action, or autonomous networked media were among its key features. + +*The crisis of legitimacy of the neoliberal-democracy narrative*. Beyond the work of these movements, it was the 2008 Great Regression what brought about a crisis of legitimacy of the neoliberal narrative. It opened a period of crisis of neoliberalism (Dumezil & Lévy, 2011), not so much in economics but, specially, in political and social terms (in economic terms the crisis lasted less, followed by a deepening of accumulation processes, Jessop, 2015): the discredit of narratives praising free trade, privatization, international economic institutions, and global markets, otherwise, the discredit of the ideological practice preeminent since the 80s, spread along with new social and political movements, from the progressive to the reactionary. This crisis of neoliberalism fed into the crisis of representation mentioned earlier, with a peak of distrust towards official institutions, from politicians and governments to banks. The result has been a crisis of the existing model of neoliberal representative democracy (Castells, 2012, 2017; DellaPorta, 2013; Gerbaudo, 2012, 2017). + +*The 2011 wave of networked movements of the squares*. 2011 is a key year in political terms. Progressive social movements swept the world, from the Arab Springs in the North of Africa to Occupy Wall Street in North America: they challenged the political and economic status quo and the rising inequality, while reclaiming a more radical democracy (Postill, 2017; Gerbaudo, 2012; DellaPorta, 2013, Flesher Fominaya, 2014). The 15M movement was among the key referents of this wave of networked movements of the squares, which intensively used digital networks. In Spain, 15M was at the upshot of a cycle of contention that saw the emergence of new forms of collective organization (from the networked squares of 2011 to the direct action tactics of the Platform of People Affected by Mortgages Romanos, 2014), new political parties (from Podemos to Barcelona en Comú), and the victories in dozens of cities by citizen initiatives in the Spring of 2015 (Cádiz, Barcelona, Madrid, A Coruña, etc.) (Feenstra et. al, 2017; Calleja-López & Toret, 2019). The use of digital platforms were crucial in all of these undertakings, oriented to increase the depth of participation of anyone and everyone into the political field (Aragón et al., 2017; Calleja-López, 2017; Monterde, 2016; Toret et al., 2015). Digital networks seemed to provide spaces where the disaggregating forces of neoliberal society were partially and temporarily countered and redirected to nurture collective action both online and offline. The upward extractivism of global finance and corporations was answered with democratic, locally rooted and globally connected initiatives. In the case of Spain, the struggle around the city, from the squares of 2011 to city halls in 2015, has become ever more relevant in this trajectory, in the form of municipalism (Rubio-Pueyo, 2017; Junqué & Shea, 2018; Roth, Monterde & Calleja-López, 2019). + +*The rise of right-wing populism*. But these achievements have showed limits and perils, too. At the international scale, the wave of movements tended to fizzle out. In countries such as Spain and Tunisia, the movements left new parties or constitutions, even though the general political and economic landscape remained gloomy (Castells, 2017); countries such as the US or Egypt (or Spain itself), has seen the advent of increasingly authoritarian governments. Moreover, right wing movements spread across Europe and North America (Castells, 2017). The final result has been defined as the end of the neoliberal era and the advent of a populist moment (Gerbaudo, 2017; Rodrik 2017), in which the basis of the _status quo_ loses its compelling power and is challenged by actors invoking the common people, from left and right, with recent successes for the latter such as the rise of Donald Trump to the presidency of the US or the Brexit. The various negative effects of neoliberalism, particularly accelerated after the Great Regression, such as increasing inequality, the normalized connivance between economic and political power, the dismantling of welfare structures along with rising public debt, social and political disempowerment in the face of transnational corporate and financial powers, the eclipse of the public sphere resulting from phenomena such as a rising individualism or closed multiculturalism (Sennet 1977, 1998), have generated a suspicion towards the status quo in which right wing and nationalist positions are gaining ground. In many cases, such rise was facilitated by social networks such as Facebook and Twitter, used by corporations (such as Cambridge Analytica), or political actors (such as the Trump or the Brexit communication teams). We analyze the various edges of this phenomenon in the following chapter. Resuming, in the political plane, the last decades have witnessed the tension between processes showing the limits or undermining democracy and others trying either to stop such undermining, or even calling to radicalize democracy. Decidim is firmly rooted in this last trend. + +== The rise of the network society, cognitive capitalism and knowledge commons + +*First generation digital networks: informational networks.* A similar opposition between conservative tendencies and progressive ones can be found on the moving field of the so-called digital economy. The 90s saw the rise of the Internet and the WWW to the status of phenomena of global proportions. The initial hopes for the cyberspace envisioned by figures such as John Perry Barlow (in this Declaration of Independence of Cyberspace) anticipated a time where many of the old social structures would be superseded by a new dawn of human creativity and freedom from old governments and social constraints (bodies, sexes, races, etc.). Since its origin, the construction of the internet resulted from the conflicting interests, visions, and practices of various actors (Abate, 1999; Rasmussen, 2007), specially, military and research actors. The idea of a distributed (and thereby resilient) information network was tied to the threat of possible high scale attacks to information centers by the Soviet Union (Baran, 1964), but even more so to practices and narratives of information and knowledge circulation and freedom among university researchers (Leiner et al., 1997). Already in the 1990s, a first generation of worldwide digital networks, informational networks, paradigmatically exemplified by the World Wide Web, allowed free the flow of information and users between websites. + +*Old and new communication powers: from mass communication to mass self-communication.* This seemed to be the dawn of a “networked public sphere” (Benkler, 2006), where earlier mediators of social communication receded from view. The XXth century protagonism of capital-intensive media such as radio, newspapers or TV, with their olygocratic editorial teams, seemed to give way to an explosion of uncensored digital media such as websites and blogs. Social communication was said to be in its way to de-intermediation, its power to be more equally distributed (Rushkoff, 2002; S Republic of Letters in XVIIth and XVIIIth centuries), had been shaken in the XIXth and XXth centuries by technologies that afforded one-to-many circulation of informhirky, 2009). Early modern communication ecologies, based in one-to-one interactions, either face to face or via letters (which still generated complex systems such as theation such as newspapers, radio or TV: this was the model of broadcasting, which potentiated a centralization of social communication, mass communication, where a the majority of the public played a passive role. The Internet and social media afforded new versions of these earlier communication models, and combined it with a new model, that of many-to-many communication, in which many emissors were able to generate (and react to) messages reaching many others, without having to pass through any mediating center (Kellner, 1999). This was giving way to “mass self-communication” , a model in which mass communication is “self-directed in the elaboration and sending of the message, self-selected in the reception of the message, and self-defined in terms of the formation of the communication space” (Castells, 2009). This did not imply an equal redistribution of communication power in society but rather its re-structuration, with new actors, including networked social movements, having an opportunity to play a role in a media sphere earlier controlled by big corporations. The fourth power of mass media journalism gave way to a fifth power: digital networks (or perhaps to a complex, more decentralized form of the fourth, a “hybrid media system”, Chadwick, 2008). + +*The rise of informational and cognitive capitalism.* The Internet and digital networks did not only affect the public sphere in a potentially democratizing tendency, they also greatly contributed to push globalization forward as a historical process, beginning with the acceleration of global finance (Castells, 1996). At the core of the economy behind neoliberal globalization were information and other immaterial assets, such as knowledge, affects, human relations, etc. The result was a new form of capitalism: informational and cognitive capitalism (Castells, 1996; Fumagalli, 2007; Moulier-Boutang, 2007; Vercellone, 2006). Differently from industrial capitalism, where the transformation of material resources into commodities was at the core of the process of capital accumulation, now it was information, knowledge, affects, and social relations what became key in the generation of economic value. Intellectual property is a key legal mechanism under this new paradigm, used to privately appropriate social knowledge and natural information, e.g.: strong copyrights on books and music, patents on technoscientific innovations, traditional medicines and techniques, or animal and plants DNA (Fumagalli, 2007). This in spite of the fact that information and knowledge are non-rival goods, with zero marginal cost, meaning that they can be reproduced and used without depletion. Furthermore, in most cases their value increases with use: the bigger the spread of trademark the higher its value, the more a song is listened to the higher its value. While digital networks provide the means to freely reproduce and re-distribute this kind of goods, artificial scarcity is generated via legal and technological mechanisms. This appropriation has not only the form of a “theft”, but is rather based on structures and processes (from education to entrepreneurship policies) that orient, transform and produce new personal and collective practices, desires, affects and relations sustaining the neoliberal system (Laval & Dardot, 2014). + +*From cognitive capitalism to platform & surveillance capitalism*. In time, the digital element in these processes has only gained prominence. The so called web 1.0 (O’Reilly, 2005) exhibited various limits to users’ interactions with both digital contents and other users. Differently, web 2.0 was all about interaction: the web as a platform. This exponentially increased the quantity and quality of information that could be extracted. By the late 2000s the emancipatory hopes tied to social networks were heavily in dispute (Morozov, 2011), and by the late 2010s the situation seems to be rather the opposite of the anticipated. From Amazon to Tinder, technological platforms are a way for a few corporations to extract data (going from activity, to opinions, to metadata), while leaving users with a little a say on what is gathered, how it is used or how the resulting benefits are distributed; this institutes a regime of “data extractivism” (as suggested by Evgeny Morozov). These corporations have access to more details of the lives of millions of people than any State or corporation to date. Combined with the development of new techniques of big data analysis and the always increasing rate of computing power, the infrastructural conditions were there for a socioeconomic mutation. Corporations such as Google or Facebook were heralding a specific form of informational and cognitive capitalism, which has been variously qualified as “platform”, “data” or “surveillance” capitalism. These three names speak of three connected elements: digital infrastructures, data, and social control. Digital platforms have become the basic means of production and management of a valuable resource (data) out of its source, human activities (Srnicek, 2017). Data, considered as the new “oil” (The Economist, 2017), “infrastructure” (Kawalek & Bayat, 2017; Prospect, 2017), “labor” (Arrieta et al., 2017), etc. is processed using data science methods and business intelligence (from modern statistics to Artificial Intelligence). Then, it is used in various ways in social processes of data-driven politics, science and economics (Lohr, 2015). This process of extraction, processing, and use is radically oligarchic. Corporations such as Alphabet (which includes Google), Microsoft, Amazon or Facebook have earned a monopolistic positionfootnote:[Alphabet, Microsoft (a giant from the early days of cognitive capitalism) and Amazon occupy three of the four top positions of the rankings by market capitalization. Facebook occupies the 8th place, but remains the third most visited web, with Google and Youtube (both owned by Alphabet) being the first and the second, according to Alexa and SimilarWeb, as of March 2018.]. A few actors have become the owners of both platforms and data and can thereby surveil social life in order to experiment with it: surveilling thereby appears as a first step to what we may define as “surwilling”, or willing and shaping the will of others from above; otherwise, platform corporations move from unveiling social life to orienting (or “willing”) it from above. If surveillance intrudes into privacy, into the negative freedom of people (to use Isaiah Berlin’s), into their freedom-from, surwilling shapes their positive freedom, their freedom-for. Platforms crucially influence the information people get about others and about the world, be it from friends, social actors, mass media, advertising corporations or beyond. The result is the emergence of new forms of knowing and influencing the actions of millions of people, a new techno-political power in the hands of States (such as NSA programs), corporations, or political actors (such as the Trump or the Brexit communication teams). This surveillance (Zuboff, 2015) and surwilling capitalism brings ever closer to a Big Brotherhood dystopia. + +*Towards technopolitical heteronomy? From mass self-communication to mass capture.* Social networks such as Facebook or Twitter have grown to user bases in the billions in only a decade. This has turned them into new intermediaries of social communication, if not of social life as such. Mass self-communication has risen hand in hand with mass capture, the capture of masses of data, human actions and interactions. These platforms feed from, and feed on, some dynamics already diagnosed by Guy Débord (1967) around the society of the spectacle, heralding a society of hypervisibility and exhibition tied to capitalism. Exhibition and self-exhibition (from the intimate everyday life to political opinions and actions, passed through a variety of fiction filters), are stimulated and situated at the center of the functioning of these platforms (Crogan & Kinsley, 2012; Goodwin et al., 2016), which are in turn at the center of an economy of attention. Furthermore, in social networks, surveillance and control is not only top-down but also bottom-bottom. There are two axes of surveillance, vertical and horizontal. While the first tends to be unidirectional, the second is frequently (though not always, as platform privacy settings are variable) horizontal and multidirectional: users can and do surveil each other, with playful or predatory (Albrechtslund, 2008; Tokunaga, 2011) purposes. The monopolistic concentration of power around social network corporations becomes daunting: Facebook, for instance, also owns Instagram and Whatsapp. Key rules of social relations are not produced in and decided by processes, actors or conflicts spread in space and time, but rather are increasingly decided and designed by a reduced number of people and specific interests (geostrategic, economic, etcetera). The power of social networks moves from selling advertisement (a concrete type of content) to a deeper shaping of social attention and affects (Grizzioti, 2016), and thereby, behavior. The social anomie resulting from several decades of neoliberalism had given way to a landscape in which the autonomy resulting from new forms of multitudinous self-organization in networked social movements was underlied and exposed to new forms of corporate influence via technologies, that is to say, technopolitical heteronomy. + +*How datacracy is dissolving democracy.* Democracy became exposed to datacracy, namely, to the strategic use of big data and digital platforms to gain and exercise political and cultural power (Cancellato, 2017; Gambetta, 2018). The rise of Barack Obama in 2008 and Donald Trump in 2016 to United States presidency are examples of how social networks and big data operations have a growing impact on electoral processes, affecting the networked public sphere. Trump invested 94 million dollars in expert consultants and Facebook’s paid advertising services (The Guardian, 2017). More importantly, the campaign included numerous examples of political automation: the use of chatbots, posting bots, false profiles and the automated inflation of metrics and followers (Bessi & Ferrara, 2016). These were frequently tied to the diffusion of _fake news_: biased, incomplete or spurious media stories with exaggerated and emotional adjectivation (Graves, 2018). This fed back with the activity in platforms such as 4chan, Omegle, Reddit and Tumblr, where Trump's followers formed an irregular community, self-appointed as _Alt-Right_ (Nagle, 2017a; 2017b), which showed clear manifestations of sexism, xenophobia, islamophobia, anti-feminism, intolerance and white supremacy, openly or in the form of satirical jokes and memes (Mendoza-Denton, 2018, Van-Zuylen Wood et al, 2018; Pollard, 2018). He may also has been supported by Russian espionage and communication experts, who received large financial incentives, showing the geopolitical character of these technopolitical struggles (The Guardian, 2018a). Finally, there was the hiring of London consulting company Cambridge Analytica, which extracted personal data from 87 million Facebook profiles between 2014 and 2016 to analyze their political preferences (De Llano, 2018), using a Facebook application disguised as a “personality test” (Cadwalladr, 2018; The Guardian, 2018b). This is not exceptional, though. Cambridge Analytica intervened in the last presidential campaigns of Argentina, Mexico, Brazil, Sri Lanka, Malaysia, China, Australia and South Africa, as well as the referendum that caused the separation of Britain from the European Union, known as _Brexit_ (The Guardian, 2018b). These cases have drawn public attention to issues such as the vulnerability of online personal data, the power of corporations and States that can access these databases (either legally or illegally) and use these platforms for influencing and shaping public discourse and action (Mottram, 2018; Tufekci, 2018). In words of Facebook's founder and president, Mark Zuckerberg, the platform has no affinity with any political party, and any client can access its services (Price, 2018). However, Facebook algorithms keep working as “black boxes”. Zuckerberg's company has never shared details of its technical operation or data processing software or policies besides the content of Facebook's terms of use, which still remain general, abstract, and non-negotiable. This opacity becomes ever more problematic as the role of platform algorithms, political automation and Artificial Intelligence (including machine and deep learning) systems grow (Trevathan, 2006; Manovich, 2013; Zysman & Kenney, 2015, 2016). Datacracy will pervade more aspects of people’s lives to the extent that the increasing pervasiveness of digital platforms grows and follows the current corporate and technocratic logics. + +*Free software, knowledge, culture, and internet.* However, in continuous struggle and contact with these dynamics there has also been a proliferation of actors, movements, practices and projects oriented by principles such as democracy, freedom, social justice, or commonality. For instance, as an alternative to commercial social networks, also in the second half of the 2000s, there emerged alternative social networks, from Diaspora (with more than one million users) to n-1, a platform widely used during the 15M movement, together with a self-managed network of blogs (wordpress), voice-call rooms (mumble) and collaborative real-time writing pads (etherpad). They followed in the steps of a tradition dating back, at least, to the 1980s and 1990s: the WWW and free software such as the GNU/Linux operating system, have provided free digital services (free as in “freedom” and not only as in “free beer”, as Richard Stallman put itfootnote:[The four basic freedoms are the freedom to run the program for any purpose; to access its source code, study how it works, and change it; to redistribute copies; to distribute copies of modified versions. They can be retrieved at https://www.gnu.org/philosophy/free-sw.en.html[https://www.gnu.org/philosophy/free-sw.en.html].]) to millions of people over world. Furthermore, the GNU license was a legal tool to produce and reproduce such free digital infrastructures. The Creative Commons license expanded its possibilities to cultural works. First, free software licenses and, later (as the principles and practices of free software spread to other fields, Kelty, 2008) creative commons licenses helped to outline an alternative paradigm of collective appropriation of informational and cognitive wealth. Projects such as Wikipedia brought the free software culture into knowledge. This neatly fitted with the discourse of scientific knowledge (Merton, 1942), traditionally self-proclaimed universalism, communalism, and disinterestedness, specially up to the 1980s and landmarks such as the Bay-Dohle Act, that put science into a path of closure, privatization, and corporate interestedness. By putting the classic Encyclopedia Britannica and Microsoft’s Encarta out of business Wikipedia became an example of and alternative “open knowledge” regime, from its production to its appropriation. Softer forms of this regime, such as “open access”, have gained solid ground in time. Under this alternative paradigm, platforms for digital collaboration became key in the collective production of information and knowledge out of the proprietary logics of informational and cognitive capitalism. The broad category of “digital commons” has served to encompass a variety free software, knowledge and culture products. More broadly, the term FLOK (Free/Libre Open Knowledge) includes also non-digital forms of knowledge that generate common practices and democratic communities out of the proprietary form: from education to hardware, from engineering to culture, from biology to software (Villa-Viñas & Barandiaran 2015). More recently, struggles around Net Neutrality (have brought to the front the centrality of the control of concrete aspects of a common such as the Internet (in this case, the discrimination a types of data traffic on the network by service providers and governments) for the flourishing of other basic rights such as freedom of speech or equality in the network societyfootnote:[Various reports and a history of the battle around Net Neutrality can be found at https://www.laquadrature.net/en/Net_neutrality[https://www.laquadrature.net/en/Net_neutrality].]. + +*Hacker culture, digital communities and knowledge commons*. Free/Libre and Open Knowledge does not stand simply as a commodity or a good that is accessible by means of legal and technical devices. It is followed and often preceded by certain forms of social relation, modes of production and the collaborative culture that is necessary to produce and sustain it. The hacker culture, often associated with an ethics of fun, openness and sharing (Himanen, 2003), is even so with concrete practices (Kelty, 2008) and forms of politics (Barandiaran 2003; Maxigas, 2012); crucially, it involves the attitude to transform the way in which artifacts (in its broader sense: from institutions to modems) are given to us in order to open them up to new possibilities: a practical believe on the capacity (both individual and collective) to challenge existing limits and to collaboratively explore how to break, re-assemble and build upon what is available. In doing so communities are created around technical challenges, common infrastructures, collective resources and struggles. In turn, these communities are faced with a myriad of governing problems and these are solved by a combination of recursive tools and democratic/collaborative procedures: from the mechanisms to solve disputes in Wikipedia, to the voting procedures of the Debian community, from Forks (the duplication of the content and resources of a project to create a new one, something that is made possible by the non-proprietary form of knowledge and technologies involved) to version control systems in software development. Added to the unlimited reproductive capacity of digital goods, all this provides the sphere of Free/Libre Open Knowledge with a productive power and collective management capacity that results on a knowledge commons that often parallels that of profit-driven corporations and has been the object of extensive study (Hess & Ostrom, 2007; Benkler, 2006). + +*Decidim in context.* As we have shown, democracies in the network society face the double challenge of the crisis of representative democracy and the rise of platform capitalism. The first phenomenon is tied to neoliberalism (and its periodic crises) as well as to the emergence of progressive and reactionary networked politics. The second phenomenon underlies new social conditions as well as those very forms of networked politics, while it is opposed by commons-oriented forms of production. The following image can help to understand the role of Decidim in this context. + +.Decidim model for a democratic society. +image::decidim-in-context.svg[Image, width=90%] + +Under platform capitalism, corporations extract social data in huge quantities and turn it into wealth and power over people and institutions (this is what, in the image below, we label “algorithmic governance”), challenging democracy as we know it. New forms of distributed platform capitalism (airbnb, uber, deliveroo, etc.) herald forms of capilar exploitation of social wealth. However, non-corporate, collaborative forms of digital production exist, and they make possible to find alternatives. Decidim is one such alternative. It is conceived as a commons’ digital infrastructure for participatory democracy that is publicly supported and democratically designed, using itself for such purpose. The value of Decidim stands out in a context in which democratic collective intelligence faces the challenge of corporate artificial intelligence and datacracy, where the democratic impulse of networked social movements, from alter-globalization to 15M, faces reactions by market, State and right wing forces, and where public and commons’ institutions require democratic innovative infrastructures to overtake market-driven innovation in solving the complex social challenges of our times. Whereas a dominant trend pushes the governing of infrastructures and services to the top-right of the picture, towards increasing privatization and centralization in the hands of big corporations, the socio-technical potential exists to shift this trend towards the bottom-left corner: towards decentralized and public-common’s ecosystems of services, infrastructures and goods. Decidim contributes to this transition by boosting democratic participation into the governing of public bodies, social organization, the cooperative economy as well as the joint circulation among the three. So far, public emphasis has been put into regulating consumer markets, corporate governance and economy as a means to slow down privatizing trends and its negative consequences; meanwhile, corporate interests keep exerting their lobbying influence into the public and state institutions. Instead, Decidim contributes to the strengthening of innovative forms of commons-oriented economy and participatory democracy. The next section deals with “how” this strengthening operates, explaining how Decidim explores the potential of participation at various scales. \ No newline at end of file From 7c1350603fb5e7352bb691e664426dff74894e73 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Mon, 30 Oct 2023 10:27:58 +0100 Subject: [PATCH 327/336] New translations answers.adoc (French) --- .../pages/components/proposals/answers.adoc | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/fr/modules/admin/pages/components/proposals/answers.adoc b/docs/fr/modules/admin/pages/components/proposals/answers.adoc index 78c5d6c9fa..8c32bfe0e3 100644 --- a/docs/fr/modules/admin/pages/components/proposals/answers.adoc +++ b/docs/fr/modules/admin/pages/components/proposals/answers.adoc @@ -1,32 +1,32 @@ -= Answers += Réponses -Proposals answers allow an administrator or valuator to review a proposal and give it an official response. +Les réponses aux propositions permettent à un administrateur ou à un évaluateur d'examiner une proposition et de lui donner une réponse officielle. -image:components/proposals/proposal_answer_state_accepted.png[Proposal answer state: Accepted] +image:components/propositions/proposal_answer_state_accepted.png[État de la réponse à la proposition : acceptée] -For answering a proposal: +Pour répondre à une proposition : -. Sign in as admin or valuator +. Se connecter en tant qu'administrateur ou évaluateur . Go to admin panel . Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. For instance, it could be "Processes", "Assemblies", or "Conferences" -. Click in the "Proposals" component -. Search the proposal you want to answer -. Click in the "Proposal answer" button image:action_answer.png[Answer proposal icon] +. Cliquer dans le composant "Propositions" +. Rechercher la proposition auquelle vous souhaitez répondre +. Cliquer sur le bouton "Répondre à la proposition" image:action_answer.png[Icône de réponse à la proposition] . Remplissez le formulaire -Alternatively, you could also: +Alternativement, vous pouvez aussi : -. Sign in as admin or valuator -. Navigate to the proposal you want to answer -. Click in the proposal answer button in the header image:components/proposals/answer_button_header.png[Answer proposal button] +. Se connecter en tant qu'administrateur ou évaluateur +. Rechercher la proposition auquelle vous souhaitez répondre +. Cliquez dans le bouton de réponse à la proposition dans l'en-tête image:components/propositions/answer_button_header.png[Bouton de réponse à la proposition] . Remplissez le formulaire -== Answer page +== Page de réponse -The answer page has three sections: +La page de réponse a trois sections : -=== Metadata +=== Métadonnées It has general information about the proposal, like the link, who is the author, the proposal body, how many supports, endorsements, comments, and so on. @@ -82,7 +82,7 @@ image:components/proposals/proposal_answer_state_evaluating.png[Proposal answer After proposals have been accepted, they can be imported to the xref:components/budgets.adoc[budgets] component. -image:components/proposals/proposal_answer_state_accepted.png[Proposal answer state: Accepted] +image:components/propositions/proposal_answer_state_accepted.png[État de la réponse à la proposition : acceptée] === Rejected @@ -96,12 +96,12 @@ For enabling automatic publication, you'll need to check it. On the other hand, if you want to control when to publish the answer a proposal or multiple proposals, you'll need to follow these steps: -. Sign in as admin or valuator +. Se connecter en tant qu'administrateur ou évaluateur . Go to admin panel . Dans la barre latérale principale, cliquez sur le bouton de l'espace dont vous voulez configurer la fonctionnalité. For instance, it could be "Processes", "Assemblies", or "Conferences" -. Click in the "Proposals" component -. Search the proposal you want to answer +. Cliquer dans le composant "Propositions" +. Rechercher la proposition auquelle vous souhaitez répondre . Click in the left checkbox of the proposal that you want to publish . Click on the "Actions" button . Click on the "Publish answers" option From fd76c6c0dc9e4f43dfb23557ac0e333956c0ef0b Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Mon, 30 Oct 2023 10:28:00 +0100 Subject: [PATCH 328/336] New translations conversations.adoc (French) --- docs/fr/modules/admin/pages/features/conversations.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/fr/modules/admin/pages/features/conversations.adoc b/docs/fr/modules/admin/pages/features/conversations.adoc index a30384c5e4..b76d9cee0f 100644 --- a/docs/fr/modules/admin/pages/features/conversations.adoc +++ b/docs/fr/modules/admin/pages/features/conversations.adoc @@ -16,7 +16,7 @@ image:features/conversations/profile.png[Participant profile] . Fill the form image:features/conversations/start_a_conversation_form.png[Start a conversation form] -Alternatively, you could also: +Alternativement, vous pouvez aussi : . Sign in as participant . Click on the conversation icon in the header image:icon_envelope_off.png[Conversations icon] From d82ac0b793b10d4a8f205d7ab451ee20e7258590 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Mon, 30 Oct 2023 10:28:01 +0100 Subject: [PATCH 329/336] New translations groups.adoc (French) --- docs/fr/modules/admin/pages/spaces/processes/groups.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/fr/modules/admin/pages/spaces/processes/groups.adoc b/docs/fr/modules/admin/pages/spaces/processes/groups.adoc index fa7c36a365..06a7be3cae 100644 --- a/docs/fr/modules/admin/pages/spaces/processes/groups.adoc +++ b/docs/fr/modules/admin/pages/spaces/processes/groups.adoc @@ -101,7 +101,7 @@ configure some fo these sections. image::processes_group_landing.png[Participatory process group landing page] * Title, description and hashtag -* Metadata +* Métadonnées * Image, text and Call to Action button. Configurable. * Proposals. You can configure how the elements will be sorted: by most recent or random. * Results. You can configure how the elements will be sorted: by most recent or random. From aa74660795e971a075107513fe9d07dd1d6dfcee Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Thu, 14 Dec 2023 13:59:27 +0100 Subject: [PATCH 330/336] New translations nav.adoc (French) --- docs/fr/modules/ROOT/nav.adoc | 70 +++++++++++++++++------------------ 1 file changed, 35 insertions(+), 35 deletions(-) diff --git a/docs/fr/modules/ROOT/nav.adoc b/docs/fr/modules/ROOT/nav.adoc index 61156a22b3..5a11791c72 100644 --- a/docs/fr/modules/ROOT/nav.adoc +++ b/docs/fr/modules/ROOT/nav.adoc @@ -2,10 +2,10 @@ ** xref:install:manual.adoc[Installation Manuelle] ** xref:install:checklist.adoc[Checklist] ** xref:install:update.adoc[Mise à jour] -* xref:configure:index.adoc[Configure] +* xref:configure:index.adoc[Configurer] ** xref:configure:environment_variables.adoc[Variables d'environnement] ** xref:configure:initializer.adoc[Initializer] -*** xref:customize:authorizations.adoc[Authorizations] +*** xref:customize:authorizations.adoc[Autorisations] *** xref:customize:code.adoc[Code] *** xref:customize:gemfile.adoc[Gemfile] *** xref:customize:images.adoc[Images] @@ -13,41 +13,41 @@ *** xref:customize:menu.adoc[Menu] *** xref:customize:oauth.adoc[OAuth] *** xref:customize:styles.adoc[Styles] -*** xref:customize:texts.adoc[Texts] -*** xref:customize:users_registration_mode.adoc[User registration mode] +*** xref:customize:texts.adoc[Textes] +*** xref:customize:users_registration_mode.adoc[Mode d'inscription des utilisateurs] *** xref:customize:views.adoc[Views] *** xref:services:activejob.adoc[Active Job] *** xref:services:elections_bulletin_board.adoc[Elections Bulletin Board] *** xref:services:etherpad.adoc[Etherpad] -*** xref:services:maps.adoc[Maps] +*** xref:services:maps.adoc[Cartographies] *** xref:services:smtp.adoc[SMTP] -*** xref:services:social_providers.adoc[Social Providers] -* Admin +*** xref:services:social_providers.adoc[Fournisseurs d'identité sociaux] +* Administration ** xref:admin:index.adoc[Introduction] -*** xref:admin:system.adoc[System panel] -*** xref:admin:dashboard.adoc[Dashboard] -** Settings +*** xref:admin:system.adoc[Panneau d'administration système] +*** xref:admin:dashboard.adoc[Tableau de bord] +** Paramètres *** xref:admin:configuration.adoc[Configuration] -*** xref:admin:appearance.adoc[Appearance] -*** xref:admin:homepage.adoc[Homepage] -*** xref:admin:scopes.adoc[Scopes] -*** xref:admin:areas.adoc[Areas] -*** xref:admin:help_sections.adoc[Help sections] +*** xref:admin:appearance.adoc[Apparence] +*** xref:admin:homepage.adoc[Page d'accueil] +*** xref:admin:scopes.adoc[Secteurs] +*** xref:admin:areas.adoc[Périmètres d'assemblée] +*** xref:admin:help_sections.adoc[Sections d'aide] ** xref:admin:pages.adoc[Pages] -** xref:admin:participants.adoc[Participants] -*** xref:admin:participants/admins.adoc[Admins] -*** xref:admin:participants/groups.adoc[Groups] +** xref:admin:participants.adoc[Utilisateurs] +*** xref:admin:participants/admins.adoc[Administrateurs] +*** xref:admin:participants/groups.adoc[Groupes d'utilisateurs] *** xref:admin:participants/participants.adoc[Participants] -*** xref:admin:participants/impersonations.adoc[Impersonations] -**** xref:admin:participants/verifications_conflicts.adoc[Verifications conflicts] -*** xref:admin:participants/reported_users.adoc[Reported users] -*** xref:admin:participants/authorizations.adoc[Authorizations] -**** xref:admin:participants/authorizations/identity_documents.adoc[Identity documents] -**** xref:admin:participants/authorizations/code_postal_letter.adoc[Code by postal letter] -**** xref:admin:participants/authorizations/census.adoc[Organization's census] -** xref:admin:spaces.adoc[Spaces] +*** xref:admin:participants/impersonations.adoc[Utilisateurs représentés] +**** xref:admin:participants/verifications_conflicts.adoc[Conflits de vérification] +*** xref:admin:participants/reported_users.adoc[Utilisateurs signalés] +*** xref:admin:participants/authorizations.adoc[Autorisations] +**** xref:admin:participants/authorizations/identity_documents.adoc[Documents d'identité] +**** xref:admin:participants/authorizations/code_postal_letter.adoc[Code par lettre postale] +**** xref:admin:participants/authorizations/census.adoc[Recensement de l'organisation] +** xref:admin:spaces.adoc[Espaces] *** xref:admin:spaces/processes.adoc[Concertations] -**** xref:admin:spaces/processes/phases.adoc[Phases] +**** xref:admin:spaces/processes/phases.adoc[Étapes] **** xref:admin:spaces/processes/components.adoc[Components] **** xref:admin:spaces/processes/categories.adoc[Categories] **** xref:admin:spaces/processes/attachments.adoc[Attachments] @@ -96,12 +96,12 @@ **** xref:admin:components/proposals/answers.adoc[Answers] **** xref:admin:components/proposals/collaborative_drafts.adoc[Collaborative drafts] **** xref:admin:components/proposals/participatory_texts.adoc[Participatory texts] -*** xref:admin:components/surveys.adoc[Surveys] -** Features +*** xref:admin:components/surveys.adoc[Enquêtes] +** Fonctionnalités *** xref:admin:features/badges.adoc[Badges] -*** xref:admin:features/comments.adoc[Comments] +*** xref:admin:features/comments.adoc[Commentaires] *** xref:admin:features/conversations.adoc[Conversations] -*** xref:admin:features/embed.adoc[Embed] +*** xref:admin:features/embed.adoc[Intégration] *** xref:admin:features/endorsements.adoc[Endorsements] *** xref:admin:features/fingerprint.adoc[Fingerprint] *** xref:admin:features/follows.adoc[Follows] @@ -193,7 +193,7 @@ *** xref:publications:french.adoc[French] *** xref:publications:german.adoc[German] *** xref:publications:italian.adoc[Italian] -*** xref:publications:spanish.adoc[Spanish] -** Whitepaper -*** xref:whitepaper:decidim-a-brief-overview.adoc[Decidim: a brief overview] -* xref:releases:index.adoc[Release Notes] \ No newline at end of file +*** xref:publications:spanish.adoc[Espagnol] +** Livre blanc +*** xref:whitepaper:decidim-a-brief-overview.adoc[Decidim : un bref aperçu] +* xref:releases:index.adoc[Notes de version] \ No newline at end of file From 4b679480c65e31b472ff8592c3d23ec082f1714a Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Thu, 14 Dec 2023 13:59:29 +0100 Subject: [PATCH 331/336] New translations index.adoc (French) --- docs/fr/modules/ROOT/pages/index.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/fr/modules/ROOT/pages/index.adoc b/docs/fr/modules/ROOT/pages/index.adoc index 4e1fee14be..0e320072eb 100644 --- a/docs/fr/modules/ROOT/pages/index.adoc +++ b/docs/fr/modules/ROOT/pages/index.adoc @@ -1,6 +1,6 @@ -= Welcome to Decidim Documentation += Bienvenue dans la documentation de Decidim -This is the documentation site to Decidim, a participatory democracy platform created initially by Barcelona City Hall. +Ceci est le site de documentation de Decidim, une plate-forme de démocratie participative créée initialement par la mairie de Barcelone. Decidim is a framework that allows anybody to create and configure a website platform, to be used in the form of a political network for democratic participation. The platform allows any organization (local city council, association, university, NGO, neighbourhood or cooperative) to create mass processes for strategic planning, participatory budgeting, collaborative design for regulations, urban spaces and election processes. From b2166d6a3b003ea9501b7fee417def1c4cabbce5 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Thu, 14 Dec 2023 13:59:30 +0100 Subject: [PATCH 332/336] New translations participants.adoc (French) --- docs/fr/modules/admin/pages/participants.adoc | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/fr/modules/admin/pages/participants.adoc b/docs/fr/modules/admin/pages/participants.adoc index a7efde5673..a355128f7b 100644 --- a/docs/fr/modules/admin/pages/participants.adoc +++ b/docs/fr/modules/admin/pages/participants.adoc @@ -17,13 +17,13 @@ Once you're in you can see all the different kind of participants and actions th image:participants_sidebar_menu.png[Participants sidebar menu] -* xref:admin:participants/admins.adoc[Admins] -* xref:admin:participants/groups.adoc[Groups] +* xref:admin:participants/admins.adoc[Administrateurs] +* xref:admin:participants/groups.adoc[Groupes d'utilisateurs] * xref:admin:participants/participants.adoc[Participants] -* xref:admin:participants/impersonations.adoc[Impersonations] -** xref:admin:participants/verifications_conflicts.adoc[Verifications conflicts] -* xref:admin:participants/reported_users.adoc[Reported users] -* xref:admin:participants/authorizations.adoc[Authorizations] -** xref:admin:participants/authorizations/identity_documents.adoc[Identity documents] -** xref:admin:participants/authorizations/code_postal_letter.adoc[Code by postal letter] -** xref:admin:participants/authorizations/census.adoc[Organization's census] \ No newline at end of file +* xref:admin:participants/impersonations.adoc[Utilisateurs représentés] +** xref:admin:participants/verifications_conflicts.adoc[Conflits de vérification] +* xref:admin:participants/reported_users.adoc[Utilisateurs signalés] +* xref:admin:participants/authorizations.adoc[Autorisations] +** xref:admin:participants/authorizations/identity_documents.adoc[Documents d'identité] +** xref:admin:participants/authorizations/code_postal_letter.adoc[Code par lettre postale] +** xref:admin:participants/authorizations/census.adoc[Recensement de l'organisation] \ No newline at end of file From fdec4e8361a1cca8fc303595f12105e7098b9415 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Thu, 14 Dec 2023 13:59:31 +0100 Subject: [PATCH 333/336] New translations authorizations.adoc (French) --- .../fr/modules/admin/pages/participants/authorizations.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/fr/modules/admin/pages/participants/authorizations.adoc b/docs/fr/modules/admin/pages/participants/authorizations.adoc index 3937fffc92..26ba2db019 100644 --- a/docs/fr/modules/admin/pages/participants/authorizations.adoc +++ b/docs/fr/modules/admin/pages/participants/authorizations.adoc @@ -32,9 +32,9 @@ Another possiblity is to revoke only the xref:admin:participants/impersonations. Some of the available authorizations by default are: -* xref:admin:participants/authorizations/identity_documents.adoc[Identity documents] -* xref:admin:participants/authorizations/code_postal_letter.adoc[Code by postal letter] -* xref:admin:participants/authorizations/census.adoc[Organization's census] +* xref:admin:participants/authorizations/identity_documents.adoc[Documents d'identité] +* xref:admin:participants/authorizations/code_postal_letter.adoc[Code par lettre postale] +* xref:admin:participants/authorizations/census.adoc[Recensement de l'organisation] If any of these authorizations are not useful for your needs, talk with your implementer to see other alternatives. Learn more about xref:customize:authorizations.adoc[Authorizations in the Customize Guide section]. \ No newline at end of file From 8c70067da0ff36c3eb7e3d94de7648e461656172 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Thu, 14 Dec 2023 13:59:32 +0100 Subject: [PATCH 334/336] New translations scopes.adoc (French) --- docs/fr/modules/admin/pages/scopes.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/fr/modules/admin/pages/scopes.adoc b/docs/fr/modules/admin/pages/scopes.adoc index 84e6e4ffb1..b30dfdad73 100644 --- a/docs/fr/modules/admin/pages/scopes.adoc +++ b/docs/fr/modules/admin/pages/scopes.adoc @@ -70,7 +70,7 @@ You have 3 possible actions in this list after a Scope is created: |To delete this scope. |=== -== Features +== Fonctionnalités The main features related with scopes are: From 93838201f4f98fdbd26b6a95c91e7475044b19ab Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Thu, 14 Dec 2023 13:59:34 +0100 Subject: [PATCH 335/336] New translations assemblies.adoc (French) --- docs/fr/modules/admin/pages/spaces/assemblies.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/fr/modules/admin/pages/spaces/assemblies.adoc b/docs/fr/modules/admin/pages/spaces/assemblies.adoc index 5509087f22..1252ceb0f5 100644 --- a/docs/fr/modules/admin/pages/spaces/assemblies.adoc +++ b/docs/fr/modules/admin/pages/spaces/assemblies.adoc @@ -283,7 +283,7 @@ image:assemblies_new_type_form.png[New assembly type form] |Title of the this assembly type. For instance, "Consultative". |=== -== Settings +== Paramètres At the moment there's only a setting for configuring the general behaviour of assemblies. From e9fe7c1ca77ee606833f58bffcc8af3b8a5fd6e7 Mon Sep 17 00:00:00 2001 From: decidim-bot Date: Thu, 14 Dec 2023 13:59:35 +0100 Subject: [PATCH 336/336] New translations processes.adoc (French) --- docs/fr/modules/admin/pages/spaces/processes.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/fr/modules/admin/pages/spaces/processes.adoc b/docs/fr/modules/admin/pages/spaces/processes.adoc index 08ca95d1ce..6d29125193 100644 --- a/docs/fr/modules/admin/pages/spaces/processes.adoc +++ b/docs/fr/modules/admin/pages/spaces/processes.adoc @@ -233,7 +233,7 @@ image::process_submenu.png[Process submenu in admin] Here you can keep configuring your process: . Info: the same form that we explained in this page. -. xref:admin:spaces/processes/phases.adoc[Phases] +. xref:admin:spaces/processes/phases.adoc[Étapes] . xref:admin:spaces/processes/components.adoc[Components] . xref:admin:spaces/processes/categories.adoc[Categories] . xref:admin:spaces/processes/attachments.adoc[Attachments]