Skip to content
New issue

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

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

Already on GitHub? Sign in to your account

General fixes #185

Draft
wants to merge 7 commits into
base: develop
Choose a base branch
from
Draft
Show file tree
Hide file tree
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
6 changes: 5 additions & 1 deletion .github/styles/config/vocabularies/Decidim/accept.txt
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,19 @@ Config
CSV
[Dd]ecidim
[Ee]mail
Etherpad
[Ff]aq
[Ff]avicon
[Gg]amification
initializer
Gemfile
[Ii]nitializer
Javascript
[Kk]akogawa
Keka
Mautic
[Mm]oderations
[Nn]ickame
OAuth
[Oo]fficialization
[Oo]fficializing
[Oo]fficialize
Expand Down
6 changes: 4 additions & 2 deletions docs/en/modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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]
Expand Down Expand Up @@ -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]
Expand Down Expand Up @@ -196,7 +198,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]
Expand Down Expand Up @@ -236,7 +238,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]
Expand Down
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
Expand Up @@ -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

View workflow job for this annotation

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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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]

Expand All @@ -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
Expand Up @@ -19,6 +19,8 @@ image::features/comments/form.png[Comments form]

When commenting, participants can:

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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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

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

=== Actions

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

Expand Down
24 changes: 12 additions & 12 deletions docs/en/modules/admin/pages/first_steps.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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

View workflow job for this annotation

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

Expand All @@ -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
Expand Up @@ -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
Expand Up @@ -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.
Expand All @@ -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

Expand Down
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
Expand Up @@ -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
Expand All @@ -38,6 +39,8 @@ information it's possible to see it by hovering it.

=== Actions

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

Expand Down
1 change: 1 addition & 0 deletions docs/en/modules/admin/pages/pages/pages.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
2 changes: 1 addition & 1 deletion docs/en/modules/admin/pages/pages/topics.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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

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

.New administrator form

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

Expand All @@ -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

View workflow job for this annotation

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
Expand All @@ -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.
Expand All @@ -52,6 +54,8 @@

=== Actions

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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand All @@ -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

Expand Down Expand Up @@ -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

Expand Down
7 changes: 5 additions & 2 deletions docs/en/modules/admin/pages/participants/groups.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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

View workflow job for this annotation

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.
Expand All @@ -37,6 +38,8 @@

=== Actions

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

Expand Down
3 changes: 3 additions & 0 deletions docs/en/modules/admin/pages/participants/impersonations.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
5 changes: 4 additions & 1 deletion docs/en/modules/admin/pages/participants/participants.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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

Expand Down Expand Up @@ -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

Expand Down
Loading