diff --git a/.github/workflows/sphinx.yml b/.github/workflows/sphinx.yml
index 79d1818d..a7d456cc 100644
--- a/.github/workflows/sphinx.yml
+++ b/.github/workflows/sphinx.yml
@@ -17,7 +17,7 @@ jobs:
steps:
- name: Check out repository
- uses: actions/checkout@v5
+ uses: actions/checkout@v6
- name: Set up Python
uses: actions/setup-python@v6
diff --git a/docs/about/introduction/knowledge-model/knowledge-model-schema.png b/docs/about/introduction/knowledge-model/knowledge-model-schema.png
index 1c90ea0a..a41c1ee6 100644
Binary files a/docs/about/introduction/knowledge-model/knowledge-model-schema.png and b/docs/about/introduction/knowledge-model/knowledge-model-schema.png differ
diff --git a/docs/applications/admin-center/profile/about.rst b/docs/applications/admin-center/profile/about.rst
index dd53504d..82feb0b3 100644
--- a/docs/applications/admin-center/profile/about.rst
+++ b/docs/applications/admin-center/profile/about.rst
@@ -3,11 +3,11 @@
About
*****
-By selecting the :guilabel:`About` option from the :doc:`./index` menu, users are directed to the About page. This page offers detailed information about the current versions and build timestamps of the tool's components. This level of transparency helps ensure that both users and developers are fully informed about the specific versions and build statuses of the components they are working with.
+By selecting the :guilabel:`About` option from the :doc:`./index` menu, users are directed to the About page. This page offers detailed information about the current versions and build timestamps of the tool's components. It also includes information about metamodels together with Project Importers and Project Actions count. This level of transparency helps ensure that both users and developers are fully informed about the specific versions and build statuses of the components they are working with.
The :guilabel:`API URL` link provides access to the server's API endpoints, which can be used for integrating the Data Stewardship Wizard with other systems and automating tasks.
-The :guilabel:`API Documentation` link directs to the API documentation presented in Swagger UI that provides detailed descriptions of available operations and parameters.
+The :guilabel:`API Docs` link directs to the API documentation presented in Swagger UI that provides detailed descriptions of available operations and parameters.
.. figure:: about/modal.png
:width: 500
diff --git a/docs/applications/admin-center/settings/authentication/openid.rst b/docs/applications/admin-center/settings/authentication/openid.rst
index f2c449ae..b17b030f 100644
--- a/docs/applications/admin-center/settings/authentication/openid.rst
+++ b/docs/applications/admin-center/settings/authentication/openid.rst
@@ -1,25 +1,61 @@
Open ID Settings
****************
-Using these settings we can add `Open ID `__ configuration to allow logging into the |project_name| instance via external identity provider. First, press :guilabel:`Create` button and fill **Name** of the service. Then, we should prepare the client application on the side of OpenID service:
+Using these settings we can add `Open ID `__ configuration to allow logging into the |project_name| instance via external identity provider. Here is a detailed description of the setup:
-* Use **Callback URL** (and optionally **Logout URL**) to create the client
-* Obtain **Client ID** and **Client Secret**
-* Obtain OpenID endpoint **URL** (we may get one ending with ``/.well-known/openid-configuration``, if so we just use the part before this suffix)
-* Configure the client to have the following claims: ``openid``, ``profile``, ``email``
-* Configure the client to provide the following details in ID tokens: ``email``, ``given_name``, ``family_name``
+1. Go to https://portal.azure.com/.
+2. Go to ``App registrations``.
+3. Click on ``New registration``.
+4. Fill in a name.
+5. Select ``Accounts in this organizational directory only (Single tenant)``.
+6. Keep ``Redirect URI`` empty.
+7. Click on ``Register``.
+8. Copy and store ``Directory (tenant) ID`` and ``Application (client) ID``.
+9. Click on ``Manage`` in the left menu → ``Certificates & Secrets``.
+10. Click on ``New client secret``.
+11. Fill description, set ``Expires`` and note it somewhere, then click on ``Add``.
+12. Copy ``Value`` and store it somewhere. You will not able to view it again.
-Back in the |project_name| settings, we can fill **Client ID**, **Client Secret**, and **URL** from our OpenID client together with optional **Parameters** (usually not needed). Finally, we can configure how the log-in button will look like by setting **Icon** (by using `Font Awesome `_), **Name**, **Background**, and text/icon **Color**.
-
-.. figure:: openid/openid.png
- :width: 700
-
- Example configuration of OpenID service.
+13. Create OpenID in FAIR Wizard. Go to :guilabel:`Admin Center` → :guilabel:`Settings` → :guilabel:`Organization OpenID` → :guilabel:`Create`. Fill in :
+ - ``Application (client) ID``
+ - ``Directory (tenant) ID``
+ - ``Client Secret`` → ````
+14. (optional) fill Icon (``fab fa-microsoft``, or some other from `Font Awesome `_), :guilabel:`Background Color` and :guilabel:`Text Color`.
-.. NOTE::
+15. Click on :guilabel:`Save`.
+
+16. Go back to Microsoft Azure.
+17. Click on ``Manage`` in the left menu → ``Authentication (Preview)``.
+18. Click on ``Add Redirect URI``.
+19. Click on ``Web``.
+20. Copy ``Redirect URI`` and ``Front-channel logout URL`` from FAIR Wizard.
+21. **Do not** check any checkbox.
+22. Click on ``Configure``.
+23. Click on ``Manage`` in the left menu → ``API permissions``.
+24. Click on ``Add a permission``.
+25. Click on ``Microsoft Graph`` → ``Delegated permissions``.
+26. Check ``email``, ``openid`` and ``profile`` under ``OpenId permissions`` and keep checked ``User.Read`` under ``User``.
+27. Click on ``Add permissions``.
- After setting a new OpenID service, we should directly test it and verify that the configuration works well. For that, we can simply open our |project_name| instance in a new anonymous window of the web browser.
+28. Click on ``Manage`` in the left menu → ``Token configuration``.
+29. Click on ``Add optional claim``.
+30. Select ``ID`` and check ``email``, ``given_name``, ``family_name``.
+31. Click on ``Add``.
+
+32. Test your openId in FAIR Wizard (You might need to refresh the login page for the login button to appear).
+
+.. TODO::
+
+ Add screenshot of configured OpenID service.
+
+.. .. figure:: openid/openid.png
+.. :width: 700
+
+.. Example configuration of OpenID service.
+
+Automations
+===========
Automations
@@ -27,12 +63,13 @@ Automations
We can use the **Create automation** button to add some extra steps after users use this login option. There are two tabs. Configuration, where we can set up automation using the `Integration SDK `__ and Logs where we can see logs of the automation. The automation can have its name changed and it can be enabled or disabled. See details in :ref:`automations`.
-.. figure:: openid/openid-detail.png
- :width: 700
+.. .. figure:: openid/openid-detail.png
+.. :width: 700
- Configured OpenID service (with hidden details).
+.. Configured OpenID service (with hidden details).
.. NOTE::
- There can be only one automation per login configuration however multiple things can be set up in one automation script.
+ There can be only one automation per login configuration. However, multiple actions can be set up within a single automation script.
+
diff --git a/docs/applications/admin-center/settings/system/locales/create.rst b/docs/applications/admin-center/settings/system/locales/create.rst
index 46759c64..47376b98 100644
--- a/docs/applications/admin-center/settings/system/locales/create.rst
+++ b/docs/applications/admin-center/settings/system/locales/create.rst
@@ -5,7 +5,7 @@ We can create a new locale directly in |project_name| by pressing :guilabel:`Cre
Finally, a POT files can be downloaded here. From them, we can create PO files in a standard (`gettext `__-based) way. There is a POT file for each app of FAIR Wizard and also for the emails.
-We can :download:`download localization files here<./create/fw-4-24-0-locales.zip>`.
+We can :download:`download localization files here<./create/fw-4-26-0-locales.zip>`.
.. figure:: create/form.png
diff --git a/docs/applications/admin-center/settings/system/locales/create/fw-4-24-0-locales.zip b/docs/applications/admin-center/settings/system/locales/create/fw-4-24-0-locales.zip
deleted file mode 100644
index 9adbd491..00000000
Binary files a/docs/applications/admin-center/settings/system/locales/create/fw-4-24-0-locales.zip and /dev/null differ
diff --git a/docs/applications/admin-center/settings/system/locales/create/fw-4-26-0-locales.zip b/docs/applications/admin-center/settings/system/locales/create/fw-4-26-0-locales.zip
new file mode 100644
index 00000000..1c776b88
Binary files /dev/null and b/docs/applications/admin-center/settings/system/locales/create/fw-4-26-0-locales.zip differ
diff --git a/docs/applications/analytics/profile/about.rst b/docs/applications/analytics/profile/about.rst
index b5f91622..840d34b7 100644
--- a/docs/applications/analytics/profile/about.rst
+++ b/docs/applications/analytics/profile/about.rst
@@ -1,11 +1,11 @@
About
*****
-By selecting the :guilabel:`About` option from the :doc:`./index` menu, users are directed to the About page. This page offers detailed information about the current versions and build timestamps of the tool's components. This level of transparency helps ensure that both users and developers are fully informed about the specific versions and build statuses of the components they are working with.
+By selecting the :guilabel:`About` option from the :doc:`./index` menu, users are directed to the About page. This page offers detailed information about the current versions and build timestamps of the tool's components. It also includes information about metamodels together with Project Importers and Project Actions count. This level of transparency helps ensure that both users and developers are fully informed about the specific versions and build statuses of the components they are working with.
The :guilabel:`API URL` link provides access to the server's API endpoints, which can be used for integrating the Data Stewardship Wizard with other systems and automating tasks.
-The :guilabel:`API Documentation` link directs to the API documentation presented in Swagger UI that provides detailed descriptions of available operations and parameters.
+The :guilabel:`API Docs` link directs to the API documentation presented in Swagger UI that provides detailed descriptions of available operations and parameters.
.. figure:: about/modal.png
:width: 500
diff --git a/docs/applications/data-management-planner/profile/about.rst b/docs/applications/data-management-planner/profile/about.rst
index bc55d1b4..f0774a0b 100644
--- a/docs/applications/data-management-planner/profile/about.rst
+++ b/docs/applications/data-management-planner/profile/about.rst
@@ -3,11 +3,11 @@
About
*****
-By selecting the :guilabel:`About` option from the :doc:`./index` menu, users are directed to the About page. This page offers detailed information about the current versions and build timestamps of the tool's components. This level of transparency helps ensure that both users and developers are fully informed about the specific versions and build statuses of the components they are working with.
+By selecting the :guilabel:`About` option from the :doc:`./index` menu, users are directed to the About page. This page offers detailed information about the current versions and build timestamps of the tool's components. It also includes information about metamodels together with Project Importers and Project Actions count. This level of transparency helps ensure that both users and developers are fully informed about the specific versions and build statuses of the components they are working with.
The :guilabel:`API URL` link provides access to the server's API endpoints, which can be used for integrating the Data Stewardship Wizard with other systems and automating tasks.
-The :guilabel:`API Documentation` link directs to the API documentation presented in Swagger UI that provides detailed descriptions of available operations and parameters.
+The :guilabel:`API Docs` link directs to the API documentation presented in Swagger UI that provides detailed descriptions of available operations and parameters.
.. figure:: about/modal.png
:width: 500
diff --git a/docs/applications/data-management-planner/profile/index.rst b/docs/applications/data-management-planner/profile/index.rst
index a0af4fc2..0c14b2bc 100644
--- a/docs/applications/data-management-planner/profile/index.rst
+++ b/docs/applications/data-management-planner/profile/index.rst
@@ -27,4 +27,5 @@ Moreover, there are also options to :guilabel:`Log out`, see basic information a
User Settings
Assigned Comments
About
+ News
\ No newline at end of file
diff --git a/docs/applications/data-management-planner/profile/news.rst b/docs/applications/data-management-planner/profile/news.rst
new file mode 100644
index 00000000..3d966d3b
--- /dev/null
+++ b/docs/applications/data-management-planner/profile/news.rst
@@ -0,0 +1,15 @@
+.. _planner-news:
+
+What's New
+**********
+
+By selecting the :guilabel:`What's New` option from the :doc:`./index` menu, we can open the News modal. There, we can find information about the most notable updates and changes in FAIR Wizard for each version.
+
+.. TODO::
+
+ Add screenshot
+
+.. .. figure:: about/news.png
+.. :width: 500
+
+.. ...
diff --git a/docs/applications/integration-hub/profile/about.rst b/docs/applications/integration-hub/profile/about.rst
index ec853b17..e9d820d9 100644
--- a/docs/applications/integration-hub/profile/about.rst
+++ b/docs/applications/integration-hub/profile/about.rst
@@ -3,11 +3,11 @@
About
*****
-By selecting the :guilabel:`About` option from the :doc:`./index` menu, users are directed to the About page. This page offers detailed information about the current versions and build timestamps of the tool's components. This level of transparency helps ensure that both users and developers are fully informed about the specific versions and build statuses of the components they are working with.
+By selecting the :guilabel:`About` option from the :doc:`./index` menu, users are directed to the About page. This page offers detailed information about the current versions and build timestamps of the tool's components. It also includes information about metamodels together with Project Importers and Project Actions count. This level of transparency helps ensure that both users and developers are fully informed about the specific versions and build statuses of the components they are working with.
The :guilabel:`API URL` link provides access to the server's API endpoints, which can be used for integrating the Data Stewardship Wizard with other systems and automating tasks.
-The :guilabel:`API Documentation` link directs to the API documentation presented in Swagger UI that provides detailed descriptions of available operations and parameters.
+The :guilabel:`API Docs` link directs to the API documentation presented in Swagger UI that provides detailed descriptions of available operations and parameters.
.. figure:: about/modal.png
:width: 500
diff --git a/docs/conf.py b/docs/conf.py
index f98b2c47..926d0bf7 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -26,7 +26,7 @@
registry_name = 'FAIR Wizard Registry'
# The full version, including alpha/beta/rc tags
-version = release = '4.25'
+version = release = '4.26'
rst_prolog = f"""
diff --git a/docs/more/development/document-templates/document-context.rst b/docs/more/development/document-templates/document-context.rst
index 25542c46..62f08c2b 100644
--- a/docs/more/development/document-templates/document-context.rst
+++ b/docs/more/development/document-templates/document-context.rst
@@ -115,7 +115,16 @@ Aliases:
ContextConfig
~~~~~~~~~~~~~
-- ``client_url`` (``str``) - base URL of the FAIR Wizard instance (client app)
+- ``app_title`` (``str``) - passed by backend from Settings
+- ``app_title_short`` (``str``) - passed by backend from Settings
+- ``client_url`` (``str``) - base URL of the FAIR Wizard instance (client app)
+- ``illustrations_color`` (``str``) - passed by backend from Settings
+- ``logo_url`` (``str``) - passed by backend from Settings
+- ``primary_color`` (``str``) - passed by backend from Settings
+- ``service_domain_name`` (``str``)
+- ``service_name`` (``str``)
+- ``service_name_short`` (``str``)
+- ``service_url`` (``str``)
.. _odc-document:
diff --git a/docs/more/development/document-templates/document-context.svg b/docs/more/development/document-templates/document-context.svg
index 0ac377a4..837dff23 100644
--- a/docs/more/development/document-templates/document-context.svg
+++ b/docs/more/development/document-templates/document-context.svg
@@ -1,8868 +1,1622 @@
-
-
+
+
+
\ No newline at end of file
diff --git a/docs/more/development/document-templates/specification.rst b/docs/more/development/document-templates/specification.rst
index f206dfb5..713fa882 100644
--- a/docs/more/development/document-templates/specification.rst
+++ b/docs/more/development/document-templates/specification.rst
@@ -93,6 +93,11 @@ Document Template Metamodel Versions
Here are described the changes in metamodel for template specification as well as :doc:`document context` so developers can easily update their templates to a newer metamodel version when needed. It is also possible to check JSON schemas in higher detail, see :doc:`../metamodel-schemas`.
+Version 17.1 (since 4.26.0)
+---------------------------
+
+* Added configurable instance properties for Document Templates, see :ref:`odc-context-config`.
+
Version 17.0 (since 4.22.0)
---------------------------
diff --git a/docs/more/development/integration-questions/integration-api.rst b/docs/more/development/integration-questions/integration-api.rst
index d6d70c5c..77597a01 100644
--- a/docs/more/development/integration-questions/integration-api.rst
+++ b/docs/more/development/integration-questions/integration-api.rst
@@ -76,7 +76,7 @@ Test
In this section we can test the API integration. After filling in **Request Configuration**, **Test Search Query**, and optionally **Test Variables** we can use the **Load** button to send a test request to the API and see the response.
-Then we can view the **Request Details** and **Response**. In case of error we can check the logs for more information. In case of success, we can see the response JSON and use it to fill the **Response Configuration**.
+Then we can view the **Request Details** and **Response**. In case of a large response, there will be no syntax highlighting for better performance. Otherwise, the response JSON will be syntax highlighted for better readability. There is also a **Copy response** button to copy the whole response JSON. In case of error we can check the logs for more information. In case of success, we can see the response JSON and use it to fill the **Response Configuration**.
Response Configuration
----------------------
diff --git a/docs/more/development/metamodel-schemas.rst b/docs/more/development/metamodel-schemas.rst
index 6f6c95e2..da594beb 100644
--- a/docs/more/development/metamodel-schemas.rst
+++ b/docs/more/development/metamodel-schemas.rst
@@ -58,87 +58,87 @@ Document Context
Document Context is provided to the document templates by document worker. It contains all relevant data about project/questionnaire with replies, related knowledge model, author, and more. As KM evolves, the context may evolve as well. It is versioned using the Template metamodel version number. A document template must support the metamodel that is in the current |project_name| instance. It is needed to know how the document context looks like especially for :doc:`./document-templates/index`.
-+-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| Metamodel Version | Schema file | Changes (brief) | Since |
-+===================+==========================================================================================================================+===================================================+===========+
-| 17.0 | `JSON Schema `__ | Semver, new API integration, props to variables | 4.22.0 |
-+-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 16 | `JSON Schema `__ | Value question validations | 4.13.0 |
-+-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 15 | `JSON Schema `__ | File question | 4.12.0 |
-+-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 14 | `JSON Schema `__ | New KM entities, project details, and restructure | 4.10.0 |
-+-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 13 | `JSON Schema `__ | Removed states from templates | 4.3.0 |
-+-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 12 | `JSON Schema `__ | Optional Integration fields | 4.1.0 |
-+-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 11 | `JSON Schema `__ | Change template metadata | 3.20.0 |
-+-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 10 | `JSON Schema `__ | New question value types | 3.12.0 |
-+-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 9 | `JSON Schema `__ | Enhanced integration (e.g. widget type) | 3.10.0 |
-+-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 8 | `JSON Schema `__ | Annotations change | 3.8.0 |
-+-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 7 | `JSON Schema `__ | Project tags and description | 3.7.0 |
-+-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 6 | `JSON Schema `__ | Integrations with item template | 3.6.0 |
-+-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 5 | `JSON Schema `__ | Annotations | 3.5.0 |
-+-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 4 | `JSON Schema `__ | Metrics and phases | 3.2.0 |
-+-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 3 | `JSON Schema `__ | Project versions | 2.12.0 |
-+-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 2 | `JSON Schema `__ | Reply provenance | 2.6.0 |
-+-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 1 | `JSON Schema `__ | Initial versioned metamodel | 2.5.0 |
-+-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
+| Metamodel Version | Schema file | Changes (brief) | Since |
++===================+==========================================================================================================================+=========================================================+========+
+| 17.1 | `JSON Schema `__ | Configurable instance properties for Document Templates | 4.26.0 |
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
+| 17.0 | `JSON Schema `__ | Semver, new API integration, props to variables | 4.22.0 |
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
+| 16 | `JSON Schema `__ | Value question validations | 4.13.0 |
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
+| 15 | `JSON Schema `__ | File question | 4.12.0 |
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
+| 14 | `JSON Schema `__ | New KM entities, project details, and restructure | 4.10.0 |
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
+| 13 | `JSON Schema `__ | Removed states from templates | 4.3.0 |
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
+| 12 | `JSON Schema `__ | Optional Integration fields | 4.1.0 |
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
+| 11 | `JSON Schema `__ | Change template metadata | 3.20.0 |
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
+| 10 | `JSON Schema `__ | New question value types | 3.12.0 |
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
+| 9 | `JSON Schema `__ | Enhanced integration (e.g. widget type) | 3.10.0 |
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
+| 8 | `JSON Schema `__ | Annotations change | 3.8.0 |
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
+| 7 | `JSON Schema `__ | Project tags and description | 3.7.0 |
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
+| 6 | `JSON Schema `__ | Integrations with item template | 3.6.0 |
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
+| 5 | `JSON Schema `__ | Annotations | 3.5.0 |
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
+| 4 | `JSON Schema `__ | Metrics and phases | 3.2.0 |
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
+| 3 | `JSON Schema `__ | Project versions | 2.12.0 |
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
+| 2 | `JSON Schema `__ | Reply provenance | 2.6.0 |
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
+| 1 | `JSON Schema `__ | Initial versioned metamodel | 2.5.0 |
++-------------------+--------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------+
Template (.json file)
=====================
Each template has its descriptor file ``template.json`` which contains all the information about the template, its format(s) and steps how to produce the document(s). It is also versioned by the Template metamodel version number. This file also contains the actual number of the supported version... With local :doc:`./document-templates/index`, we will need to manage the file according to the schema; however, when :doc:`../../applications/data-management-planner/document-templates/editors/index` are used, we will define it using forms directly in |project_name|.
-.. NOTE::
-
- Between versions 1 and 5, the structure of ``template.json`` is still the same. Only the document context has been changed.
-
-+-------------------+------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| Metamodel Version | Schema file | Changes (brief) | Since |
-+===================+==============================================================================================================================+===================================================+===========+
-| 17.0 | `JSON Schema `__ | Value question validations | 4.22.0 |
-+-------------------+------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 16 | `JSON Schema `__ | Value question validations | 4.13.0 |
-+-------------------+------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 15 | `JSON Schema `__ | File question | 4.12.0 |
-+-------------------+------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 14 | `JSON Schema `__ | New KM entities, project details, and restructure | 4.10.0 |
-+-------------------+------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 13 | `JSON Schema `__ | Removed states from templates | 4.3.0 |
-+-------------------+------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 12 | `JSON Schema `__ | Optional Integration fields | 4.1.0 |
-+-------------------+------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 11 | `JSON Schema `__ | Change template metadata | 3.20.0 |
-+-------------------+------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 10 | `JSON Schema `__ | New question value types | 3.12.0 |
-+-------------------+------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 9 | `JSON Schema `__ | Enhanced integration (e.g. widget type) | 3.10.0 |
-+-------------------+------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 8 | `JSON Schema `__ | Annotations change | 3.8.0 |
-+-------------------+------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 7 | `JSON Schema `__ | Project tags and description | 3.7.0 |
-+-------------------+------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 6 | `JSON Schema `__ | Integrations with item template | 3.6.0 |
-+-------------------+------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 5 | `JSON Schema `__ | Annotations | 3.5.0 |
-+-------------------+------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 4 | `JSON Schema `__ | Metrics and phases | 3.2.0 |
-+-------------------+------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 3 | `JSON Schema `__ | Project versions | 2.12.0 |
-+-------------------+------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 2 | `JSON Schema `__ | Reply provenance | 2.6.0 |
-+-------------------+------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
-| 1 | `JSON Schema `__ | Initial versioned metamodel | 2.5.0 |
-+-------------------+------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------+-----------+
\ No newline at end of file
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
+| Metamodel Version | Schema file | Changes (brief) | Since |
++===================+==============================================================================================================================+=============================================================+========+
+| 17.1 | `JSON Schema `__ | Configurable instance properties for Document Templates. | 4.26.0 |
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
+| 17.0 | `JSON Schema `__ | Value question validations | 4.22.0 |
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
+| 16 | `JSON Schema `__ | Value question validations | 4.13.0 |
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
+| 15 | `JSON Schema `__ | File question | 4.12.0 |
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
+| 14 | `JSON Schema `__ | New KM entities, project details, and restructure | 4.10.0 |
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
+| 13 | `JSON Schema `__ | Removed states from templates | 4.3.0 |
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
+| 12 | `JSON Schema `__ | Optional Integration fields | 4.1.0 |
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
+| 11 | `JSON Schema `__ | Change template metadata | 3.20.0 |
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
+| 10 | `JSON Schema `__ | New question value types | 3.12.0 |
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
+| 9 | `JSON Schema `__ | Enhanced integration (e.g. widget type) | 3.10.0 |
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
+| 8 | `JSON Schema `__ | Annotations change | 3.8.0 |
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
+| 7 | `JSON Schema `__ | Project tags and description | 3.7.0 |
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
+| 6 | `JSON Schema `__ | Integrations with item template | 3.6.0 |
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
+| 5 | `JSON Schema `__ | Annotations | 3.5.0 |
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
+| 4 | `JSON Schema `__ | Metrics and phases | 3.2.0 |
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
+| 3 | `JSON Schema `__ | Project versions | 2.12.0 |
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
+| 2 | `JSON Schema `__ | Reply provenance | 2.6.0 |
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
+| 1 | `JSON Schema `__ | Initial versioned metamodel | 2.5.0 |
++-------------------+------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------+--------+
diff --git a/docs/requirements.txt b/docs/requirements.txt
index c27575c4..f8ccf75e 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -28,10 +28,11 @@ msgpack==1.1.2
myst-parser==4.0.1
natsort==8.4.0
packaging==25.0
-platformdirs==4.5.0
+platformdirs==4.5.1
Pygments==2.19.2
PyYAML==6.0.3
requests==2.32.5
+roman==5.2
roman-numerals-py==3.1.0
ruamel.yaml==0.18.16
ruamel.yaml.clib==0.2.15
@@ -47,7 +48,7 @@ sphinx-prompt==1.10.2
sphinx-reredirects==1.0.0
sphinx-substitution-extensions==2025.11.17
sphinx-tabs==3.4.5
-sphinx-toolbox==4.0.0
+sphinx-toolbox==4.1.0
sphinxcontrib-applehelp==2.0.0
sphinxcontrib-devhelp==2.0.0
sphinxcontrib-htmlhelp==2.1.0
@@ -57,5 +58,5 @@ sphinxcontrib-serializinghtml==2.0.0
sphinxcontrib-youtube==1.4.1
tabulate==0.9.0
typing_extensions==4.15.0
-urllib3==2.5.0
+urllib3==2.6.2
webencodings==0.5.1