Update README.md

README.md

@@ -6,7 +6,7 @@
 
 ## Usage
 
-This repository contains the source files for the OSTrails documentation. The documentation is hosted on Read-the-Docs and can be accessed (only for this branch) [here](https://ostrails-docs--22.org.readthedocs.build/en/22/commons/resources.html).
+This repository contains the source files for the OSTrails documentation. The documentation is hosted on Read-the-Docs and can be accessed  [here](https://docs.ostrails.eu).
 
 ## Contributing
 

docs/commons/dmp/dmp-commons.rst

@@ -14,7 +14,7 @@ The **DMP Commons** provide a shared, reusable, and interoperable foundation for
 
 In addition, DMP Commons are relevant for data stewards and other stakeholders who need to structure information about Research Data Management (RDM).
 
-The Commons are built as a **layered framework** consisting of a common data model, an OSTrails (i.e. Europe/EOSC) -specific application profile, and a standard API. Together, these layers enable consistent interpretation of DMP content and predictable interactions between services, regardless of their internal architectures. This approach allows platforms to evolve independently while remaining interoperable at the boundaries. In addition, we provide `maDMP mappings <mappings/index>`_ to support the development of application profiles and to align DMP information with external standards and domain models.
+The Commons are built as a **layered framework** consisting of a common data model, an OSTrails (i.e. Europe/EOSC) -specific application profile, and a standard API. Together, these layers enable consistent interpretation of DMP content and predictable interactions between services, regardless of their internal architectures. This approach allows platforms to evolve independently while remaining interoperable at the boundaries. In addition, we provide :ref:`maDMP mappings <dmp-mappings>` to support the development of application profiles and to align DMP information with external standards and domain models.
 
 .. figure:: dmp-commons.png
     :alt: DMP Commons Layers

docs/commons/dmp/mappings/index.rst

@@ -1,3 +1,5 @@
+.. _dmp-mappings:
+
 maDMP Mappings
 ==============
 

docs/commons/fair/catalogue-of-benchmark-scoring-algorithms.rst

@@ -15,9 +15,9 @@ software framework maintained by the
 
 The FDP index includes descriptions of test records from multiple
 assessment tools, such as
-`FAIR Champion </docs/docs/tools/FAIR_tools/FAIR-Champion.rst>`_
+`FAIR Champion <tools/fair/fair-champion.rst>`_
 and
-`FOOPS </docs/docs/tools/FAIR_tools/FOOPS.rst>`_.
+`FOOPS <tools/fair/foops.rst>`_.
 
 Registering a Scoring Algorithm in the Catalogue
 --------------------------------------------------
@@ -57,4 +57,4 @@ registers the record in the FDP-based OSTrails index: https://tools.ostrails.eu/
 
 The FAIR Assessment Authoring Tool is available at: https://ostrails-fair.fair-wizard.com/wizard/dashboard
 
-All its documentation is available `here </docs/docs/tools/FAIR_tools/FAIR-Assessment-Authoring-Tool.rst>`_
+All its documentation is available :ref:`here <tool-fair-assessment-authoring-tool>`.

docs/commons/fair/catalogue-of-tests.rst

@@ -22,9 +22,9 @@ software framework maintained by the
 
 The FDP index includes descriptions of test records from multiple
 assessment tools, such as
-`FAIR Champion </docs/docs/tools/FAIR_tools/FAIR-Champion.rst>`_
+:ref:`FAIR Champion <tool-fair-champion>`
 and
-`FOOPS </docs/docs/tools/FAIR_tools/FOOPS.rst>`_.
+:ref:`FOOPS <tool-foops>`.
 
 Registering a Test in the Catalogue
 -----------------------------------
@@ -64,4 +64,4 @@ registers the record in the FDP-based OSTrails index: https://tools.ostrails.eu/
 
 The FAIR Assessment Authoring Tool is available at: https://ostrails-fair.fair-wizard.com/wizard/dashboard
 
-All its documentation is available `here </docs/docs/tools/FAIR_tools/FAIR-Assessment-Authoring-Tool.rst>`_
+All its documentation is available :ref:`here <tool-fair-assessment-authoring-tool>`

docs/tools/fair/fair-assessment-authoring-tool.rst

@@ -1,3 +1,5 @@
+.. _tool-fair-assessment-authoring-tool:
+
 FAIR Assessment Authoring Tool
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 

docs/tools/fair/fair-champion.rst

@@ -1,3 +1,5 @@
+.. _tool-fair-champion:
+
 FAIR Champion
 ^^^^^^^^^^^^^
 

docs/tools/fair/foops.rst

@@ -1,3 +1,5 @@
+.. _tool-foops:
+
 FOOPS!
 ^^^^^^