diff --git a/docs/ca/modules/ROOT/pages/index.adoc b/docs/ca/modules/ROOT/pages/index.adoc index 5310bbf5ca..afb92814ed 100644 --- a/docs/ca/modules/ROOT/pages/index.adoc +++ b/docs/ca/modules/ROOT/pages/index.adoc @@ -10,7 +10,7 @@ You’ve found the documentation for Decidim. Learn about the project at https:/ [NOTE] ==== -This is the documentation for the `0.27` version. You can see this same documentation site for other versions: xref:v0.26@ROOT:index.adoc[v0.26] and xref:develop@ROOT:index.adoc[develop] +This is the documentation for the `0.27` version. You can see this same documentation site for other versions: xref:v0.28@ROOT:index.adoc[v0.28] and xref:develop@ROOT:index.adoc[develop] ==== // * Read the xref:ROOT:getting-started.adoc[Getting Started guide] diff --git a/docs/ca/modules/releases/pages/index.adoc b/docs/ca/modules/releases/pages/index.adoc index c9f9bc7423..28dc06637b 100644 --- a/docs/ca/modules/releases/pages/index.adoc +++ b/docs/ca/modules/releases/pages/index.adoc @@ -6,6 +6,9 @@ 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/2023-12-20-new-version-0-28-0/[Version 0.28 (2022-12-20)] +* 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] diff --git a/docs/de/modules/ROOT/nav.adoc b/docs/de/modules/ROOT/nav.adoc new file mode 100644 index 0000000000..bf34c18073 --- /dev/null +++ b/docs/de/modules/ROOT/nav.adoc @@ -0,0 +1,202 @@ +* 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:index.adoc[Customize] +*** 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:index.adoc[Services] +*** 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:reminders.adoc[Reminders] +*** 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 diff --git a/docs/de/modules/ROOT/pages/index.adoc b/docs/de/modules/ROOT/pages/index.adoc new file mode 100644 index 0000000000..5f260dd9da --- /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.27` version. You can see this same documentation site for other versions: xref:v0.28@ROOT:index.adoc[v0.28] 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 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 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 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 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 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..4afe69f771 --- /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 impementation. \ No newline at end of file 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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..f84d38f888 --- /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 her 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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..7abb57a326 --- /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? See xref:services:sms.adoc[configuration of SMS service]. +|=== + +=== 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 diff --git a/docs/de/modules/releases/pages/index.adoc b/docs/de/modules/releases/pages/index.adoc new file mode 100644 index 0000000000..28dc06637b --- /dev/null +++ b/docs/de/modules/releases/pages/index.adoc @@ -0,0 +1,35 @@ += 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/2023-12-20-new-version-0-28-0/[Version 0.28 (2022-12-20)] +* 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 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 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 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 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 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 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 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 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 diff --git a/docs/es/modules/ROOT/pages/index.adoc b/docs/es/modules/ROOT/pages/index.adoc index 5310bbf5ca..afb92814ed 100644 --- a/docs/es/modules/ROOT/pages/index.adoc +++ b/docs/es/modules/ROOT/pages/index.adoc @@ -10,7 +10,7 @@ You’ve found the documentation for Decidim. Learn about the project at https:/ [NOTE] ==== -This is the documentation for the `0.27` version. You can see this same documentation site for other versions: xref:v0.26@ROOT:index.adoc[v0.26] and xref:develop@ROOT:index.adoc[develop] +This is the documentation for the `0.27` version. You can see this same documentation site for other versions: xref:v0.28@ROOT:index.adoc[v0.28] and xref:develop@ROOT:index.adoc[develop] ==== // * Read the xref:ROOT:getting-started.adoc[Getting Started guide] diff --git a/docs/es/modules/releases/pages/index.adoc b/docs/es/modules/releases/pages/index.adoc index c9f9bc7423..28dc06637b 100644 --- a/docs/es/modules/releases/pages/index.adoc +++ b/docs/es/modules/releases/pages/index.adoc @@ -6,6 +6,9 @@ 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/2023-12-20-new-version-0-28-0/[Version 0.28 (2022-12-20)] +* 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] diff --git a/docs/fr/modules/ROOT/nav.adoc b/docs/fr/modules/ROOT/nav.adoc new file mode 100644 index 0000000000..ff1053eb3d --- /dev/null +++ b/docs/fr/modules/ROOT/nav.adoc @@ -0,0 +1,202 @@ +* xref:install:index.adoc[Pour commencer] +** xref:install:manual.adoc[Installation Manuelle] +** xref:install:checklist.adoc[Checklist] +** xref:install:update.adoc[Mise à jour] +* xref:configure:index.adoc[Configurer] +** xref:configure:environment_variables.adoc[Variables d'environnement] +** xref:configure:initializer.adoc[Initializer] +** xref:customize:index.adoc[Customiser] +*** xref:customize:authorizations.adoc[Autorisations] +*** 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[Textes] +*** xref:customize:users_registration_mode.adoc[Mode d'inscription des utilisateurs] +*** xref:customize:views.adoc[Views] +** xref:services:index.adoc[Services] +*** xref:services:activejob.adoc[Active Job] +*** xref:services:elections_bulletin_board.adoc[Elections Bulletin Board] +*** xref:services:etherpad.adoc[Etherpad] +*** xref:services:maps.adoc[Cartographies] +*** xref:services:smtp.adoc[SMTP] +*** xref:services:social_providers.adoc[Fournisseurs d'identité sociaux] +* Administration +** xref:admin:index.adoc[Introduction] +*** 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[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[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[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[Étapes] +**** 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[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] +**** 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[Enquêtes] +** Fonctionnalités +*** xref:admin:features/badges.adoc[Badges] +*** xref:admin:features/comments.adoc[Commentaires] +*** xref:admin:features/conversations.adoc[Conversations] +*** 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] +*** 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:reminders.adoc[Reminders] +*** 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] +*** 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)] +* Comprendre +** 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[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 diff --git a/docs/fr/modules/ROOT/pages/index.adoc b/docs/fr/modules/ROOT/pages/index.adoc new file mode 100644 index 0000000000..42bf3df1b2 --- /dev/null +++ b/docs/fr/modules/ROOT/pages/index.adoc @@ -0,0 +1,24 @@ += Bienvenue dans la documentation de Decidim + +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. + +== 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.27` version. You can see this same documentation site for other versions: xref:v0.28@ROOT:index.adoc[v0.28] 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 diff --git a/docs/fr/modules/admin/pages/appearance.adoc b/docs/fr/modules/admin/pages/appearance.adoc new file mode 100644 index 0000000000..e352d5fb5e --- /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. Il n'y a as de demande de modifications (PR) pour l'instant. + +* **Bannière de contenu mis en valeur** +** *Show the highlighted content banner* +** *Title* +** *Brève description* +** *Titre du bouton d'action* +** *Sous-titre du bouton d'action* +** *URL du bouton d'action* +** *Image* + +--- + +* *Modifier la bannière permanente* +** **Activer la bannière permanente** +** **Titre** +** **Brève description** +** **URL** + +--- + +* **Modifier l’aspect de la mise en page** + +Cette sous-section définit les images de mise en page qui seront visibles dans presque toutes les pages. Il s'agit de : + +** Icône +** Logo +** Logo officiel - barre de navigation +** Logo officiel - pied de page +** Url officielle de l'organisation + +// TODO: Add examples + +--- + +* **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**: 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 diff --git a/docs/fr/modules/admin/pages/areas.adoc b/docs/fr/modules/admin/pages/areas.adoc new file mode 100644 index 0000000000..1099cee464 --- /dev/null +++ b/docs/fr/modules/admin/pages/areas.adoc @@ -0,0 +1,11 @@ += Périmètres d'assemblée + +include::partial$deprecated.adoc[] + +Les périmètres d'assemblée sont tous les périmètres qu'une organisation peut avoir. + +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. + +Nous ne recommandons pas de les utiliser, car dans le futur elles seront probablement supprimées. + +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 diff --git a/docs/fr/modules/admin/pages/components.adoc b/docs/fr/modules/admin/pages/components.adoc new file mode 100644 index 0000000000..35f9f16229 --- /dev/null +++ b/docs/fr/modules/admin/pages/components.adoc @@ -0,0 +1,5 @@ += Fonctionnalités + +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 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..13a8855a7b --- /dev/null +++ b/docs/fr/modules/admin/pages/components/blog.adoc @@ -0,0 +1,145 @@ += Actualités + +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 +. 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é] + +== Ajouter une fonctionnalité + +image:components/debates/component.png[Formulaire d'ajout de fonctionnalité] + + +.Ajouter une fonctionnalité : Formulaire d'Actualités +|=== +|Champ |Type |Description + +|Nom +|Obligatoire +|Quel est le titre de cette fonctionnalité. Par exemple, "Actualités" + +|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 +|=== +|Champ |Type |Description + +|Annonce +|Facultatif +|Une annonce générale qui sera visible sur la page générale des actualités. + +|Commentaires activés +|Facultatif +|Si vous voulez avoir des commentaires dans les rencontres. + +|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 +xref:admin:spaces/processes.adoc[Participatory Processes], then you can also define different behaviors per Step. + + +.Add component: Blogs form - Step settings +|=== +|Champ |Type |Description + +|Annonce +|Facultatif +|Une annonce générale qui sera visible sur la page générale des actualités. + +|Commentaires désactivés +|Facultatif +|Si vous voulez activer la création de commentaires pour cette étape. + +|Soutiens activés +|Facultatif +|Si vous voulez activer les soutiens pour cette étape. + +|Soutiens bloqués +|Facultatif +|Whether you want to disable adding new endorsements for this phase. +|=== + +== 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: + +* Commenter +* Soutenir + +== Manage posts + +image:components/blog/manage_posts.png[Manage posts table] + +=== Formulaire de création d'article d'actualités + +image:components/blog/new_post.png[New post form] + + +.Formulaire de création d'article d'actualités +|=== +|Champ |Type |Description + +|Créer un article en tant que +|Obligatoire +|Participant account or user group that will be the author of the post. + +|Titre +|Obligatoire +|Quel est le titre de cet article. + +|Body +|Obligatoire +|What is the description of this post. +|=== + +==== Actions + + +.Actions +|=== +|Icône |Nom |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] +|Autorisations +|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 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..f68f93af7b --- /dev/null +++ b/docs/fr/modules/admin/pages/components/budgets.adoc @@ -0,0 +1,355 @@ += 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 +. 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" +. Remplissez le formulaire xref:_add_component[Ajouter une fonctionnalité] + +== Ajouter une fonctionnalité + +image:components/budgets/component.png[Add component form] + + +.Add component: Budgets form +|=== +|Champ |Type |Description + +|Nom +|Obligatoire +|Quel est le titre de cette fonctionnalité. For instance, "Budgets" + +|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 +|=== +|Champ |Type |Description + +|Scopes enabled +|Facultatif +|Check if you want to have Scopes filtering in this component. + +|Secteur +|Facultatif +|Which xref:admin:scopes.adoc[Scope] does this component belongs to. + +|Portée générale +|Facultatif +| + +|xref:_workflows[Workflow] +|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. + +|Projets par page +|Obligatoire +|Combien de projets sont affichés par page. + +|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. + +|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. + +|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. + +|Commentaires activés +|Facultatif +|Si vous voulez avoir des commentaires dans les rencontres. + +|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 +|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. + +|Annonce +|Facultatif +|A general announcement that'll be visible on the general budgets landing page. + +|Budgets landing page +|Facultatif +|What message will be shown in the Budgets landing page when there are multiple budgets. + +|More information modal +|Facultatif +|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 +|=== +|Champ |Type |Description + +|Commentaires désactivés +|Facultatif +|Whether you want to enable comments for this phase. + +|Voting +|Obligatoire +|Choose one of the following options depending in the moment of the process: Voting disabled, Voting enabled or Voting finished. + +|Show votes +|Facultatif +|Wheter the votes will be shown. We strongly recommend that you only check this option after the voting is finished. + +|Annonce +|Facultatif +|A general announcement that'll be visible on the general budgets landing page. + +|Budgets landing page +|Facultatif +|What message will be shown in the Budgets landing page when there are multiple budgets. + +|More information modal +|Facultatif +|What message will be shown when clicking on the "More information" link. +|=== + +== Autorisations + +Edit permissions + +* Vote +* Commenter + +== 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 +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|What is the title of this budget. For instance, "District A" + +|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 +|Facultatif +|What is the description of this budget. + +|Total budget +|Obligatoire +|What is the total amount of money that people will have for assigning. +|=== + +==== Actions + + +.Actions +|=== +|Icône |Nom |Definition + +|image:action_preview.png[Preview icon] +|Preview +|Pour voir comment il est montré dans le frontend aux participants. + +|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 +|Modifier un budget. C'est le même formulaire que "Nouveau budget". + +|image:action_delete.png[Delete icon] +|Delete +|Pour supprimer le budget. Peut être fait unquement quand il n'y a pas de projets dans ce budget. +|=== + +==== Gérer les projets + +===== Importer des propositions dans des projets + +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. + +Pour que cela fonctionne : + +. 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[Importer des propositions dans les projets] + +===== Export all + +Allows to export the projects for this budget in different formats. + +* Projects as CSV +* Projects as JSON +* Projects as Excel + +===== Formulaire de création d'un projet + +image:components/budgets/new_project.png[Nouveau formulaire de projet pour un budget] + + +.Formulaire de création d'un projet +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|Le titre pour ce projet. + +|Description +|Obligatoire +|Une description de l'objet de ce projet. + +|Montant du budget +|Obligatoire +|Le montant du budget pour ce projet. Combien coûte la mise en œuvre de ce projet ? + +|Catégorie +|Facultatif +|La catégorie du projet. Utilisé pour les filtres dans la liste des projets. + +|Propositions +|Facultatif +|Choisissez des propositions liées à ce projet. Auto-assignation lors de l'importation des propositions. + +|Ajouter une galerie d'images +|Facultatif +|Ajoutez plusieurs images illustrant en quoi consiste ce projet, ou où il sera implémenté. +|=== + +===== Actions + + +.Actions +|=== +|Icône |Nom |Definition + +|image:action_preview.png[Preview icon] +|Preview +|Pour voir comment il est montré dans le frontend aux participants. + +|image:action_edit.png[Edit icon] +|Edit +|Modifier un projet. C'est le même formulaire que "Nouveau projet". + +|image:action_folder.png[Icône des dossiers] +|Dossiers +|For classifying Attachments. + +|image:action_attachments.png[Attachments icon] +|Attachments +|Documents liés au projet. + +|image:action_delete.png[Delete icon] +|Delete +|Pour supprimer le projet. +|=== + +== 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 impementation. \ No newline at end of file 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..b1df1fed93 --- /dev/null +++ b/docs/fr/modules/admin/pages/components/debates.adoc @@ -0,0 +1,229 @@ += Débat + +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: + +* 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/[Proposer de nouvelles fonctionnalités pour le logiciel Decidim dans Metadecidim] + +image:components/debates/example01.png[Exemple de liste des débats] +image:components/debates/example02.png[Exemple de débat] + +Pour configurer le fonctionnalité Débat: + +. Sign in as admin +. Go to admin panel +. 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é] + +== Ajouter une fonctionnalité + +image:components/debates/component.png[Ajouter un formulaire de composant] + + +.Ajouter un composant : Formulaire de débat +|=== +|Champ |Type |Description + +|Nom +|Obligatoire +|Quel est le titre de cette fonctionnalité. Par exemple, "Debates" + +|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. +|=== + + +.Ajouter une fonctionnalité : Formulaire de débat - Paramètres globaux +|=== +|Champ |Type |Description + +|Scopes enabled +|Facultatif +|Check if you want to have Scopes filtering in this component. + +|Secteur +|Facultatif +|Which xref:admin:scopes.adoc[Scope] does this component belongs to. + +|Portée générale +|Facultatif +| + +|Commentaires activés +|Facultatif +|Si vous voulez avoir des commentaires dans les rencontres. + +|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. + +|Annonce +|Facultatif +|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 +|=== +|Champ |Type |Description + +|Soutiens activés +|Facultatif +|Check if you want that participants show public support for these debates. + +|Soutiens bloqués +|Facultatif +| + +|Debate creation by participants enabled +|Facultatif +|Check if you want to allow the creation of new debates by participants. + +|Commentaires désactivés +|Facultatif +|Whether you want to enable comments for this phase. + +|Annonce +|Facultatif +|A general announcement that'll be visible on the general debate landing page. +|=== + +== 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 +* Soutenir + +== 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 +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|What is the title of this debate. For instance, "How can we improve this process?" + +|Description +|Obligatoire +|What is the description of this debate. + +|Instructions to participate +|Obligatoire +|Add a message for the participants. + +|Information updates +|Facultatif +|Add a message for the participants. + +|xref:_debate_types[Debate type] +|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. + +|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 + +|Catégorie +|Facultatif +|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 +|=== +|Icône |Nom |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] +|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. Peut être fait unquement quand il n'y a pas de projets dans ce budget. +|=== + +=== 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 +|=== +|Champ |Type |Description + +|Conclusions +|Obligatoire +|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 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 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..6b316405a1 --- /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 +. 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" +. Aller dans les fonctionnalités +. Cliquez sur le bouton "Ajouter une fonctionnalité" +. Click on "Meetings" +. Remplissez le formulaire xref:_add_component[Ajouter une fonctionnalité] + +== Ajouter une fonctionnalité + +For configuring the meeting component you have these settings: + + +.Add component - Meetings form +|=== +|Champ |Type |Description + +|Nom +|Obligatoire +|What is the name of this component. + +|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 +|=== +|Champ |Type |Description + +|Scopes enabled +|Facultatif +|Check if you want to have Scopes filtering in this process. + +|Secteur +|Facultatif +|Which scope will be used for this component. + +|Annonce +|Facultatif +|A general announcement that'll be visible in the general meetings list. + +|Default registration terms +|Facultatif +|What'll be the registration terms of service that the participant would need to accept when registering. + +|Commentaires activés +|Facultatif +|Si vous voulez avoir des commentaires dans les rencontres. + +|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 +|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 +|Facultatif +|If you want more granular permissions inside of every one of the Meetings. + +|Enable pads creation +|Facultatif +|If you want an Etherpad embedded in your meetings. Must have the xref:services:etherpad.adoc[Etherpad] integration configurated. + +|Participants can create meetings +|Facultatif +|Allows participants to create new meetings. See xref:_citizens_meetings[Citizens meetings] + +|Maps enabled +|Facultatif +|Wheter you want to show a map in the meetings in the meeting detail. +|=== + + +.Add component - Meetings form: Step settings +|=== +|Champ |Type |Description + +|Annonce +|Facultatif +|A general announcement that'll be visible in the general meetings list. + +|Commentaires activés +|Facultatif +|Si vous voulez avoir des commentaires dans les rencontres. +|=== + +== 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 +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|What is the title for this meeting. + +|Description +|Obligatoire +|A description of what will be discussed in this meeting, like the topics. + +|Type +|Obligatoire +|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 +|Obligatoire +|Location: message directed to the users implying the spot to meet at + +|Location hints +|Facultatif +|Location hints: additional info. Example: the floor of the building + +|Online meeting URL +|Facultatif +|Which URL will the meeting be held. + +|Show embedded iframe for this URL +|Facultatif +|Whether or not embed the iframe for this videoconference URL. Only a few services allow embedding (i.e. YouTube, Twitch...) + +|Start Time +|Obligatoire +|Which day and time will the meeting start. Expected format: dd/mm/yyyy hh:ii + +|End Time +|Obligatoire +|Which day and time will the meeting start. Expected format: dd/mm/yyyy hh:ii + +|Catégorie +|Facultatif +|Which Category has the meeting. Used for filtering in the meetings list. + +|Registration type +|Obligatoire +|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 +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|What is the title for this meeting. + +|Description +|Obligatoire +|A description of what will be discussed in this meeting, like the topics. + +|Type +|Obligatoire +|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 +|Obligatoire +|Location: message directed to the users implying the spot to meet at + +|Location hints +|Facultatif +|Location hints: additional info. Example: the floor of the building + +|Online meeting URL +|Facultatif +|Which URL will the meeting be held. + +|Show embedded iframe for this URL +|Facultatif +|Whether or not embed the iframe for this videoconference URL. Only a few services allow embedding (i.e. YouTube, Twitch...) + +|Start Time +|Obligatoire +|Which day and time will the meeting start. Expected format: dd/mm/yyyy hh:ii + +|End Time +|Obligatoire +|Which day and time will the meeting start. Expected format: dd/mm/yyyy hh:ii + +|Catégorie +|Facultatif +|Which Category has the meeting. Used for filtering in the meetings list. + +|Registration type +|Obligatoire +|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 +|Facultatif +|Check if the meeting shouldn't be visible for all the visitors. Specific to "Official meetings". + +|Transparent +|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 +|Facultatif +|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 +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|Title of the service. + +|Description +|Facultatif +|Description of the service. +|=== + +== Actions + +=== Citizens meetings + + +.Actions - Citizens meetings +|=== +|Icône |Nom |Definition + +|image:action_preview.png[Preview icon] +|Preview +|Pour voir comment il est montré dans le frontend aux participants. + +|image:action_permissions.png[Permissions icon] +|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. +|=== + +=== Official meetings + + +.Actions - Official meetings +|=== +|Icône |Nom |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 +|Pour voir comment il est montré dans le frontend aux 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[Icône des dossiers] +|Dossiers +|For classifying Attachments. + +|image:action_attachments.png[Attachments icon] +|Attachments +|Documents that are related to the meeting. + +|image:action_permissions.png[Permissions icon] +|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. + +|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 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..75b77c8a46 --- /dev/null +++ b/docs/fr/modules/admin/pages/components/meetings/agenda.adoc @@ -0,0 +1,88 @@ += Ordre du jour + +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[Image de la fonctionnalité ordre du jour] + +== Formulaire de création d'ordre du jour + +Définir l'ordre du jour d'une rencontre : + +. Sign in as admin +. 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 on "Meetings" +. 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[Formulaire de création d'ordre du jour dans le backoffice] + + +.Formulaire de création d'ordre du jour +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|Titre de l'ordre du jour. Par exemple, "Calendrier" + +|Visible +|Facultatif +|Cochez cette case si vous souhaitez publier l'ordre du jour. + +|Points de l'ordre du jour +|Obligatoire +|Liste des points de l'ordre du jour. +|=== + +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. + + +.Formulaire d'élément de l'ordre du jour +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|Titre du point de l'ordre du jour + +|Durée +|Obligatoire +|Combien de minutes durera le point de l'ordre du jour. Par exemple, "15". + +|Description +|Facultatif +|Titre du point de l'ordre du jour + +|Sous-points de l’ordre du jour +|Facultatif +|Liste des sous-points de l'ordre du jour. +|=== + +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. + +À titre d'exemple, cet ordre du jour : + +image:components/meetings/agenda/agenda_frontend.png[Image de la fonctionnalité ordre du jour] + +Pour la configuration suivante : + +* Titre: "Calendrier" +* Visible: true +* 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 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..bb6cd6fb8e --- /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 +. 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] +. Remplissez le formulaire + +image:components/meetings/close/form_backend.png[Close meeting form in the backend] + + +.Close meeting form (backend) +|=== +|Champ |Type |Description + +|Minutes +|Obligatoire +|Description of what happened in the meeting. + +|List of organizations that attended +|Facultatif +|Metadata that gets shown in the sidebar of the meeting. + +|Number of attendees +|Obligatoire +|Metadata that gets shown in the sidebar of the meeting. Must be a number. + +|Number of contributions +|Facultatif +|Metadata that gets shown in the sidebar of the meeting. Must be a number. + +|Propositions +|Facultatif +|Choose proposals from this space that were discussed in this meeting + +|Video URL +|Facultatif +|It's not used for anything. It will be removed in the future. + +|Audio URL +|Facultatif +|It's not used for anything. It will be removed in the future. + +|Is visible +|Facultatif +|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 +. Remplissez le formulaire + +image:components/meetings/close/form_frontend.png[Close meeting form in the frontend] + + +.Close meeting form (frontend) +|=== +|Champ |Type |Description + +|Minutes +|Obligatoire +|Description of what happened in the meeting. + +|Number of attendees +|Obligatoire +|Metadata that gets shown in the sidebar of the meeting. Must be a number. + +|Propositions +|Facultatif +|Choose proposals from this space that were discussed in this meeting +|=== + +== Propositions + +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 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..46584e523a --- /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 +. 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] +. Remplissez le formulaire + +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 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..49466995d5 --- /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 +. 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 +. 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 +. Remplissez le formulaire + +== Registrations settings form + +image:components/meetings/registrations/backend.png[Registrations settings in a meeting] + + +.Registrations settings form +|=== +|Champ |Type |Description + +|Registrations enabled +|Obligatoire +|Check to enable the registration for this meeting. + +|Registration form enabled +|Facultatif +|Check if you want to enable the registration form + +|Available slots for this meeting +|Obligatoire +|How many slots are available. Leave it to 0 if you have unlimited slots available. + +|Reserved slots +|Obligatoire +|How many slots are already reserved. Leave it to 0 if you don't have reserved slots + +|Registration terms +|Obligatoire +|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 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..2d3862899d --- /dev/null +++ b/docs/fr/modules/admin/pages/components/pages.adoc @@ -0,0 +1,85 @@ += Page + +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. + +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] + +Pour configurer la fonctionnalité Page : + +. Sign in as admin +. 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" +. Aller dans les fonctionnalités +. Cliquez sur le bouton "Ajouter une fonctionnalité" +. Click on "Page" +. Remplissez le formulaire xref:_add_component[Ajouter une fonctionnalité] + +== Ajouter une fonctionnalité + +image:components/page/component.png[Add component form] + + +.Add component: Page form +|=== +|Champ |Type |Description + +|Nom +|Obligatoire +|Quel est le titre de cette fonctionnalité. For instance, "More information". + +|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 +|=== +|Champ |Type |Description + +|Annonce +|Facultatif +|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 +|=== +|Champ |Type |Description + +|Annonce +|Facultatif +|A general announcement that'll be visible on the general page landing page. +|=== + +== Autorisations + +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 +|=== +|Champ |Type |Description + +|Body +|Obligatoire +|What is the body for the page. +|=== \ No newline at end of file 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..545ea49aad --- /dev/null +++ b/docs/fr/modules/admin/pages/components/proposals.adoc @@ -0,0 +1,445 @@ += 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: + +* 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. + +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] + +Pour configurer la fonctionnalité Propositions : + +. Sign in as admin +. 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" +. Aller dans les fonctionnalités +. Cliquez sur le bouton "Ajouter une fonctionnalité" +. Cliquer sur "Propositions" +. Remplissez le formulaire xref:_add_component[Ajouter une fonctionnalité] + +== Ajouter une fonctionnalité + +image:components/proposals/component.png[Add component form] + + +.Add component: Proposals form +|=== +|Champ |Type |Description + +|Nom +|Obligatoire +|Quel est le titre de cette fonctionnalité. Par exemple, "Proposions" + +|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 +|=== +|Champ |Type |Description + +|Scopes enabled +|Facultatif +|Check if you want to have Scopes filtering in this component. + +|Secteur +|Facultatif +|Which xref:admin:scopes.adoc[Scope] does this component belongs to. + +|Limite de votes par utilisateur +|Facultatif +|Must be a number. How much supports a participant can give to proposals. + +|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. + +|Limite de proposition par participant +|Facultatif +|Must be a number. Combien de propositions un participant peut créer. + +|Longueur maximale du corps de la proposition +|Facultatif +|Must be a number. How many characters a proposal body can have as maximum. + +|Proposal editing +|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. + +|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. + +|Seuil par proposition +|Facultatif +|Must be a number. Combien de votes une proposition doit avoir pour être considérée comme "acceptée". See <>. + +|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. + +|Réponses aux propositions activées +|Facultatif +|Whether administrators or valuators can answer proposals. + +|Propositions officielles activées +|Facultatif +|Wheter administrators can create official proposals. + +|Commentaires activés +|Facultatif +|Si vous voulez avoir des commentaires dans les rencontres. + +|Longueur maximale des commentaires +|Facultatif +|What are the characters limit that participants will have when making comments. Leave 0 for the default value. + +|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 +|Facultatif +|Check to allow participants to attach files to their proposals. + +|Allow card image +|Facultatif +|Check to show a card image when participants attach images to their proposals. See <>. + +|Actions permissions can be set for each proposal +|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 +|Facultatif +|Check to enable xref:components/proposals/collaborative_drafts.adoc[collaborative drafts] in proposals. + +|Participatory texts enabled +|Facultatif +|Check to enable xref:components/proposals/participatory_texts.adoc[participatory texts] in proposals. + +|Amendments enabled +|Facultatif +|Check to enable xref:components/proposals/amendments.adoc[amendments] in proposals. If active, configure Amendment features for each step. + +|Amendments Wizard help text +|Facultatif. Visible if the "Amendments enabled" option is checked. +|What's the help text visible when creating new amendments. + +|Annonce +|Facultatif +|A general announcement that'll be visible on the general proposals landing page. + +|New proposal body template +|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 +|Facultatif +|What's the help text visible when creating new proposals. + +|Proposal wizard "Create" step help text +|Facultatif +|What's the help text visible when creating new proposals in the "Create" step. + +|Proposal wizard "Compare" step help text +|Facultatif +|What's the help text visible when creating new proposals in the "Compare" step. + +|Proposal wizard "Complete" step help text +|Facultatif +|What's the help text visible when creating new proposals in the "Complete" step. + +|Proposal wizard "Publish" step help text +|Facultatif +|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 +|=== +|Champ |Type |Description + +|Annonce +|Facultatif +|A general announcement that'll be visible on the general proposal landing page. + +|Soutiens activés +|Facultatif +|Check if you want that participants show public support for these proposals. + +|Soutiens bloqués +|Facultatif +|Whether participants will be able to see the endorsments but don't make any. + +|Activer le module de vote simple +|Facultatif +|Whether participants will be able to support proposals in this step. + +|Bloquer les votes +|Facultatif +|Whether participants will be able to support proposals in this step. + +|Supports hidden +|Facultatif +|If supports are enabled, checking this will hide the number of supports. + +|Commentaires désactivés +|Facultatif +|Whether you want to enable comments for this phase. + +|Proposal creation enabled +|Facultatif +|Whether you want to enable proposal creation by participants for this phase. See xref:_new_proposal_form[New proposal form] + +|Réponses aux propositions activées +|Facultatif +|Whether you want to enable xref:components/proposals/answers.adoc[proposal answering]. + +|Publish proposal answers immediately +|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. + +|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]. + +|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 +|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 +|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 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" + +|Annonce +|Facultatif +|A general announcement that'll be visible on the general proposals landing page. + +|Hashtags added to all proposals +|Facultatif +|Automatically add a hashtag to every proposal. See <>. + +|Hashtags suggested to participants for new proposals +|Facultatif +|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] + +== 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: + +* Soutenir +* Support +* Create +* Withdraw +* Amend +* Commenter +* 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) +|=== +|Champ |Type |Description + +|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 +|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". +|=== + +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) +|=== +|Champ |Type |Description + +|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 +|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 +|Facultatif +|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 +|=== +|Icône |Nom |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] +|Autorisations +| + +|image:action_preview.png[Preview icon] +|Preview +|Pour voir comment il est montré dans le frontend aux 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 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..e39b209d94 --- /dev/null +++ b/docs/fr/modules/admin/pages/components/proposals/amendments.adoc @@ -0,0 +1,93 @@ += Amendements + +Grâce à la fonctionnalité d'amendement, les participants peuvent proposer des modifications à une proposition déjà publiée. + +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]. + +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:composents/propositions/amendements/amendement.png[Amendement d'une proposition] + +Pour configurer les "Amendements" dans le module de propositions: + +. Sign in as admin +. 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" +. 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 +|=== +|Champ |Type |Description + +|Amendments enabled +|Global +|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. + +|Création d'amendement activée +|Étape +|Participant can amend proposals. See xref:components/proposals/amendments.adoc[Amendments]. + +|Amendment reaction enabled +|Étape +|Proposal's authors will be able to accept or reject Participant's emendations. + +|Amendment promotion enabled +|Étape +|Emandation authors will be able to promote to Proposal the rejected emendation. + +|Amendments visibility +|Étape +|Choose one of "Amendments are visible to all" or "Amendments are visible only to their authors" +|=== + +== Promotion + +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 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..8c32bfe0e3 --- /dev/null +++ b/docs/fr/modules/admin/pages/components/proposals/answers.adoc @@ -0,0 +1,113 @@ += Réponses + +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/propositions/proposal_answer_state_accepted.png[État de la réponse à la proposition : acceptée] + +Pour répondre à une proposition : + +. 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" +. 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 + +Alternativement, vous pouvez aussi : + +. 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 + +== Page de réponse + +La page de réponse a trois sections : + +=== 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. + +=== 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 +|=== +|Champ |Type |Description + +|Internal state +|Obligatoire +|Choose one of the following: Accepted, Rejected, or Evaluating + +|Answer +|Facultatif +|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/propositions/proposal_answer_state_accepted.png[État de la réponse à la proposition : acceptée] + +=== 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: + +. 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" +. 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 +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 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..5a79206c3f --- /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 +. 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" +. Aller dans les fonctionnalités +. Cliquez sur le bouton "Ajouter une fonctionnalité" +. Cliquer sur "Propositions" +. Check the "Collaborative drafts enabled" setting +. Enregistrez le composant + +== 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 +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 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..113212a8e5 --- /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 +. 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" +. Aller dans les fonctionnalités +. Cliquez sur le bouton "Ajouter une fonctionnalité" +. Cliquer sur "Propositions" +. Check the "Participatory texts enabled" setting +. 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 +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 +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|What's the title of the document? + +|Description +|Facultatif +|Description for the document + +|Document +|Obligatoire +|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 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..7d7fb98012 --- /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 +. 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" +. Remplissez le formulaire xref:_add_component[Ajouter une fonctionnalité] + +== Ajouter une fonctionnalité + +image:components/skeleton/component.png[Add component form] + + +.Add component: Skeleton form +|=== +|Champ |Type |Description + +|Nom +|Obligatoire +|Quel est le titre de cette fonctionnalité. For instance, "Skeletons" + +|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 +|=== +|Champ |Type |Description + +|Scopes enabled +|Facultatif +|Check if you want to have Scopes filtering in this component. + +|Secteur +|Facultatif +|Which xref:admin:scopes.adoc[Scope] does this component belongs to. + +|Portée générale +|Facultatif +| + +|Commentaires activés +|Facultatif +|Si vous voulez avoir des commentaires dans les rencontres. + +|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 +|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. + +|Annonce +|Facultatif +|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 +|=== +|Champ |Type |Description + +|Commentaires désactivés +|Facultatif +|Whether you want to enable comments for this phase. + +|Annonce +|Facultatif +|A general announcement that'll be visible on the general skeleton landing page. +|=== + +== 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 +* Soutenir + +== 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 +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|What is the title of this skeleton. For instance, "District A" + +|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 +|Facultatif +|What is the description of this skeleton. +|=== + +==== Actions + + +.Actions +|=== +|Icône |Nom |Definition + +|image:action_preview.png[Preview icon] +|Preview +|Pour voir comment il est montré dans le frontend aux participants. + +|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] +|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. Peut être fait unquement quand il n'y a pas de projets dans ce budget. +|=== \ No newline at end of file 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..a30679d2e5 --- /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 +. 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" +. 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. + +== Ajouter une fonctionnalité + +image:components/surveys/component.png[Add component form] + + +.Add component: Survey form +|=== +|Champ |Type |Description + +|Nom +|Obligatoire +|Quel est le titre de cette fonctionnalité. For instance, "Surveys" + +|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 +|=== +|Champ |Type |Description + +|Scopes enabled +|Facultatif +|Check if you want to have Scopes filtering in this component. + +|Secteur +|Facultatif +|Which xref:admin:scopes.adoc[Scope] does this component belongs to. + +|Answers accepted from +|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 +|Annonce + +|Facultatif +|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 +|=== +|Champ |Type |Description + +|Allow answers +|Facultatif +|Check if you want to receive answers in this survey. + +|Allow unregistered users to answer the survey +|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. + +|Annonce +|Facultatif +|A general announcement that'll be visible on the general survey landing page. +|=== + +== 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: + +* 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 +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|What is the title of this survey. For instance, "Feedback" + +|Description +|Facultatif +|What is the description of this survey. + +|Terms of service +|Obligatoire +|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 +|=== +|Champ |Type |Description + +|Statement +|Obligatoire +|The question itself. For instance, "What is your age category?" + +|Description +|Facultatif +|Explanation of the question being made. + +|Mandatory +|Facultatif +|Check if this question is required to respond to submit the answer. + +|Character limit +|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 +|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. +|=== + +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 diff --git a/docs/fr/modules/admin/pages/configuration.adoc b/docs/fr/modules/admin/pages/configuration.adoc new file mode 100644 index 0000000000..591110e30e --- /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] + +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: +** 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 diff --git a/docs/fr/modules/admin/pages/dashboard.adoc b/docs/fr/modules/admin/pages/dashboard.adoc new file mode 100644 index 0000000000..f1f10650c0 --- /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 +* Propositions +* Comments +* Meetings +* Accepted proposals +* Results +1. Admin log: last actions made by Administrator users in the platform. \ No newline at end of file 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..d488caac7d --- /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 |Titre |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] +|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 +|=== \ No newline at end of file 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 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..b76d9cee0f --- /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] + +Alternativement, vous pouvez aussi : + +. 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 +. 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] + +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 +. Remplissez le formulaire + +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 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 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 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 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 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 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..90ecc9d0e2 --- /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 her 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 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..ae32dca82c --- /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 +|=== +|Champ |Type |Description + +|Avatar +|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 +|Obligatoire +|The name of the participant. + +|Nickname +|Obligatoire +|The nickname of the participant. + +|Your email +|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 +|Facultatif +|Metadata that is displayed in the participant's profile. + +|About +|Facultatif +|Metadata that is displayed in the participant's profile. + +|Locale +|Obligatoire +|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 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 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 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 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 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 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 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 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 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..33459c1375 --- /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) + +|=== +|Icône |Nom |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) + +|=== +|Icône |Nom |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 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 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 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 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 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 diff --git a/docs/fr/modules/admin/pages/newsletters.adoc b/docs/fr/modules/admin/pages/newsletters.adoc new file mode 100644 index 0000000000..d214ce58e3 --- /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 +|=== +|Champ |Type |Description + +|Subject +|Obligatoire +|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 +|=== +|Champ |Type |Description + +|Subject +|Obligatoire +|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 diff --git a/docs/fr/modules/admin/pages/pages.adoc b/docs/fr/modules/admin/pages/pages.adoc new file mode 100644 index 0000000000..5e4448b532 --- /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 +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|Title of this page. For instance: "How to participate?" + +|URL Slug +|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 +|Obligatoire +|All the text of the page. + +|Topic +|Facultatif +|In which Topic it'll be in. + +|Weight +|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 +|Facultatif +|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 +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|Title of this topic. For instance: "Help" + +|Description +|Facultatif +|What's this topic is about. + +|Weight +|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 +|Facultatif +|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 diff --git a/docs/fr/modules/admin/pages/participants.adoc b/docs/fr/modules/admin/pages/participants.adoc new file mode 100644 index 0000000000..a355128f7b --- /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[Administrateurs] +* xref:admin:participants/groups.adoc[Groupes d'utilisateurs] +* xref:admin:participants/participants.adoc[Participants] +* 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 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 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..26ba2db019 --- /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[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 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 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 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..5b4527360a --- /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 +|=== +|Champ |Type |Description + +|Available methods +|Obligatoire +|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 +|=== +|Champ |Type |Description + +|Participant email +|Obligatoire +|Email of the registered participant + +|Type of the document +|Obligatoire +|Can be: DNI, NIE or Passport + +|Document number (with letter) +|Obligatoire +|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 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..de06202d06 --- /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 +|=== +|Champ |Type |Description + +|Nom +|Obligatoire +|Name of your organization, association, collective, group, etc. + +|Nickname +|Obligatoire +|Nickname of your organization, association, collective, group, etc. Do not use spaces nor accents. 20 characters maximum. + +|Email +|Obligatoire +|Email of your organization, association, collective, group, etc. + +|Avatar +|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 +|Facultatif +|Description of what's this group. + +|Document number +|Facultatif +|Used for verifications. Do not use dashes nor spaces. + +|Phone +|Facultatif +|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] + +=== Soutenir + +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 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 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..0b305f7eda --- /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] + +|=== +|Icône |Nom |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 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 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..2b43de75fa --- /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 +|=== +|Champ |Type |Description + +|Reason +|Obligatoire +|Why you want to transfer the user + +|Email +|Obligatoire +|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 diff --git a/docs/fr/modules/admin/pages/scopes.adoc b/docs/fr/modules/admin/pages/scopes.adoc new file mode 100644 index 0000000000..b30dfdad73 --- /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 +|=== +|Champ |Type |Description + +|Singular +|Obligatoire +|Name of the scope type in singular. + +|Plural +|Obligatoire +|Name of the scope type in plural. +|=== + +image:scopes_new_form.png[New scope form] + + +.Admin New Scope Form +|=== +|Champ |Type |Description + +|Nom +|Obligatoire +|Name of the scope. + +|Code +|Obligatoire +|(Internal) name of the scope. + +|Scope type +|Obligatoire +|Which type of scope it's. +|=== + +== Actions + +You have 3 possible actions in this list after a Scope is created: + +|=== +|Icône |Nom |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. +|=== + +== Fonctionnalités + +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 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 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..1252ceb0f5 --- /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 +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|Title of the assembly. For instance, "General Committee". + +|Subtitle +|Obligatoire +|Subtitle. For instance, "Let's decide our priorities together" + +|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 +|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 +|Facultatif +|Hashtag for Twitter + +|Short description +|Obligatoire +|A short explanation of what's your participatory process about. + +|Description +|Obligatoire +|A long explanation of what's your assembly about. + +|Purpose of action +|Facultatif +|Internal field that doesn't get shown publicly. To be removed in a future version. + +|Composition +|Facultatif +|Internal field that doesn't get shown publicly. To be removed in a future version. + +|Internal organisation +|Facultatif +|Internal field that doesn't get shown publicly. To be removed in a future version. + +|Annonce +|Facultatif +|The text you enter here will be shown to the user right below the assembly information. +|=== + + +.New assembly form: Duration +|=== +|Champ |Type |Description + +|Date created +|Facultatif +|Information that's displayed in the assembly metadata sidebar. Expected format: dd/mm/yyyy + +|Included at +|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 + +|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 +|Facultatif +|Information that's displayed in the assembly metadata sidebar. When this assembly closed. Expected format: dd/mm/yyyy + +|Closing date reason +|Facultatif +|Information that's displayed in the assembly metadata sidebar. Why this assembly closed. +|=== + + +.New assembly form: Images +|=== +|Champ |Type |Description + +|Home image +|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 +|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 +|=== + + +.New assembly form: Filters +|=== +|Champ |Type |Description + +|Scopes enabled +|Facultatif +|Check if you want to have Scopes filtering in this assembly. + +|Secteur +|Facultatif +|Which xref:admin:scopes.adoc[Scope] does this assembly belongs to. + +|Area +|Facultatif +|Which xref:admin:areas.adoc[Area] does this assembly belongs to. +|=== + + +.New assembly form: Metadata +|=== +|Champ |Type |Description + +|What is decided +|Facultatif +|Information that's displayed in the assembly metadata sidebar. + +|How is it decided +|Facultatif +|Information that's displayed in the assembly metadata sidebar. + +|Scope metadata +|Facultatif +|Information that's displayed in the assembly metadata sidebar. + +|Promoter group +|Facultatif +|Information that's displayed in the assembly metadata sidebar. + +|Organization area +|Facultatif +|Information that's displayed in the assembly metadata sidebar. + +|Who participates +|Facultatif +|Information that's displayed in the assembly metadata sidebar. +|=== + + +.New assembly form: Visibility +|=== +|Champ |Type |Description + +|Parent assembly +|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 +|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 +|Facultatif +|Check if this assembly should only be accessible by xref:admin:spaces/assemblies/private_participants.adoc[Private Participants] + +|Is transparent +|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. +|=== + + +.New assembly form: Other +|=== +|Champ |Type |Description + +|Created by +|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 +|Facultatif +|Which xref:_assemblies_types[assembly type] is this assembly. + +|Related processes +|Facultatif +|Select other participatory processes that are related to this assembly. + +|Social +|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 +|Facultatif +|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 +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|Title of the this assembly type. For instance, "Consultative". +|=== + +== Paramètres + +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 +|=== +|Champ |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 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 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 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 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 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..1b92a79948 --- /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 +. Remplissez le formulaire + +image:assembly_members_new_form.png[Assembly members new form] + + +.New assembly member form +|=== +|Champ |Type |Description + +|Participant type +|Obligatoire +|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 +|Obligatoire +|Choose one of President, Vice president, Secretary, or Other. In case it's other, you can fill in the position title. + +|Weight +|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 +|Obligatoire +|When was this person or group assigned as a member of this assembly. Expected format: dd/mm/yyyy + +|Designation mode +|Facultatif +|How was this person designed. + +|Ceased date +|Facultatif +|When was this person or group ceased to be a member of this assembly. Expected format: dd/mm/yyyy + +|Gender +|Facultatif +|Which gender does this person most identify with. + +|Birthday +|Facultatif +|When was this person born. Expected format: dd/mm/yyyy + +|Birthplace +|Facultatif +|Where was this person born. +|=== \ No newline at end of file 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 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 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..d2ae80dbdd --- /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 +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|What is the title of this conference. For instance "Decidim Fest 2021" + +|Slogan +|Obligatoire +|A subtitle for this conference. For instance, "Democracy, Technology and Global Justice" + +|URL slug +|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 +|Facultatif +|Hashtag for Twitter + +|Highlighted +|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 +|Obligatoire +|A short explanation of what's your conference about. + +|Description +|Obligatoire +|A long explanation of what's your conference about. + +|Objectives +|Facultatif +|What are the objectives or goals for this conference? + +|Location +|Facultatif +|Where will this conference take place? + +|Home image +|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 +|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 +|Facultatif +|Check if you want to have Scopes filtering in this conference + +|Secteur +|Facultatif +|Which xref:admin:scopes.adoc[Scope] does this conference belongs to. + +|Show statistics +|Facultatif +|Check if you want to show the Statistics section. + +|Start date +|Obligatoire +|When will this conference start. Expected format: dd/mm/yyyy + +|End date +|Obligatoire +|When will this conference end. Expected format: dd/mm/yyyy + +|Registrations enabled +|Facultatif +|Check if you want to handle registrations on the platform. + +|Available slots +|Facultatif +|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 +|Facultatif +|Select the processes that are related to this conference. Use the *ctrl* function to select more than one option. + +|Related Assemblies +|Facultatif +|Select the assemblies that are related to this conference. Use the *ctrl* function to select more than one option. + +|Related Consultations +|Facultatif +|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 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 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..64807105d2 --- /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 +|=== +|Champ |Type |Description + +|Attachment or image name +|Obligatoire +|What is the title for this attachment. + +|Weight +|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 +|Obligatoire +|A long description explaining what this file is about. + +|Folder +|Facultatif +|Which folder this attachment belongs to. + +|File +|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. +|=== + +== Create a new folder + +image:spaces/attachments_new_folder_form.png[Create a new folder for attachments form] + + +.Create folder +|=== +|Champ |Type |Description + +|Nom +|Obligatoire +|Name of the folder + +|Weight +|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 +|Obligatoire +|A long description explaining what this folder is about. +|=== \ No newline at end of file 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 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 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..f5e92ddc85 --- /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 +. Remplissez le formulaire + +image:spaces/conferences/new_media_link.png[Create a new conferences media link] + + +.New media link form +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|The title of the link + +|Link +|Obligatoire +|URL of the link + +|Date +|Obligatoire +|Published date of the link + +|Weight +|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 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 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..b8a7ef8f4c --- /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 +. Remplissez le formulaire + +image:spaces/conferences/new_partner.png[Conferences partners form] + + +.New partner form +|=== +|Champ |Type |Description + +|Nom +|Obligatoire +|What is the name of this partner. + +|Partner type +|Obligatoire +|Choose one of these options: Main promotor or Collaborator + +|Weight +|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 +|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 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 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..e4711583dd --- /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 +|=== +|Champ |Type |Description + +|Main logo +|Obligatoire +|Logo of the conference of the organization that makes the certificate of attendance. + +|Signature +|Obligatoire +|Image of the person that signs the certificate. + +|Sign date +|Obligatoire +|Date of the signature. Expected format: dd/mm/yyyy + +|Signature name +|Obligatoire +|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 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..dab1ad716e --- /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 +|=== +|Champ |Type |Description + +|Attendee type +|Obligatoire +|Wheter this invited person is a non-existing or existing participant. Does she already have an account created on the platform? + +|Nom +|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] +|Obligatoire +|What xref:admin:spaces/conferences/registrations/types.adoc[registration type] does this participant will have. +|=== \ No newline at end of file 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..5d943bab07 --- /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 +. Remplissez le formulaire +. 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 +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|What is the title of this registration type. + +|Weight +|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 + +|Obligatoire +|Description for this registration type +|Price + +|Facultatif +|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 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 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..01fdd30e12 --- /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 +. Remplissez le formulaire + +image:spaces/conferences/new_speaker.png[Conferences speakers] + + +.New conference speaker form +|=== +|Champ |Type |Description + +|Participant type +|Obligatoire +|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 +|Facultatif +|Which meetings does this speaker attend and participates actively? + +|Position +|Obligatoire +|Metadata for showing extra information about the speaker. + +|Affiliation +|Obligatoire +|Metadata for showing extra information about the speaker. + +|Short Bio +|Facultatif +|Metadata for showing extra information about the speaker. + +|Twitter handle +|Facultatif +|Metadata for showing extra information about the speaker. + +|Personal URL +|Facultatif +|Metadata for showing extra information about the speaker. + +|Avatar +|Facultatif +|Metadata for showing extra information about the speaker. + +Default image +|=== \ No newline at end of file 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 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..e19a8cbc3a --- /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 +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|Title of the initiative type. For instance, "New park at city center". + +|Description +|Obligatoire +|Explanation of what can be done with this initiative type. + +|Banner image +|Obligatoire +|An image for this initiative type. NOTE: At the moment this is not used. +|=== + + +.Admin new initiative type form: Options +|=== +|Champ |Type |Description + +|Signature type +|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 +|Facultatif +|Whether it'll allow to upload attachments to initiatives. + +|Enable participants to undo their online signatures +|Facultatif +|Can a participant undo its signature when they already signed? + +|Enable authors to choose the end of the signature collection period +|Facultatif +|Can the authors of an initiative change the end of the signature collection period? + +|Enable authors to choose the area for their initiative +|Facultatif +|Can the authors choose the area of their initiative? + +|Enable child scope signatures +|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 +|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 +|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 +|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 +|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 +|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 +|=== +|Champ |Type |Description + +|Authorization to verify document number on signatures +|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 +| +|During the signature process, will it ask for SMS validation? See xref:services:sms.adoc[configuration of SMS service]. +|=== + +=== 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 +|=== +|Champ |Type |Description + +|Scopes +|Obligatoire +|A Scope. An author can choose this scope in the creation of the initiative. + +|Signatures required +|Obligatoire +|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] + +|=== +|Icône |Nom |Definition + +|image:action_preview.png[Preview icon] +|Preview +|Pour voir comment il est montré dans le frontend aux 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. +|=== + +=== 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 +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 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..6d29125193 --- /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 +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|Title of the participatory process. For instance, "Participatory Budgeting 2020". + +|Subtitle +|Obligatoire +|Subtitle. For instance, "Let's decide our priorities together" + +|URL slug +|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 +|Facultatif +|Hashtag for Twitter + +|Short description +|Obligatoire +|A short explanation of what's your participatory process about. + +|Description +|Obligatoire +|A long explanation of what's your participatory process about. + +|Annonce +|Facultatif +|The text you enter here will be shown to the user right below the process information. +|=== + + +.New participatory process form: Duration +|=== +|Champ |Type |Description + +|Start date +|Facultatif +|When this process start. You have a calendar widget to choose the day. Expected format: dd/mm/yyyy + +|End date +|Facultatif +|When this process start. You have a calendar widget to choose the day. Expected format: dd/mm/yyyy +|=== + + +.New participatory process form: Images +|=== +|Champ |Type |Description + +|Home image +|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 +|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 +|=== + + +.New participatory process form: Metadata +|=== +|Champ |Type |Description + +|Promoter group +|Facultatif +|Information that's displayed in the process metadata sidebar. + +|Organization area +|Facultatif +|Information that's displayed in the process metadata sidebar. + +|Scope metadata +|Facultatif +|Information that's displayed in the process metadata sidebar. + +|Who participates +|Facultatif +|Information that's displayed in the process metadata sidebar. + +|What is decided +|Facultatif +|Information that's displayed in the process metadata sidebar. + +|How is it decided +|Facultatif +|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 +|=== +|Champ |Type |Description + +|Scopes enabled +|Facultatif +|Check if you want to have Scopes filtering in this process. + +|Secteur +|Facultatif +|Which xref:admin:scopes.adoc[Scope] does this process belongs to. + +|Scope filter depth +|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 +|Facultatif +|Which xref:admin:areas.adoc[Area] does this process belongs to. +|=== + + +.New participatory process form: Visibility +|=== +|Champ |Type |Description + +|Processes group +|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 +|Facultatif +|Check if this process should only be accessible by xref:admin:spaces/processes/private_participants.adoc[Private Participants] + +|Promoted +|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. +|=== + + +.New participatory process form: Filters +|=== +|Champ |Type |Description + +|Related processes +|Facultatif +|Select other participatory processes that are related to this one. +|=== + + +.New participatory process form: Filters +|=== +|Champ |Type |Description + +|Show statistics +|Facultatif +|Check if you want to show the Statistics section. + +|Show metrics +|Facultatif +|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[Étapes] +. 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[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 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 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 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 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 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..06a7be3cae --- /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 +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|Title of the participatory process group. For instance, "Participatory Budgeting". + +|Description +|Obligatoire +|A long explanation of what's your participatory process about. + +|Related processes +|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 +|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 +|=== + + +.New participatory process group form: Metadata +|=== +|Champ |Type |Description + +Hashtag +Website + +|Promoter group +|Facultatif +|Information that's displayed in the process metadata content block. + +|Organization area +|Facultatif +|Information that's displayed in the process metadata content block. + +|Scope metadata +|Facultatif +|Information that's displayed in the process metadata content block. + +|Who participates +|Facultatif +|Information that's displayed in the process metadata content block. + +|What is decided +|Facultatif +|Information that's displayed in the process metadata content block. + +|How is it decided +|Facultatif +|Information that's displayed in the process metadata content block. +|=== + + +.New participatory process group form: Visibility +|=== +|Champ |Type |Description + +|Promoted +|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. +|=== + +== 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 +* 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. +* Upcoming events +* Statistics +* Participatory processes +* First HTML block +* Second HTML block +* Third HTML block \ No newline at end of file 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 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..b050acea21 --- /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 +|=== +|Champ |Type |Description + +|Titre +|Obligatoire +|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: + +|=== +|Icône |Nom |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 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 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 diff --git a/docs/fr/modules/admin/pages/system.adoc b/docs/fr/modules/admin/pages/system.adoc new file mode 100644 index 0000000000..f4c40722ed --- /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 +|=== +|Champ |Type |Description + +|Nom +|Obligatoire +|Name of your organization. For instance, "Decidim Barcelona". + +|Reference prefix +|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 +|Obligatoire +|Fully qualified domain name. For instance, "example.org" or "decidim.barcelona". + +|Secondary hosts +|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 +|Obligatoire +|Name of the admin account. For instance, "Admin" + +|Organization admin email +|Obligatoire +|Email for the admin account. For instance, "admin@example.org" + +|Organization locales +|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 +|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 +|Facultatif +|Control how you want the login / participant register or signup to work. See below. + +|Available authorizations +|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 +|Facultatif +|Allows you to configure different SMTP servers for every Organzation in this installation. See xref:services:smtp.adoc[SMTP configuration]. + +|Omniauth settings +|Facultatif +|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 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 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 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 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 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..3de709b52a --- /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 +|=== +|Champ |Type |Description + +|Nom +|Obligatoire +|What is the name of the new admin. + +|Email +|Obligatoire +|What is the email of the new admin, so she can receive the invitation. + +|Role +|Obligatoire +|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 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..aa966eb4ec --- /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 +|=== +|Champ |Type |Description + +|Attachment or image name +|Obligatoire +|What is the title for this attachment. + +|Weight +|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 +|Obligatoire +|A long description explaining what this file is about. + +|Folder +|Facultatif +|Which folder this attachment belongs to. + +|File +|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. +|=== + +== Create a new folder + +image:spaces/attachments_new_folder_form.png[Create a new folder for attachments form] + + +.Create folder +|=== +|Champ |Type |Description + +|Nom +|Obligatoire +|Name of the folder + +|Weight +|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 +|Obligatoire +|A long description explaining what this folder is about. +|=== \ No newline at end of file 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..b18e4622f0 --- /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 +|=== +|Champ |Type |Description + +|Nom +|Obligatoire +|What is the name for this category. + +|Weight +|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 +|Obligatoire +|A long description explaining what this category is about. + +|Parent +|Facultatif +|What is the parent category. +|=== \ No newline at end of file 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..b4b3a09bc8 --- /dev/null +++ b/docs/fr/modules/admin/partials/page_components.adoc @@ -0,0 +1,52 @@ += Fonctionnalités + +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 + +|=== +|Icône |Nom |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] +|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. + +|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 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 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..d0f0c01f94 --- /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 +|=== +|Champ |Type |Description + +|Nom +|Obligatoire +|What is the name of the new participant. + +|Email +|Obligatoire +|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] + +|=== +|Icône |Nom |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 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 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 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 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 diff --git a/docs/fr/modules/contribute/pages/translations.adoc b/docs/fr/modules/contribute/pages/translations.adoc new file mode 100644 index 0000000000..e2cd36f223 --- /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]. + +== 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). + +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 diff --git a/docs/fr/modules/features/pages/components.adoc b/docs/fr/modules/features/pages/components.adoc new file mode 100644 index 0000000000..118d0b6de0 --- /dev/null +++ b/docs/fr/modules/features/pages/components.adoc @@ -0,0 +1,183 @@ += Fonctionnalités + +:page-partial: + +*Components* are participatory mechanisms that allow interactions among the platform Participants within each of the Participatory Spaces. + +== Propositions + +*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. + +=== Suivi des réalisations + +The *accountability* component works like a project management system built into the platform. . It offers the possibility of: + +* 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 + +Les réalisations, les projets et les statuts peuvent être mis à jour via un CSV, ou manuellement via l'interface d'administration. + +=== 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 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 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 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 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 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 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 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 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 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 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 diff --git a/docs/fr/modules/releases/pages/index.adoc b/docs/fr/modules/releases/pages/index.adoc new file mode 100644 index 0000000000..28dc06637b --- /dev/null +++ b/docs/fr/modules/releases/pages/index.adoc @@ -0,0 +1,35 @@ += 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/2023-12-20-new-version-0-28-0/[Version 0.28 (2022-12-20)] +* 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 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 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 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 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 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 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 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 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 diff --git a/docs/pt/modules/ROOT/pages/index.adoc b/docs/pt/modules/ROOT/pages/index.adoc index 5310bbf5ca..afb92814ed 100644 --- a/docs/pt/modules/ROOT/pages/index.adoc +++ b/docs/pt/modules/ROOT/pages/index.adoc @@ -10,7 +10,7 @@ You’ve found the documentation for Decidim. Learn about the project at https:/ [NOTE] ==== -This is the documentation for the `0.27` version. You can see this same documentation site for other versions: xref:v0.26@ROOT:index.adoc[v0.26] and xref:develop@ROOT:index.adoc[develop] +This is the documentation for the `0.27` version. You can see this same documentation site for other versions: xref:v0.28@ROOT:index.adoc[v0.28] and xref:develop@ROOT:index.adoc[develop] ==== // * Read the xref:ROOT:getting-started.adoc[Getting Started guide] diff --git a/docs/pt/modules/releases/pages/index.adoc b/docs/pt/modules/releases/pages/index.adoc index c9f9bc7423..28dc06637b 100644 --- a/docs/pt/modules/releases/pages/index.adoc +++ b/docs/pt/modules/releases/pages/index.adoc @@ -6,6 +6,9 @@ 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/2023-12-20-new-version-0-28-0/[Version 0.28 (2022-12-20)] +* 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]