Merge pull request #175 from ds-wizard/release/4.13

Release 4.13.0 (develop)

docs/about/introduction/knowledge-model.rst

@@ -80,6 +80,7 @@ The value question asks for a single value that users type in. There are many di
 
 The input field differs based on the value type (simple input for string, date picker for date, etc.). Some of these have a check whether the entered value is valid (such as valid email or URL) and displays a warning if not.
 
+Value Question also can have validations. Validations differ based on the value type. For example, we can set a minimum and maximum value for a number, or a minimum and maximum length for a string. For text based types (text, email, URL), we can set also use a regular expression to create validations.
 
 .. _integration-question:
 
@@ -139,6 +140,12 @@ Choice
 
 A choice is used with :ref:`multi-choice questions<multi-choice-question>`. It only contains a **label** which is presented to the user.
 
+.. _validation:
+
+Validation
+----------
+
+Validation is used to define some rules for the answers in Value question type. It can be used to check if the answer is in the correct format, or if it is in the correct range. If the answer doesn't pass the validation, a warning is displayed to the user, however this does not prevent them from creating a document.
 
 .. _reference:
 

docs/application/document-templates/editors/detail/files.rst

@@ -5,7 +5,9 @@ The :guilabel:`Files` tab in :doc:`./index` allows us to manage the files and di
 
 If we select a text file in the file tree, it is opened in the built-in text editor. We can also open multiple files (the editor supports tabs). Moreover, if we have more files opened, we can see a *split view* icon on the top of the file tree. When we click it, it will split the view and move the opened file to the other group. If there are already two groups, it switches the file between the two groups. We can close the file by clicking cross icon in its tab.
 
-We can easily delete a file or a folder; when it is selected in the file tree, we can simply click the red trash icon above the file tree. The deletion must be confirmed in the prompt so we will not delete something by accident as it is not reversible operation.
+We can easily delete files; when it is selected in the file tree, we can simply click the red trash icon above the file tree. The deletion must be confirmed in the prompt so we will not delete something by accident as it is not reversible operation. To delete folder, we must first delete all files and folders in it. Then it disappears from the file tree.
+
+With files and folders we can also use move and rename functionalities, both by clicking their respective icons above the file tree. The move functionality is useful when we want to move a file to another folder. The rename functionality is useful when we want to change the name of a file or folder.
 
 If we make some changes in a file, the asterisk (or star) symbol will appear by the name in the tree view as well as in the tab (if opened). The changes must be then saved using :guilabel:`Save` button or discarded using :guilabel:`Discard` button in the top right corner. Those buttons will appear instead of :guilabel:`Publish` as it is not possible to publish a document template with unsaved changes. After saving the changes and switching to :doc:`./preview` (or refreshing it), the document will be re-generated using the newly changed document template.
 

docs/application/document-templates/list/detail.rst

@@ -5,7 +5,7 @@ We can check a document template detail by clicking on a desired template in the
 
 The main part of the detail is the README of the template that should contain basic information and changelog for the template. In the right panel under the basic information, we can navigate to other versions of the document template, navigate to the `DSW Registry <https://registry.ds-wizard.org>`__ (if the template is present there), or check compatible knowledge model with the template.
 
-In the top bar, we can :guilabel:`Export` the template as a ZIP package or :guilabel:`Delete` this version of the template (only if it is not already used for some documents). We can also quickly navigate to :doc:`../editors/create` by clicking :guilabel:`Create editor`; it will prepare editor creation for a new version of this document template. Finally, there is the possibility :guilabel:`Set deprecated` which will change the state of the document template so it is no longer usable by researchers in their projects (it becomes unavailable).
+In the top bar, we can :guilabel:`Export` the template as a ZIP package or :guilabel:`Delete` this version of the template (only if it is not already used for some documents). We can also quickly navigate to :doc:`../editors/create` by clicking :guilabel:`Create editor`; it will prepare editor creation for a new version of this document template. Finally, there is the possibility :guilabel:`Set deprecated` which will change the state of the document template so it is no longer usable by researchers in their projects (it becomes unavailable). This only applies to the latest version of the document template. If there is an older version, that will still be available.
 
 If we are not seeing the latest version of the template, a warning message is shown in the top. Similarly, we will see a notification that update is available if there is a newer version in the `DSW Registry <https://registry.ds-wizard.org>`__ (if configured).
 

docs/application/knowledge-models/editors/detail/knowledge-model.rst

@@ -45,6 +45,7 @@ There are different entities we can edit in the knowledge model, the editor show
 - :ref:`Question<question>`
 - :ref:`Answer<answer>`
 - :ref:`Choice<choice>`
+- :ref:`Validation<validation>`
 - :ref:`Expert<expert>`
 - :ref:`Metric<metric>`
 - :ref:`Phase<phase>`

docs/application/knowledge-models/list/index.rst

@@ -27,6 +27,11 @@ Finally, there is an option to :doc:`./import` by click the :guilabel:`Import` b
 
     List of all knowledge models with actions.
 
+
+.. NOTE::
+
+    Set deprecated option will apply only for the latest version of Knowledge Model. If there is an older version, that will still be available.
+
 .. raw:: html
 
     <h2>Table of Contents</h2>

docs/application/projects/list/detail/questionnaire.rst

@@ -113,7 +113,7 @@ Value Question
 
 Value question contains an input field for our answer. This can be a simple text field (such as asking for a project contributor's name), or some additional widget, for example a date picker.
 
-Some of the value types contains a validation (e.g., email or URL). We can still type in an invalid answer, but it will display a warning and also show it in the list of :ref:`warnings<warnings>`.
+All of value question types (except for color) can have validations set on them. We can still type in an invalid answer, but it will display a warning and also show it in the list of :ref:`warnings<warnings>`.
 
 .. figure:: questionnaire/value-question.png
 
@@ -147,27 +147,19 @@ Item Select Question
 
 The item selection question is used together with the list of items question. When creating an item selection question, you must choose one of the existing list of items questions. The answers provided to that list of items question are then offered as possible answers in the item selection question.
 
-.. TODO::
-
-    Add a screenshot of the item select question.
-
-.. .. figure:: questionnaire/item-select-question.png
+.. figure:: questionnaire/item-select-question.png
 
-..     Item select question with a list of items as possible answers.
+    Item select question with a list of items as possible answers.
 
 
 File Question
 -------------
 
 File question is used when we need to upload a file as an answer. We can simply click on the :guilabel:`Upload File` button and select the file from our computer. We can also drag and drop the file into the input field.
 
-.. TODO::
-
-    Add a screenshot of the file question.
-
-.. .. figure:: questionnaire/file-question.png
+.. figure:: questionnaire/file-question.png
 
-..     File select question with a list of items as possible answers.
+    File select question with a uploaded file.
 
 
 View settings
@@ -200,7 +192,7 @@ If there are some project importers available for the project, there is the :gui
 Warnings
 ========
 
-Some value questions (such as email or URL) validates the answer written there. If it is an invalid value, we will see :guilabel:`Warnings` tab in the questionnaire menu bar with a badge showing the number of warnings. If we click on it, we can see a list of all questions that has a warning and we can click on it to navigate quickly to that question.
+All of value question types (except for color) can have validations set on them. If it is an invalid value, we will see :guilabel:`Warnings` tab in the questionnaire menu bar with a badge showing the number of warnings. If we click on it, we can see a list of all questions that has a warning and we can click on it to navigate quickly to that question.
 
 .. figure:: questionnaire/warnings.png
     :width: 487

docs/conf.py

@@ -25,7 +25,7 @@
 project_name_full = 'Data Stewardship Wizard'
 
 # The full version, including alpha/beta/rc tags
-version = release = '4.12'
+version = release = '4.13'
 
 rst_prolog = f"""
 

docs/more/development/document-templates/document-context.rst

@@ -438,6 +438,7 @@ ValueQuestion
 '''''''''''''
 
 -  ``value_type`` (``str``) - type of value, use alias
+-  ``validations`` (``list[``\ :ref:`odc-value-question-validation`\ ``]``)
 
 Aliases:
 
@@ -446,6 +447,16 @@ Aliases:
 -  ``is_number`` (``bool``)
 -  ``is_date`` (``bool``)
 
+.. _odc-value-question-validation:
+
+ValueQuestionValidation
+"""""""""""""""""""""""
+
+-  ``type`` (``str``)
+-  ``full_type`` (``str``)
+-  ``value`` (``str | int | float | None``) - based on the ``type``
+
+
 .. _odc-integration-question:
 
 IntegrationQuestion