diff --git a/.github/styles/config/vocabularies/Decidim/accept.txt b/.github/styles/config/vocabularies/Decidim/accept.txt index ea4403751b..81496daa51 100644 --- a/.github/styles/config/vocabularies/Decidim/accept.txt +++ b/.github/styles/config/vocabularies/Decidim/accept.txt @@ -1 +1,2 @@ -Decidim \ No newline at end of file +Decidim +moderations \ No newline at end of file diff --git a/docs/en/modules/ROOT/nav.adoc b/docs/en/modules/ROOT/nav.adoc index bdbefbc405..03875ee2dd 100644 --- a/docs/en/modules/ROOT/nav.adoc +++ b/docs/en/modules/ROOT/nav.adoc @@ -31,6 +31,7 @@ *** xref:services:social_providers.adoc[Social Providers] * Admin +** xref:admin:first_steps.adoc[First steps in Decidim] ** Settings *** xref:admin:configuration.adoc[Configuration] *** xref:admin:appearance.adoc[Appearance] diff --git a/docs/en/modules/admin/assets/images/admin_dashboard.png b/docs/en/modules/admin/assets/images/admin_dashboard.png index c442f865ce..6b622ecc94 100644 Binary files a/docs/en/modules/admin/assets/images/admin_dashboard.png and b/docs/en/modules/admin/assets/images/admin_dashboard.png differ diff --git a/docs/en/modules/admin/assets/images/admin_dashboard_menu.png b/docs/en/modules/admin/assets/images/admin_dashboard_menu.png index ba46a2fda9..fae842cfdf 100644 Binary files a/docs/en/modules/admin/assets/images/admin_dashboard_menu.png and b/docs/en/modules/admin/assets/images/admin_dashboard_menu.png differ diff --git a/docs/en/modules/admin/assets/images/admin_tos_pending.png b/docs/en/modules/admin/assets/images/admin_tos_pending.png new file mode 100644 index 0000000000..f451db257c Binary files /dev/null and b/docs/en/modules/admin/assets/images/admin_tos_pending.png differ diff --git a/docs/en/modules/admin/assets/images/first_steps_account_creation.png b/docs/en/modules/admin/assets/images/first_steps_account_creation.png new file mode 100644 index 0000000000..513679a7cf Binary files /dev/null and b/docs/en/modules/admin/assets/images/first_steps_account_creation.png differ diff --git a/docs/en/modules/admin/assets/images/first_steps_invitation_email.png b/docs/en/modules/admin/assets/images/first_steps_invitation_email.png new file mode 100644 index 0000000000..0da7b1faf2 Binary files /dev/null and b/docs/en/modules/admin/assets/images/first_steps_invitation_email.png differ diff --git a/docs/en/modules/admin/pages/first_steps.adoc b/docs/en/modules/admin/pages/first_steps.adoc new file mode 100644 index 0000000000..e72b558af2 --- /dev/null +++ b/docs/en/modules/admin/pages/first_steps.adoc @@ -0,0 +1,71 @@ += First steps in Decidim + +== Log in for the first time + +Once you or your developers have successfully installed Decidim, and created an organization in the System panel, you should +receive an email asking you to complete your account creation. +If you didn't receive an invitation email, ask the person in charge of the system administration to add you as an administrator. + +image::first_steps_invitation_email.png[Administrator invitation email] + +The invitation email redirects you to a form so you can finish setting up your account with your nickname, name, and password. + +image::first_steps_account_creation.png[Administrator invitation email] + +== Discover the administration dashboard + +=== Access the administration dashboard + +After logging in, you can see the platform as a participant, but it's not where you can configure and manage the platform. +To access the administration dashboard, or administration panel, you can click in three different items: + +. The "Admin dashboard" button at the left of the administrator header only administrators can see. +. The "Edit" button at the right of the administrator header. +. The "Admin dashboard" button in the drop-down list available when you click your account avatar. + +image::admin_dashboard_menu.png[Decidim Admin Dashboard in user menu] + +The "Edit" button redirects to the administration of the space you're seeing in the participant panel, whereas the other two buttons +redirect to the administration dashboard. + +=== Administrators terms of service + +For your first time accessing to the administration of Decidim, you are asked to review the administration terms of service. +Click on the "I agree with this terms" button to be able to start configuring the platform. + +image::admin_tos_pending.png[Decidim Admin Dashboard in user menu] + +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]. + +=== Explanation of the dashboard + +Once you accepted the administrator terms of service, you can see the dashboard. +On a new instance, almost no data is displayed, but you can see how it looks like on an active instance: + +image::admin_dashboard.png[Decidim Admin Dashboard] + +You can see several sections on this page: + +. *Pending moderations*: highlights the number of pending moderations, reported users and contents combined. +. *Activity*: number of participants and admins that logged in the last month, last week and last day. +. *Metrics*: the graphics for the evolution of multiple components inside of Decidim: +. *Admin log*: last actions made by all the administrators in the platform. + +== Administration navigation + +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 \ No newline at end of file