From 560ba3a11a2236a378ac575b4e6b6e176afdf296 Mon Sep 17 00:00:00 2001 From: Thomas Georgios Giannos Date: Thu, 16 May 2024 17:03:20 +0300 Subject: [PATCH] More fixes on plans and descriptions docs --- .../descriptions/create-a-description.md | 27 ++++++++++++------- .../descriptions/edit-a-description.md | 15 ++++++----- .../application/descriptions/exports.md | 6 +++-- .../application/plans/create-a-plan.md | 12 ++++++--- .../application/plans/edit-a-plan.md | 6 +++-- .../application/plans/exports.md | 5 ++-- .../application/plans/imports.md | 3 ++- .../application/plans/invite-collaborators.md | 7 ++--- .../application/plans/versions.md | 5 +--- docs/src/css/custom.css | 11 ++++++++ 10 files changed, 64 insertions(+), 33 deletions(-) diff --git a/docs/docs/documentation/application/descriptions/create-a-description.md b/docs/docs/documentation/application/descriptions/create-a-description.md index 16a24a9b3..fc5baad49 100644 --- a/docs/docs/documentation/application/descriptions/create-a-description.md +++ b/docs/docs/documentation/application/descriptions/create-a-description.md @@ -6,23 +6,32 @@ description: Discover how to create a new description # Create a Description There are two ways to create descriptions: -- edit a plan by clicking `Add Description` in specific plan section that contains description templates field --img- plan editor in edit state -img- +- Edit a plan by clicking `Add Description` in a specific section.
*You can only add a description in sections that have a description template assigned*. -- click `Add Description` in `My Descriptions` or `Home` and select in which plan the description will be stored. If plan has more than one description templates fields, must select in which section. +![Plan editor in the edit state](https://fakeimg.pl/600x400) +*Plan editor* --img- my descriptions -img- -img- add description dialog -img- +- Click `Add Description` in the `My Descriptions` or the `Home` page and select in which plan the description will be stored. If the plan has more than one description templates assigned, you will have to also select a specific section. +![My descriptions](https://fakeimg.pl/600x400) +*My descriptions* -When creating a new description a pop up message appears in case you want to automatically obtain answers to certain answers (for more details check [Prefill a Description](/docs/documentation/application/descriptions/prefill-a-description)) or continue manually. +![Add description dialog](https://fakeimg.pl/600x400) +*Add description dialog* --img- prefill description pop up dialog -img- +When creating a new description, a pop up message appears in case you want to automatically obtain answers from external sources (for more details check [Prefill a Description](/docs/documentation/application/descriptions/prefill-a-description)) or continue manually. -In each case a Description Editor is provided to add information that describes management activities according to the selected template. If continue manually, must fill **Title** and **Template** of Description in Main Info for a temporary save. When select description template, shows up all the next steps of this. +![Prefill description pop up dialog](https://fakeimg.pl/600x400) +*Description prifilling popup dialog* --img- description editor -img- +In either case, a `Description Editor form` is provided to add information according to the selected template. If you selected to continue manually, you must fill the **Title** and the **Template** of your description in the `Main Info` section of the form. This information is required even for a temporary (`draft`) save. When you select a description template, you can then proceed to the next sections of the form. + +![Description editor](https://fakeimg.pl/600x400) +*Description editor* :::info -To finalize a description must answer all the required questions. If description is not valid for finalization yet, all unanswered required questions are marked to continue editing. + +To `finalize` a description, you must answer all the required questions. If the description is not valid for finalization yet, all unanswered required questions are marked red and you will have to continue editing. + ::: diff --git a/docs/docs/documentation/application/descriptions/edit-a-description.md b/docs/docs/documentation/application/descriptions/edit-a-description.md index 09cc5f8aa..858335920 100644 --- a/docs/docs/documentation/application/descriptions/edit-a-description.md +++ b/docs/docs/documentation/application/descriptions/edit-a-description.md @@ -7,14 +7,17 @@ description: Discover how to edit a description There are several ways to edit an existing description: -- either from `Home Page` or from `My Descriptions`. By selecting the description you can view the overview and all actions for this. +- From the `Home Page` or from the `My Descriptions` page. By selecting a description, you can view the overview and all the available actions for it. --img- description overview -img- +![Description overview](https://fakeimg.pl/600x400) +*Description overview* -- view the `Plan Overview` that contains descriptions and select on of them. +- View the `Plan Overview` page of a plan that contains descriptions, and select one of them. --img- plan overview -img- +![Plan overview](https://fakeimg.pl/600x400) +*Plan overview* -- edit a plan that contains descriptions and select on of them. +- Edit a plan that contains descriptions and select one of them. --img- plan editor in edit state -img- \ No newline at end of file +![Plan editor in the edit state](https://fakeimg.pl/600x400) +*Plan editor* \ No newline at end of file diff --git a/docs/docs/documentation/application/descriptions/exports.md b/docs/docs/documentation/application/descriptions/exports.md index 15c9bfb6b..c0a029b8b 100644 --- a/docs/docs/documentation/application/descriptions/exports.md +++ b/docs/docs/documentation/application/descriptions/exports.md @@ -4,14 +4,16 @@ description: Discover export options for a description --- # Exports --img- export plan-img- -Application supports download the structure of the description in the following formats: +You can export the structure of a description in the following formats: - **PDF** - **DOCX** - **RDA JSON** - **XML** +![Export descriptions](https://fakeimg.pl/600x400) +*Export descriptions* + :::tip - You can use the export feature in anytime in description' lifecycle diff --git a/docs/docs/documentation/application/plans/create-a-plan.md b/docs/docs/documentation/application/plans/create-a-plan.md index e3c07725a..2b3694cfb 100644 --- a/docs/docs/documentation/application/plans/create-a-plan.md +++ b/docs/docs/documentation/application/plans/create-a-plan.md @@ -5,17 +5,21 @@ description: Discover how to create a new plan # Create a Plan --img- start a new plan -img- +To create a new Plan in OpenCDMP you can either [import](/docs/documentation/application/plans/imports) an existing plan from a file or fill in a Plan from the start. -To create a new Plan in OpenCDMP you can either [import](/docs/documentation/application/plans/imports) an existing plan from a file or fill in a Plan from the start. +![New plan popup dialog](https://fakeimg.pl/600x400) +*New plan popup dialog* To do this, there is a form available where you must fill a **Title**, a **Description** and select the **[Blueprint](/docs/documentation/administration/blueprints/)** of this plan that describes its structure. Also, there is a Default Plan Blueprint for use. When ready, after you press `save`, the plan is automatically saved having the `draft` status. More information about the lifecycle of a plan, can be found [here](/docs/documentation/application/plans/plan-lifecycle). --img- plan editor first step -img- +![Plan editor first step](https://fakeimg.pl/600x400) +*Plan editor (first section)* :::note There is a progression bar percentage that counts the completed required fields. To finalize a plan you must fill all the required fields. ::: --img- plan editor in new state -img- + +![Plan editor sidebar](https://fakeimg.pl/600x400) +*Plan editor progress bar* diff --git a/docs/docs/documentation/application/plans/edit-a-plan.md b/docs/docs/documentation/application/plans/edit-a-plan.md index d43b73dd9..a5dbdccb0 100644 --- a/docs/docs/documentation/application/plans/edit-a-plan.md +++ b/docs/docs/documentation/application/plans/edit-a-plan.md @@ -7,8 +7,10 @@ description: Discover how to edit a plan You can view a plan either from `Home Page` or from `My Plans`. By selecting the plan you can view the overview and all the actions available for it. --img- plan overview -img- +![Plan overview](https://fakeimg.pl/600x400) +*Plan overview* While in the edit view, you can make and revert changes but also add descriptions to specific sections that contain description template fields. --img- plan editor in edit state -img- \ No newline at end of file +![Plan editor](https://fakeimg.pl/600x400) +*Plan editor* \ No newline at end of file diff --git a/docs/docs/documentation/application/plans/exports.md b/docs/docs/documentation/application/plans/exports.md index 6ba7f9926..0de07750a 100644 --- a/docs/docs/documentation/application/plans/exports.md +++ b/docs/docs/documentation/application/plans/exports.md @@ -5,14 +5,15 @@ description: Discover export options for a plan # Exports --img- export plan-img- - You can export the structure of a plan in the following formats: - **PDF** - **DOCX** - **RDA JSON** - **XML** +![Export plans](https://fakeimg.pl/600x400) +*Export plans* + :::tip - You can use the export feature anytime in a plans' lifecycle diff --git a/docs/docs/documentation/application/plans/imports.md b/docs/docs/documentation/application/plans/imports.md index 8642a33f0..91058cdaf 100644 --- a/docs/docs/documentation/application/plans/imports.md +++ b/docs/docs/documentation/application/plans/imports.md @@ -7,4 +7,5 @@ description: Discover import options for a plan You can import an existing plan so that you don't have to work on a new one from scratch. Import supports the upload of `.json` files that are produced according to [RDA specifications](https://github.com/RDA-DMP-Common/RDA-DMP-Common-Standard) for machine-actionable plans. --img- import plan pop up dialog -img- +![Import plan popup dialog](https://fakeimg.pl/600x400) +*Import plan popup dialog* diff --git a/docs/docs/documentation/application/plans/invite-collaborators.md b/docs/docs/documentation/application/plans/invite-collaborators.md index 8d2354a82..ce59e028f 100644 --- a/docs/docs/documentation/application/plans/invite-collaborators.md +++ b/docs/docs/documentation/application/plans/invite-collaborators.md @@ -5,19 +5,20 @@ description: Discover how you invite people to a plan # Invite collaborators --img- invite users -img- - Before finalization, the plan can be further edited by inviting users in order to collaborate on it and complete it. There are two methods to invite users: + - **External**: If the user is registered in the application, then a notification (email or in App) gets sent to him. If not, a registration email is being sent instead. - **Internal**: It's a quick way, that we can invite users already associated to other plans we work with as well. +![Invite users](https://fakeimg.pl/600x400) +*Invite users* + For each member, a role on the plan must be defined. There are three different roles: - **Owner**: Manage and edit all plan features. - **Description Contributor**: Edit only the descriptions of this plan. - **Reviewer**: View the plan without being able to edit it. - :::note The collaboration roles we discussed above, can be applied to an entire plan or only to a specific section of it. diff --git a/docs/docs/documentation/application/plans/versions.md b/docs/docs/documentation/application/plans/versions.md index c6a37ea12..03a5c5ad9 100644 --- a/docs/docs/documentation/application/plans/versions.md +++ b/docs/docs/documentation/application/plans/versions.md @@ -13,7 +13,4 @@ If the plan is finalized you can create a new version for it, which will have al ::: -The `New Version` option cab be found in the `My Plans` or `Plan Overview` pages. In the new version form, the user can change titles, descriptions, plan blueprints and optionally select which descriptions to include in the new version. After the process is completed, the new plan and descriptions are available for editing. - --img- new version overview -img- --img- new version listing -img- \ No newline at end of file +The `New Version` option can be found in the `My Plans` or `Plan Overview` pages. In the new version form, the user can change titles, descriptions, plan blueprints and optionally select which descriptions to include in the new version. After the process is completed, the new plan and descriptions are available for editing. \ No newline at end of file diff --git a/docs/src/css/custom.css b/docs/src/css/custom.css index 4ccccfa1d..bad40e964 100644 --- a/docs/src/css/custom.css +++ b/docs/src/css/custom.css @@ -33,6 +33,17 @@ p { text-align: justify; } +article img { + display: block; + margin-left: auto; + margin-right: auto; +} + +article img + em { + display: block; + text-align: center; +} + .outer-tab { margin-left: 1rem; }