Skip to content
New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

General fixes #185

Merged
merged 8 commits into from
Feb 12, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion .github/styles/config/vocabularies/Decidim/accept.txt
Original file line number Diff line number Diff line change
@@ -8,14 +8,17 @@ Etherpad
[Ff]aq
[Ff]avicon
[Gg]amification
Gemfile
[Gg]eocoding
initializer
[Ii]nitializer
Javascript
Jitsi
[Kk]akogawa
Keka
Mautic
[Mm]oderations
[Nn]ickame
OAuth
[Oo]fficialization
[Oo]fficializing
[Oo]fficialize
6 changes: 4 additions & 2 deletions docs/en/modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
@@ -5,6 +5,7 @@
** xref:install:update.adoc[Update]

* xref:configure:index.adoc[Configure]
** xref:configure:system.adoc[System panel]
** xref:configure:environment_variables.adoc[Environment Variables]
** xref:configure:initializer.adoc[Initializer]
** xref:customize:index.adoc[Customize]
@@ -69,6 +70,7 @@
*** xref:admin:spaces/assemblies.adoc[Assemblies]
**** xref:admin:spaces/assemblies/types.adoc[Assembly types]
**** xref:admin:spaces/assemblies/assembly_creation.adoc[Assembly creation]
**** xref:admin:spaces/assemblies/landing_page.adoc[Landing page]
**** xref:admin:spaces/assemblies/components.adoc[Components]
**** xref:admin:spaces/assemblies/categories.adoc[Categories]
**** xref:admin:spaces/assemblies/attachments.adoc[Attachments]
@@ -205,7 +207,7 @@
*** Maintainers
**** xref:develop:backports.adoc[Backports]
**** xref:develop:guide_github_projects.adoc[GitHub Projects Workflow]
**** xref:develop:maintainers/releases.adoc[Releasing new versionss]
**** xref:develop:maintainers/releases.adoc[Releasing new versions]
**** xref:develop:maintainers/security.adoc[Security procedures]
*** xref:develop:metrics.adoc[Metrics]
*** xref:develop:modules.adoc[Modules]
@@ -245,7 +247,7 @@
*** xref:publications:german.adoc[German]
*** xref:publications:italian.adoc[Italian]
*** xref:publications:spanish.adoc[Spanish]
** Whitepaper
** White paper
*** xref:whitepaper:decidim-a-brief-overview.adoc[Decidim: a brief overview]

* xref:releases:index.adoc[Release notes]
Binary file removed docs/en/modules/admin/assets/images/action_activate.png
Binary file not shown.
Binary file removed docs/en/modules/admin/assets/images/action_agenda.png
Binary file not shown.
Binary file removed docs/en/modules/admin/assets/images/action_answer.png
Binary file not shown.
Binary file not shown.
Binary file removed docs/en/modules/admin/assets/images/action_block.png
Binary file not shown.
Binary file removed docs/en/modules/admin/assets/images/action_browse.png
Binary file not shown.
Binary file removed docs/en/modules/admin/assets/images/action_check.png
Binary file not shown.
Binary file removed docs/en/modules/admin/assets/images/action_close.png
Binary file not shown.
Binary file not shown.
Binary file removed docs/en/modules/admin/assets/images/action_contact.png
Binary file not shown.
Binary file removed docs/en/modules/admin/assets/images/action_delete.png
Binary file not shown.
Binary file not shown.
Binary file removed docs/en/modules/admin/assets/images/action_edit.png
Binary file not shown.
Binary file removed docs/en/modules/admin/assets/images/action_expand.png
Binary file not shown.
Binary file removed docs/en/modules/admin/assets/images/action_folder.png
Binary file not shown.
Binary file removed docs/en/modules/admin/assets/images/action_hide.png
Binary file not shown.
Binary file removed docs/en/modules/admin/assets/images/action_list.png
Binary file not shown.
Binary file removed docs/en/modules/admin/assets/images/action_manage.png
Binary file not shown.
Binary file not shown.
Binary file removed docs/en/modules/admin/assets/images/action_minutes.png
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file removed docs/en/modules/admin/assets/images/action_preview.png
Binary file not shown.
Binary file removed docs/en/modules/admin/assets/images/action_print.png
Binary file not shown.
Binary file removed docs/en/modules/admin/assets/images/action_publish.png
Binary file not shown.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Binary file removed docs/en/modules/admin/assets/images/action_share.png
Diff not rendered.
Diff not rendered.
Diff not rendered.
Binary file removed docs/en/modules/admin/assets/images/action_unhide.png
Diff not rendered.
Diff not rendered.
Diff not rendered.
Binary file removed docs/en/modules/admin/assets/images/action_unreport.png
Diff not rendered.
Binary file removed docs/en/modules/admin/assets/images/admin_areas.png
Diff not rendered.
Diff not rendered.
Diff not rendered.
Binary file removed docs/en/modules/admin/assets/images/admin_scopes.png
Diff not rendered.
Diff not rendered.
Diff not rendered.
Binary file removed docs/en/modules/admin/assets/images/icon_envelope.png
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Original file line number Diff line number Diff line change
@@ -7,7 +7,7 @@
name of the group.

NOTE: The group creation option is only available when groups are enabled for the organization.
You can ask an administrator of the platform or enable it from the xref:admin:configuration.adoc[Configuration] panel.
You can ask an administrator of the platform or enable it from the xref:admin:settings/configuration.adoc[Configuration] panel.

Check warning on line 10 in docs/en/modules/admin/pages/features/participant_actions/group_profile.adoc

GitHub Actions / prose

[vale] reported by reviewdog 🐶 [Google.WordList] Use 'administrator' instead of 'admin'. Raw Output: {"message": "[Google.WordList] Use 'administrator' instead of 'admin'.", "location": {"path": "docs/en/modules/admin/pages/features/participant_actions/group_profile.adoc", "range": {"start": {"line": 10, "column": 73}}}, "severity": "WARNING"}

== Create a group

Original file line number Diff line number Diff line change
@@ -124,7 +124,7 @@ Read more about groups configuration in the xref:admin:participants/groups.adoc[

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
By default what they see here is a list of all the xref:admin:settings/scopes.adoc[Scopes] of the organization. Those selections
can be used by administrators when segmenting for the xref:admin:features/social_features/newsletters.adoc[Newsletters].

image::features/my_account/my_interests.png[My interests]
Original file line number Diff line number Diff line change
@@ -22,7 +22,8 @@ image::features/my_profile/profile_dropdown.png[Frontend user menu dropdown]

There, you'll find different tabs.

NOTE: You might not see the Badges and the Groups tab if you didn't enable them in the xref:admin:configuration.adoc[Configuration] panel.
NOTE: You might not see the Badges and the Groups tab if you didn't enable them in the
xref:admin:settings/configuration.adoc[Configuration] panel.

=== Activity

@@ -55,8 +56,7 @@ image::features/my_profile/profile_followers.png[Public profile followers tab]

=== Groups

The groups section contains all the groups that the user belongs to. More information about the groups feature is
available at the xref:admin:features/participant_actions/groups.adoc[User groups page].
The groups section contains all the groups that the user belongs to.

image::features/my_profile/profile_groups.png[Public profile groups tab]

@@ -78,4 +78,3 @@ Logged in participants can perform two actions from their public profile page:
. Create a group: When clicking this button, they're redirected to the xref:admin:features/participant_actions/group_profile.adoc[group creation form].

NOTE: The group creation option is only available when groups are enabled for the organization.
You can do it from the xref:admin:configuration.adoc[Configuration] panel.
Original file line number Diff line number Diff line change
@@ -19,6 +19,8 @@ image::features/comments/form.png[Comments form]

When commenting, participants can:

.Comment actions
[cols="10h,~,~,~"]
|===
|Type |Description |Syntax |Example

Original file line number Diff line number Diff line change
@@ -57,6 +57,7 @@ NOTE: You can use "%\{name}" anywhere in the body or subject to be automatically
image::features/newsletters/newsletter_new_basic.png[Newsletter new template basic form]

.New Newsletter "basic (only text)" form
[cols="20h,10h,~"]
|===
|Field |Type |Description

@@ -72,6 +73,7 @@ image::features/newsletters/newsletter_new_basic.png[Newsletter new template bas
image::features/newsletters/newsletter_new_cta.png[Newsletter new template Image, text and CTA form]

.New Newsletter "Image, text and Call To Action button" form
[cols="20h,10h,~"]
|===
|Field |Type |Description

@@ -162,6 +164,8 @@ You can find all the newsletters on the newsletter page, with:

=== Actions

.Actions
[cols="10h,20h,~"]
|===
|Icon |Name |Definition |Condition

24 changes: 12 additions & 12 deletions docs/en/modules/admin/pages/first_steps.adoc
Original file line number Diff line number Diff line change
@@ -38,7 +38,7 @@
Those terms of service can be useful for you if you start inviting other administrators to the platform, and you need them to be aware
of specific privacy rules, or anything relevant for them before they have access to the administration.

Those terms of service can be configured in the xref:admin:configuration.adoc[Configuration panel].
Those terms of service can be configured in the xref:admin:settings/configuration.adoc[Configuration panel].

Check warning on line 41 in docs/en/modules/admin/pages/first_steps.adoc

GitHub Actions / prose

[vale] reported by reviewdog 🐶 [Google.Passive] In general, use active voice instead of passive voice ('be configured'). Raw Output: {"message": "[Google.Passive] In general, use active voice instead of passive voice ('be configured').", "location": {"path": "docs/en/modules/admin/pages/first_steps.adoc", "range": {"start": {"line": 41, "column": 28}}}, "severity": "INFO"}

=== Explanation of the dashboard

@@ -58,14 +58,14 @@

To navigate in the administration panel, you can click in all of the items displayed in the vertical navigation bar on the left.

*** xref:admin:spaces/processes.adoc[Participatory Processes]
*** xref:admin:spaces/assemblies.adoc[Assemblies]
*** xref:admin:spaces/initiatives.adoc[Initiatives]
*** xref:admin:spaces/conferences.adoc[Conferences]
** xref:admin:global_moderations.adoc[Global moderations]
** xref:admin:pages.adoc[Pages]
** xref:admin:participants.adoc[Participants]
** xref:admin:newsletters.adoc[Newsletters]
** Settings
** Admin activity log
** Templates
* xref:admin:spaces/processes.adoc[Participatory Processes]
* xref:admin:spaces/assemblies.adoc[Assemblies]
* xref:admin:spaces/initiatives.adoc[Initiatives]
* xref:admin:spaces/conferences.adoc[Conferences]
* xref:admin:global_moderations.adoc[Global moderations]
* xref:admin:pages.adoc[Pages]
* xref:admin:participants.adoc[Participants]
* xref:admin:features/social_features/newsletters.adoc[Newsletters]
* xref:admin:settings.adoc[Settings]
* Admin activity log
* xref:admin:templates.adoc[Templates]
10 changes: 5 additions & 5 deletions docs/en/modules/admin/pages/index.adoc
Original file line number Diff line number Diff line change
@@ -44,12 +44,12 @@ can configure the platform in a general way (images, information pages, etc.,) a

== Get started

* xref:admin:.adoc[Getting started]
* xref:admin:.adoc[Settings]
* xref:admin:first_steps.adoc[First steps]
* xref:admin:settings.adoc[Settings]
* xref:admin:pages.adoc[Pages and topics]
* xref:admin:participants.adoc[Participants]
* xref:admin:.adoc[Global moderation]
* xref:admin:global_moderations.adoc[Global moderations]
* xref:admin:spaces.adoc[Spaces]
* xref:admin:components.adoc[Components]
* xref:admin:.adoc[Features]
* xref:admin:.adoc[Templates]
* xref:admin:features.adoc[Features]
* xref:admin:templates.adoc[Templates]
3 changes: 3 additions & 0 deletions docs/en/modules/admin/pages/moderations/reported_content.adoc
Original file line number Diff line number Diff line change
@@ -26,6 +26,7 @@ After a participant has reported a content, it appears in two sections of the ad
image:moderations/moderations_backend_list_content.png[Global moderations panel for content]

There you'll find first all the unprocessed reports if there's any, with:

* *Id*: unique identifier of the reported content.
* *Type*: the kind of content reported, for instance comment, proposal, debate, etc.
* *Participatory Space*: which space this content belongs to.
@@ -40,6 +41,8 @@ Once you moderate a content, it appears in the "Hidden" contents list, accessibl

=== Actions

.Actions
[cols="10h,20h,~,~"]
|===
|Icon |Name |Definition |Condition

3 changes: 3 additions & 0 deletions docs/en/modules/admin/pages/moderations/reported_users.adoc
Original file line number Diff line number Diff line change
@@ -28,6 +28,7 @@ Reported participants are visible on the "Reported participants" section of the
image:moderations/moderations_backend_list_users.png[Global moderations panel for users]

You can find all the reported participants on the reported participant list in the administration panel, with:

* *Name*: name of the participant, with a link to their profile.
* *Nickname*: nickname of the participant, with a link to their profile.
* *Reason*: why the participant is reported. If the participant that made the report has given extra
@@ -38,6 +39,8 @@ information it's possible to see it by hovering it.

=== Actions

.Actions
[cols="10h,20h,~,~"]
|===
|Icon |Name |Definition |Condition

1 change: 1 addition & 0 deletions docs/en/modules/admin/pages/pages/pages.adoc
Original file line number Diff line number Diff line change
@@ -27,6 +27,7 @@ To create a new page, you need to click the "Create page" button.
image::pages/pages_backend_form.png[Backend: new page form]

.New page form
[cols="20h,10h,~"]
|===
|Field |Type |Description

2 changes: 1 addition & 1 deletion docs/en/modules/admin/pages/pages/topics.adoc
Original file line number Diff line number Diff line change
@@ -16,7 +16,7 @@ To create a new topic, click the "Create topic" button.
image::pages/pages_backend_topic_form.png[Backend: new topic form]

.New topic form

[cols="20h,10h,~"]
|===
|Field |Type |Description

8 changes: 6 additions & 2 deletions docs/en/modules/admin/pages/participants/admins.adoc
Original file line number Diff line number Diff line change
@@ -16,7 +16,7 @@
image:participants/admins_invite.png[Invite participant as administrator form]

.New administrator form

[cols="20h,10h,~"]
|===
|Field |Type |Description

@@ -26,7 +26,8 @@

|Email
|Required
|Email of the participant to invite. If they don't have an account related to this email, they should receive an invitation email to create an account. Otherwise, they won't be notified.
|Email of the participant to invite. If they don't have an account related to this email, they should receive an invitation
email to create an account. Otherwise, they won't be notified.

Check warning on line 30 in docs/en/modules/admin/pages/participants/admins.adoc

GitHub Actions / prose

[vale] reported by reviewdog 🐶 [Google.Passive] In general, use active voice instead of passive voice ('be notified'). Raw Output: {"message": "[Google.Passive] In general, use active voice instead of passive voice ('be notified').", "location": {"path": "docs/en/modules/admin/pages/participants/admins.adoc", "range": {"start": {"line": 30, "column": 51}}}, "severity": "INFO"}

|Role
|Required
@@ -39,6 +40,7 @@
== Manage administrators

You can find all the administrators on the administrators list in the administration panel, with:

* *Role*: type of administrator rights, can only be Administrator or Participant manager.
* *Name*: name of the participant.
* *Email*: email of the participant.
@@ -52,6 +54,8 @@

=== Actions

.Actions
[cols="10h,20h,~,~"]
|===
|Icon |Name |Definition |Condition

Original file line number Diff line number Diff line change
@@ -14,7 +14,7 @@ To enable an authorization, you need to have access to the xref:configure:system
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].

Participants can access, update, or delete their authorizations in their xref:admin:features/my_account/authorizations.adoc[account].
Participants can access, update, or delete their authorizations in their xref:admin:features/participant_actions/my_account.adoc[account].

== Verification methods

Original file line number Diff line number Diff line change
@@ -3,7 +3,7 @@
This authorization allows a participant to request for a verification code to be sent to an address, to confirm that they
live or work in this place. They then need to fill the received code in the platform.

NOTE: If you don't want to use this authorization, you should turn it off in the xref:admin:system.adoc[system panel].
NOTE: If you don't want to collect any data, you should turn it off in the xref:configure:system.adoc[System panel].

The process is:

Original file line number Diff line number Diff line change
@@ -4,7 +4,7 @@ This authorization allows a participant to upload its identity documents into th
These documents depend on the organization, they could be a driver's license, a passport, a national identity card,
a club membership card, etc.

NOTE: If you don't want to collect any data, you should turn it off in the xref:admin:system.adoc[system panel].
NOTE: If you don't want to collect any data, you should turn it off in the xref:configure:system.adoc[System panel].

These documents are reviewed by an administrator who can accept or reject them. It's possible to do this process
in two ways:
@@ -20,6 +20,7 @@ Click the "Config" button to configure the authorization.
image::participants/authorizations_id_document_configuration.png[ID document authorization configuration]

.ID Documents authorization configuration
[cols="20h,20h,~"]
|===
|Field |Type |Description

@@ -114,6 +115,7 @@ Then they need to fill some data provided by the participant and review the docu
image::participants/authorizations_id_document_offline_confirm.png[ID document authorization offline confirmation form in administration]

.ID Documents authorization offline form
[cols="20h,10h,~"]
|===
|Field |Type |Description

7 changes: 5 additions & 2 deletions docs/en/modules/admin/pages/participants/groups.adoc
Original file line number Diff line number Diff line change
@@ -8,14 +8,15 @@

== Enable / disable user groups

Administrators can enable or disable user groups in the xref:admin:configuration.adoc[Configuration] panel.
Administrators can enable or disable user groups in the xref:admin:settings/configuration.adoc[Configuration] panel.

Check warning on line 11 in docs/en/modules/admin/pages/participants/groups.adoc

GitHub Actions / prose

[vale] reported by reviewdog 🐶 [Google.WordList] Use 'turn off' or 'off' instead of 'disable'. Raw Output: {"message": "[Google.WordList] Use 'turn off' or 'off' instead of 'disable'.", "location": {"path": "docs/en/modules/admin/pages/participants/groups.adoc", "range": {"start": {"line": 11, "column": 30}}}, "severity": "WARNING"}

When enabled, participants are able to create and manage groups from their profile.
To learn more about how participants can do this, go to the xref:admin:features/my_public_profile.adoc[public profile] article.
To learn more about how participants can do this, go to the xref:admin:features/participant_actions/my_public_profile.adoc[public profile] article.

== Manage user groups

When a participant creates a user group, it adds a line in the user groups list in the administration panel, with:

* *Name*: name of the user group.
* *Nickame*: nickame of the user group.
* *Document number*: can be the identification number of the structure, like a company or association identification number.
@@ -37,6 +38,8 @@

=== Actions

.Actions
[cols="10h,20h,~,~"]
|===
|Icon |Name |Definition |Condition

3 changes: 3 additions & 0 deletions docs/en/modules/admin/pages/participants/impersonations.adoc
Original file line number Diff line number Diff line change
@@ -30,13 +30,16 @@ image::participants/participants_impersonations_backend_list_button.png[Administ
== Manage impersonations

You can find all the participants of the platform, with:

* *Name*: name of the participant.
* *Status*: if the participant is impersonated/managed or not.

You can filter this list by clicking the "Filter" button and search for participants by their name.

=== Actions

.Actions
[cols="10h,20h,~,~"]
|===
|Icon |Name |Definition |Condition

5 changes: 4 additions & 1 deletion docs/en/modules/admin/pages/participants/participants.adoc
Original file line number Diff line number Diff line change
@@ -13,6 +13,7 @@ image:participants/participants_participants.png[Participants list]
== Manage participants

You can find all the participants here, with:

* *Name*: name of the participant, with a link to their profile.
* *Nickname*: nickname of the participant, with a link to their profile.
* *Created at*: date of the participant account creation.
@@ -25,6 +26,8 @@ You can also search for participants by email, name, or nickname in the search b

=== Actions

.Actions
[cols="10h,20h,~,~"]
|===
|Icon |Name |Definition |Condition

@@ -79,7 +82,7 @@ image:participants/participants_showed_email_admin_log.png[Admin activity log fo

To contact participants directly through the private messaging of the platform, click the "Contact" icon.

image:participants/participants_conversation.png[Conversation with a participant].
image::participants/participants_conversation.png[Conversation with a participant]

=== Officialize

Loading