From e5a6dee348c6645c55ef9ae80af949bef68a74c9 Mon Sep 17 00:00:00 2001 From: Thomas Georgios Giannos Date: Fri, 3 May 2024 15:13:53 +0300 Subject: [PATCH] Added docs for descryption templates, improved docs structure on some cases --- .../administration/blueprints/index.md | 6 +- .../documentation/administration/languages.md | 2 + .../administration/notification-templates.md | 2 + .../administration/reference-types.md | 2 + .../administration/supportive-material.md | 4 + .../administration/template-types.md | 1 + .../administration/templates/index.md | 165 +++++++++++++++++- 7 files changed, 179 insertions(+), 3 deletions(-) diff --git a/docs/docs/documentation/administration/blueprints/index.md b/docs/docs/documentation/administration/blueprints/index.md index 2795b8b6b..6451d02bd 100644 --- a/docs/docs/documentation/administration/blueprints/index.md +++ b/docs/docs/documentation/administration/blueprints/index.md @@ -1,3 +1,5 @@ +import DocCardList from '@theme/DocCardList'; + # Blueprints In this page, there is a listing where you can view details about all the available plan blueprints. @@ -52,6 +54,8 @@ In order for the filters to apply, you have to click the `Apply filters` button. You can also clear any filters already applied, by pressing the `clear all filters` option, located at the top of the popup. +--- + ## Edit form When you try to add new dmp blueprints or edit existing ones, the **dmp blueprint editing form** will appear containing the following controls. @@ -114,6 +118,6 @@ Let's clarify a little bit more about our description multiplicity options. Ther We will explore this in detail in the [Prefilling Configurations](/docs/documentation/administration/blueprints/prefilling-configurations) section. -import DocCardList from '@theme/DocCardList'; +---
\ No newline at end of file diff --git a/docs/docs/documentation/administration/languages.md b/docs/docs/documentation/administration/languages.md index 0652e7823..006fcc104 100644 --- a/docs/docs/documentation/administration/languages.md +++ b/docs/docs/documentation/administration/languages.md @@ -43,6 +43,8 @@ In order for the filters to apply, you have to click the `Apply filters` button. You can also clear any filters already applied, by pressing the `clear all filters` option, located at the top of the popup. +--- + ## Edit form When you try to add new languages or edit existing ones, the **language editing form** will appear containing the following controls: diff --git a/docs/docs/documentation/administration/notification-templates.md b/docs/docs/documentation/administration/notification-templates.md index ea75da65b..003070492 100644 --- a/docs/docs/documentation/administration/notification-templates.md +++ b/docs/docs/documentation/administration/notification-templates.md @@ -50,6 +50,8 @@ In order for the filters to apply, you have to click the `Apply filters` button. You can also clear any filters already applied, by pressing the `clear all filters` option, located at the top of the popup. +--- + ## Edit form When you try to add new notification templates or edit existing ones, the **notification template editing form** will appear containing the following sections. diff --git a/docs/docs/documentation/administration/reference-types.md b/docs/docs/documentation/administration/reference-types.md index 774de241e..543e06f5a 100644 --- a/docs/docs/documentation/administration/reference-types.md +++ b/docs/docs/documentation/administration/reference-types.md @@ -47,6 +47,8 @@ In order for the filters to apply, you have to click the `Apply filters` button. You can also clear any filters already applied, by pressing the `clear all filters` option, located at the top of the popup. +--- + ## Edit form When you try to add new reference types or edit existing ones, the **reference type editing form** will appear containing the following sections. diff --git a/docs/docs/documentation/administration/supportive-material.md b/docs/docs/documentation/administration/supportive-material.md index 6dbe731b9..0bbf5dd04 100644 --- a/docs/docs/documentation/administration/supportive-material.md +++ b/docs/docs/documentation/administration/supportive-material.md @@ -32,6 +32,10 @@ Let's explore all the available supportive material types: - **Terms Of Service** - **User Guide**: A small guide available to the users directly on the platform +--- + +## End notes + :::note All the above are available for the users to read, following the links situated at the bottom part of the side navigation, visible on every page. diff --git a/docs/docs/documentation/administration/template-types.md b/docs/docs/documentation/administration/template-types.md index 172632aa6..0f7c548a4 100644 --- a/docs/docs/documentation/administration/template-types.md +++ b/docs/docs/documentation/administration/template-types.md @@ -1,5 +1,6 @@ --- sidebar_position: 3 +description: Manage all description template types --- # Template Types \ No newline at end of file diff --git a/docs/docs/documentation/administration/templates/index.md b/docs/docs/documentation/administration/templates/index.md index d69a60ead..90f282515 100644 --- a/docs/docs/documentation/administration/templates/index.md +++ b/docs/docs/documentation/administration/templates/index.md @@ -1,5 +1,166 @@ -# Templates - +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; import DocCardList from '@theme/DocCardList'; +# Templates + +In this page, there is a listing where you can view details about all the available description templates. + +:::info + +**Description Templates** describe how a [Description](/docs/category/descriptions) is structured. All the chapters and fields a Description is consisting of, are referenced here. More details will follow in the next sections. + +::: + +The information displayed by default is: the `display name` of the templates, the `status`, the `version` and timestamps for the `creation` and `updates` of the records. At the top right corner of the listing you can also select which columns to display. + +:::tip + +For description templates, all the columns are visible by default. + +::: + +You can create new templates by clicking to the `+ Create Description Template` button at the top right of the page. You can otherwise import one if you have it in **XML** file format by clicking the `Import` button, upload the file and provide a name for your template in the popup form. + +There are also many more actions available for description templates. When you clink on the three dots at the last column of a template, you can perform one of the following actions: + +- **Edit** +- **New Version**: Create a new version of this template. +- **Clone** +- **All Description Template Versions**: View all the versions of this template.
*In the listing, only the last versions of templates are displayed, by default.* +- **Download XML**: Download the structure of the template in XML format. +- **Delete** + +## Authorization + +Only users that have the **Admin** role can access this page. + +## Navigation + +This view is available when the user presses the `Description Templates` link from the side navigation menu. + +## Pagination + +Not all the records are being displayed at once. By default, there is a pagination of 10 records applied to them. + +You can control how many records are being displayed at any time, by adjusting the `items per page` control at the bottom left corner of the table. + +## Filtering + +There is a filtering option available for plan blueprints. + +- **Is Active**: By toggling this control you can view only the active or only the disabled templates.
*By default, this option is set to true.* +- **Status**: Filter templates by their status. The status can either be `Draft` or `Finalized`.
*By default, no status is selected.* + +In order for the filters to apply, you have to click the `Apply filters` button. + +You can also clear any filters already applied, by pressing the `clear all filters` option, located at the top of the popup. + +--- + +## Edit form + +When you try to add new description templates or edit existing ones, the **description template editing form** will appear containing the following controls. + +- **Description template name** +- **Description** +- **Descryption template type**: There are two template types by default. `Dataset` and `Software`. There is more information available at the [Description template types](/docs/documentation/administration/template-types) section. +- **Description template language** +- **Editors**: The users that own this template. You can add new owners on the template by using the `Editors` dropdown below the Editors listing. You can also remove existing owners by clicking the `Remove Editor` icon on the last column. + +You can add one or more **chapters** to the template by clicking the `Form Description` tab that navigates to the second part of the form. Then you can add the first chapter by clicking the `+ Create the first chapter` button. + +For every chapter you add, a new form part appears where you can specify everything about that chapter. It is also added to the template navigation sidebar on the left side of the form. + +### Description outline form + +For a chapter you can specify: + +- **Chapter Name** + +You can add one or more **sections** to the form by clicking the `Create section` button. For every section you add, a new form part appears where we can specify everything about that section. + +### Section form + +For a section you can specify: + +- **Section Name** +- **Section Description**: A short description for the section.
*This is optional.* + +You can add one or more questions to a form section by clicking the `Add Question` button found both on the sidebar and the form when you hover over it (*It appears below it*). + +### Question form + +For a question you can specify: + +- **Title**: The question title +- **Description**: A description for the question which will be displayed below the title. +- **Type**: Here, you can select the ui element that will appear to the form for the user to answer this question if it is custom, or the system [data source](/docs/documentation/administration/reference-types) that will be used. +- **Semantics**: You can view more information [here](/docs/documentation/administration/blueprints/semantics). +- **Default Value**: If you set this, it will be the default answer for this question. +- **Input Placeholder Text**: Text that will appear to the input if it is empty. Only applicable if no default value is set. +- **Required**: If set to true, the answer will be mandatory. + +:::info + +Inputs that are custom, meaning they are not system specific, can be conditionally added to the form. More information on how to configure this is available in the [conditional questions](/docs/documentation/administration/templates/conditional-questions) page of this section. + +::: + +At the bottom of the form, there are more options available for our question. + +- **Comment field**: Give the user the option to leave comments about his answer. +- **Multiplicity**: Make multiple answers for this question possible. If set to true, four more controls appear. + - **Minimum**: The minimum amount of answers. + - **Maximum**: The maximum amount of answers. + - **Multiplicity Placeholder Text** + - **View inputs in table**: If set to true, all the given answers will also be displayed to the form in a table. + +You can add more inputs to the questions by clicking the `Add input` button. For each input you add, you can specify the `type`, the `semantics` and the `default value` as we saw previously. There are more options available for inputs based on the type selected. We will explore our options in the next section. + +If you click on the three dots at the bottom right corner of the question form, you can specify the following. + +- **Description**: There is already a description section included by default. Here, you can select to ommit it. +- **Extended Description**: This is useful if you want to hide part of the description. If set, a `View more` link will appear below the main description so that the user can reveal the extended description. +- **Additional Information**: If set, a bubble tooltip will be available next to the question title. This is intended to give some short useful tips to the user. + +### Input form + +Some input types require extra configurations. + + + + - **Max File Size**: It is required to limit the size of the files uploaded by the user. + - **File types**: You can force the upload of specific file types. + - **Other file types**: If the file type is not available in the dropdown, you can add your own by pressing the `+` icon and giving a name and the specific MIME type you want. + + + You can add one or more options for the users to select, by pressing the `+` button on the `Radio Box Data` section. + + - **Label**: The label of the option. + - **Value**: The actual input value. + + + You can add one or more options for the users to select, by pressing the `+` button on the `Word List Data` section. + + - **Label**: The label of the option. + - **Value**: The actual input value. + - **Multiple Selection**: When set to true, the user can select more than one options. + + + - **Reference Type**: You can learn more on the [reference types](/docs/documentation/administration/reference-types) section. + - **Multiple Selection**: When set to true, the user can select more than one options. + + + +## End notes + +:::tip + +For every question you configure, you can view a live preview on how it will look on the form. + +::: + +--- + \ No newline at end of file