Change workflow to build for 2025.04 as well

Author: Lisa Julia Nebel

.github/workflows/python_sphinx_docs.yml

@@ -44,18 +44,17 @@ jobs:
             mkdir gh-pages
             touch gh-pages/.nojekyll
             cd sphinx_docs
-            # Currently we build only docs for the HEAD of the master branch
-            # Later we can add release tags to the list to get the docs for the releases
-            # For example: -b "master, release/2024.04/final" will build the docs for
-            # the master branch and the release/2024.04/final tag
-            # For the releases, we create snapshots of the docstrings_common.json and docstrings_simulators.json
-            # and take the ones tracked by git, only for the master, we take the current ones we fetched
-            # in steps 2 and 3 of this workflow
-
+            # To add a new relase to this build system:
+            # - add the respective branch <your-new-release> on this repository
+            # - take a snapshot of https://raw.githubusercontent.com/OPM/opm-common/<your-new-release>/python/docstrings_common.json,
+            #   https://raw.githubusercontent.com/OPM/opm-simulators/<your-new-release>/python/docstrings_simulators.json and
+            #   https://raw.githubusercontent.com/OPM/opm-simulators/<your-new-release>/dune.module and put them
+            #   in the python folder on that branch
+            # - add the respective branch <your-new-release> in the commands below
             if [ "${{ github.ref_name }}" == "master" ]; then
-              poetry run sphinx-versioned -m master -b "master" --force --git-root ../../
+              poetry run sphinx-versioned -m master -b "master release/2025.04" --force --git-root ../../
             else
-              poetry run sphinx-versioned -m master -b "master ${{ github.ref_name }}" --force --git-root ../../
+              poetry run sphinx-versioned -m master -b "${{ github.ref_name }} master release/2025.04" --force --git-root ../../
             fi
         - name: Copy documentation to gh-pages
           run: |