Feat: Update review-workflows documentation to include multipe workflows (#1784)

Author: gu-stav

docusaurus/docs/user-docs/settings/review-workflows.md

@@ -9,45 +9,76 @@ description: Managing your review workflows and stages in Strapi.
 Review Workflows is an <EnterpriseBadge />-only feature.
 :::
 
-The Review Workflows feature allows you to create and manage any desired review stages for your content, enabling your team to collaborate in the content creation flow from draft to publication. Before being available in the [Content Manager](/user-docs/content-manager/reviewing-content) and [Content-Types Builder](/user-docs/content-type-builder), review workflows should be configured from ![Settings icon](/img/assets/icons/settings.svg) *Settings > Global settings > Review Workflows*.
+The Review Workflows feature allows you to create and manage workflows for your various content-types. Each workflow can consist of any review stages for your content, enabling your team to collaborate in the content creation flow from draft to publication.
 
-:::note
-- The Review workflows settings are only available to users with the Super Admin role by default. Other roles must be granted the **Review workflows** permission. See [Users, Roles, & Permissions](/user-docs/users-roles-permissions) for more information.
-- Review Workflows are only available with the Enterprise Edition. If for any reason your project was downgraded to the Community Edition, all review workflows data would not be deleted but kept until the project goes back to Enterprise.
-:::
+<ThemedImage
+  alt="Workflow list view"
+  sources={{
+    light: '/img/assets/review-workflows/list-view-light.png',
+    dark: '/img/assets/review-workflows/list-view-dark.png',
+  }}
+/>
+
+In many organizations different teams review different parts of content. By using different review workflows for different content-types, it is possible to adjust each workflow to the needs of each team involved.
+
+The default workflow is configured to have 4 stages: To do, In progress, Ready to review, and Reviewed. All 4 stages can be edited, reordered or deleted as needed, and it is also possible to add new stages.
+
+Before being available in the [Content Manager](/user-docs/content-manager/reviewing-content), review workflows must be configured from ![Settings icon](/img/assets/icons/settings.svg) *Settings > Global settings > Review Workflows*. The Review workflows settings are only available to users with the Super Admin role by default. Other roles must be granted the **Review workflows** permissions. See [Users, Roles, & Permissions](/user-docs/users-roles-permissions) for more information.
+
+
+## Creating or editing a workflow
 
 <ThemedImage
-  alt="Review Workflows Settings"
+  alt="Workflow edit view"
   sources={{
-    light: '/img/assets/review-workflows/review-workflows.png',
-    dark: '/img/assets/review-workflows/review-workflows_DARK.png',
+    light: '/img/assets/review-workflows/edit-view-light.png',
+    dark: '/img/assets/review-workflows/edit-view-dark.png',
   }}
 />
 
-There are 4 stages in the default review workflow available in Strapi: To do, In progress, Ready to review, and Reviewed. All 4 stages can be edited, reordered or deleted as needed, and it is also possible to add new stages.
+1. Click on the **Create new workflow** button or on the edit button ![Edit icon](/img/assets/icons/edit.svg) of a workflow.
+2. In the workflow edit interface, configure the new workflow:
 
-## Adding a new stage
+    | Setting name   | Instructions                                                             |
+    | -------------- | ------------------------------------------------------------------------ |
+    | Name           | Write a unique name of workflow.                                         |
+    | Content-Types  | (optional) Assign this workflow to one or more existing content-types.   |
+    | Stages         | Add review stages (see [Adding a new stage](#adding-a-new-stage)). |
+
+3. Click on the **Save** button. The new workflow will be displayed in the list-view and for every content-type assigned.
+
+:::note
+The maximum number of [workflows and stages per workflow is limited](https://strapi.io/pricing-cloud).
+:::
+
+
+### Adding a new stage
 
 To add a new stage in the review workflows:
 
 1. Click on the **Add new stage** button.
 2. Write the *Stage name*.
-3. Select a *Color*
+3. Select a *Color*.
 3. Click on the **Save** button.
 
-:::tip
 By default new stages are appended, but they can be reordered anytime using the ![drag & drop](/img/assets/icons/drag.svg) button.
-:::
 
-## Deleting a stage
 
-:::warning Pending reviews on deleted stages
-If you delete a stage that has pending reviews, the reviews will be moved to first stage in the workflow.
-:::
-
-To delete a stage from the review workflows:
+### Deleting a stage
 
 1. Click on the ![delete button](/img/assets/icons/delete.svg) **Delete** button next to the stage you want to remove.
 2. Click on the **Save** button: a confirmation modal will appear to confirm the deletion.
 
+If you delete a stage that has pending reviews, the reviews will be moved to first stage in the workflow. Every workflow needs to
+contain at least one stage and therefore it is not possible to delete the last stage.
+
+
+## Deleting a workflow
+
+To delete a workflow click on the delete button ![Delete icon](/img/assets/icons/delete.svg) of a workflow in the list view.
+
+:::note
+It is not possible to delete the last workflow.
+:::
+
 <FeedbackPlaceholder />

docusaurus/docs/user-docs/users-roles-permissions/configuring-administrator-roles.md

@@ -139,7 +139,7 @@ Settings permissions can be configured for all settings accessible from *General
 | Plugins and Marketplace | <ul><li>Marketplace</li><ul><li>"Access the Marketplace" - gives access to the Marketplace</li></ul></ul><ul><li>Plugins</li><ul><li>"Install (only for dev env)" - allows to install new plugins when in a development environment</li><li>"Uninstall (only for dev env)" - allows to uninstall plugins when in a development environment</li></ul></ul> |
 | Webhooks | <ul><li>General</li><ul><li>"Create" - allows to create webhooks</li><li>"Read" - allows to see created webhooks</li><li>"Update" - allows to edit webhooks</li><li>"Delete" - allows to delete webhooks</li></ul></ul> 👉 Path reminder to Webhook settings: <br /> *General > Settings > Global Settings - Webhook* |
 | Users and Roles | <ul><li>Users</li><ul><li>"Create (invite)" - allows to create administrator accounts</li><li>"Read" - allows to see existing administrator accounts</li><li>"Update" - allows to edit administrator accounts</li><li>"Delete" - allows to delete administrator accounts</li></ul></ul><ul><li>Roles</li><ul><li>"Create" - allows to create administrator roles</li><li>"Read" - allows to see created administrator roles</li><li>"Update" - allows to edit administrator roles</li><li>"Delete" - allows to delete administrator roles</li></ul></ul> 👉 Path reminder to the RBAC feature: <br /> *General > Settings > Administration Panel* |
-| Review Workflows <EnterpriseBadge /> | <ul><li>General</li><ul><li>"Access the Review workflows settings page"</li></ul></ul> 👉 Path reminder to Review workflows settings: <br /> *General > Settings > Global Settings - Review workflows* |
+| Review Workflows <EnterpriseBadge /> | <ul><li>"Create" - allows to create workflows</li><li>"Read" - allows to see created workflows</li><li>"Update" - allows to edit workflows</li><li>"Delete" - allows to delete workflows</li></ul> 👉 Path reminder to Review workflows settings: <br /> *General > Settings > Global Settings - Review workflows* |
 
 </TabItem>