Clarify text when referring to a released version in the docs

Depending on the context of releases, active docs can be only the current LTR docs
or we can have both the LTR docs and the docs for the next one.
Let's then use dedicated substitutions to avoid confusion.

Author: DelazJ

docs/about/contributors.rst

@@ -125,7 +125,7 @@ The current translations are made possible thanks to:
   Statistics of translation
   =========================
 
-  Efforts of translation for QGIS |CURRENT| Long Term Release are provided below.
+  Efforts of translation for QGIS |ltr| Long Term Release are provided below.
   Official documentation is published in only the languages that reached 5% of translation.
 
   .. include:: translation_stats.rst
@@ -138,4 +138,4 @@ The current translations are made possible thanks to:
    please add it also to the substitutions.txt file in the
    source folder.
 
-.. |CURRENT| replace:: 3.44
+.. |ltr| replace:: 3.44

docs/about/preamble.rst

@@ -58,13 +58,19 @@ What is new in QGIS |version|
 -----------------------------
 
 This release of QGIS includes hundreds of bug fixes and many new
-features and enhancements, compared to |QGIS_CURRENT|_.
+features and enhancements, compared to QGIS |previous_docs|.
 For a list of new features, visit the `visual changelogs
 <https://qgis.org/project/visual-changelogs/>`_.
 
 .. only:: not testing and not outdated
 
   We recommend that you use this version over previous releases.
 
-.. |QGIS_CURRENT| replace:: QGIS 3.40
-.. _QGIS_CURRENT: https://docs.qgis.org/3.40/en/docs/
+
+.. Substitutions definitions - AVOID EDITING PAST THIS LINE
+   This will be automatically updated by the find_set_subst.py script.
+   If you need to create a new substitution manually,
+   please add it also to the substitutions.txt file in the
+   source folder.
+
+.. |previous_docs| replace:: 3.44

docs/user_manual/grass_integration/grass_integration.rst

@@ -592,7 +592,7 @@ The GRASS plugin provides a user-friendly toolbox with about 200 of the availabl
 GRASS modules and functionalities.
 
 A complete list of GRASS modules available in the graphical Toolbox in QGIS
-version |CURRENT| is available in the GRASS wiki at
+is available in the GRASS wiki at
 https://grasswiki.osgeo.org/wiki/GRASS-QGIS_relevant_module_list.
 
 It is also possible to customize the GRASS Toolbox content. This procedure is
@@ -843,7 +843,6 @@ you select the module.
    please add it also to the substitutions.txt file in the
    source folder.
 
-.. |CURRENT| replace:: 3.44
 .. |captureBoundary| image:: /static/common/mActionCaptureBoundary.png
    :width: 1.5em
 .. |captureCentroid| image:: /static/common/mActionCaptureCentroid.png

release_process.md

@@ -39,14 +39,14 @@ This usually happens from the October release.
 Following changes have to be done in `master` branch before you create the new release branch.
 Otherwise, you will have to do the changes twice: in master and in the new branch.
 
-- [ ] In [substitutions.txt](substitutions.txt) file, replace |CURRENT| value with the new version number
 - [ ] In [docs_conf.yml](docs_conf.yml) file: add the new release number to the `version_list` parameter
 - [ ] In [dependabot.yml](.github/dependabot.yml) file: Add label for backporting dependencies update to the new branch
 
 You can now create the `release_x.y` branch in the [repository](https://github.com/qgis/QGIS-Documentation/branches), based on `master`.
 
 #### After the new branch is created
 
+- [ ] In [substitutions.txt](substitutions.txt) file, replace |previous_docs| value with the new version number
 - [ ] In [substitutions.txt](substitutions.txt) file:
   - [ ] Remove intermediate versions substitutions and their occurrences in the rst files
   - [ ] Add substitutions for the versions of the next LTR cycle that starts
@@ -127,6 +127,7 @@ In February, the new version is labeled as LTR, and replaces the previous one in
 <details>
 
 - [ ] In [conf.py](conf.py) file: set the html_context `isLtr` to `True`
+- [ ] In [substitutions.txt](substitutions.txt) file, replace |ltr| value with the new LTR version number
 - [ ] In [docs_conf.yml](docs_conf.yml) file: add target languages to the `supported_languages` parameter.
   These are the languages that will be published in the documentation.
   A threshold of 5% is currently applied to candidates.
@@ -158,6 +159,7 @@ is being translated. So when a new LTR is published, we disconnect the old one a
 
 <details>
 
+- [ ] In [substitutions.txt](substitutions.txt) file, replace |ltr| value with the new LTR version number
 - [ ] In [fix_versions.sh](scripts/fix_versions.sh) file:
   - [ ] add the old LTR number to the `DEPRECATED` parameter
   - [ ] add the new LTR number to the `DOCVERSIONS` parameter

substitutions.txt

@@ -3,11 +3,12 @@
 
 # Text replacement
 
-.. |CURRENT| replace:: 3.44
 .. |largeLandUseArea| replace:: Bontebok National Park
+.. |ltr| replace:: 3.44
 .. |majorUrbanName| replace:: Swellendam
 .. |schoolAreaType1| replace:: athletics field
 .. |srtmFileName| replace:: :file:`srtm_41_19_4326.tif`
+.. |previous_docs| replace:: 3.44
 
 # Icons replacement