Merge branch 'develop' into feature/admin

.github/styles/config/vocabularies/Decidim/accept.txt

@@ -1 +1,2 @@
-Decidim 
+Decidim 
+moderations

docs/en/modules/ROOT/nav.adoc

@@ -24,17 +24,14 @@
 ** xref:services:index.adoc[Services]
 *** xref:services:activejob.adoc[Active Job]
 *** xref:services:activestorage.adoc[Active Storage]
-*** xref:services:elections_bulletin_board.adoc[Elections Bulletin Board]
 *** xref:services:etherpad.adoc[Etherpad]
 *** xref:services:maps.adoc[Maps]
 *** xref:services:sms.adoc[SMS]
 *** xref:services:smtp.adoc[SMTP]
 *** xref:services:social_providers.adoc[Social Providers]
 
 * xref:admin:index.adoc[Admin]
-** xref:admin:index.adoc[Introduction]
-*** xref:admin:system.adoc[System panel]
-*** xref:admin:dashboard.adoc[Dashboard]
+** xref:admin:first_steps.adoc[First steps in Decidim]
 ** Settings
 *** xref:admin:configuration.adoc[Configuration]
 *** xref:admin:appearance.adoc[Appearance]
@@ -110,11 +107,9 @@
 *** xref:admin:features/badges.adoc[Badges]
 *** xref:admin:features/comments.adoc[Comments]
 *** xref:admin:features/conversations.adoc[Conversations]
-*** xref:admin:features/embed.adoc[Embed]
 *** xref:admin:features/endorsements.adoc[Endorsements]
 *** xref:admin:features/fingerprint.adoc[Fingerprint]
 *** xref:admin:features/follows.adoc[Follows]
-*** xref:admin:features/metrics.adoc[Metrics]
 *** xref:admin:features/my_account.adoc[My account]
 **** xref:admin:features/my_account/account.adoc[Account]
 **** xref:admin:features/my_account/notifications_settings.adoc[Notifications settings]
@@ -137,8 +132,6 @@
 *** 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]
@@ -184,7 +177,7 @@
 *** xref:develop:fixing_locales.adoc[Fixing locales]
 *** xref:develop:maps.adoc[Maps]
 *** xref:develop:managing_translations_i18n.adoc[i18n]
-*** xref:develop:maintainers/index.adoc[Maintainers]
+*** Maintainers
 **** xref:develop:backports.adoc[Backports]
 **** xref:develop:guide_github_projects.adoc[GitHub Projects Workflow]
 **** xref:develop:maintainers/releases.adoc[Releasing new versionss]

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