[stable28] feat: Automated EoL warning banner for unsupported releases

.github/workflows/sphinxbuild.yml

@@ -23,7 +23,7 @@ jobs:
       shell: bash
       run: tar czf /tmp/documentation.tar.gz -C user_manual/_build/html .
     - name: Upload static documentation
-      uses: actions/upload-artifact@v3.1.3
+      uses: actions/upload-artifact@v4.6.2
       with:
         name: User manual.zip
         path: "/tmp/documentation.tar.gz"
@@ -55,7 +55,7 @@ jobs:
       shell: bash
       run: tar czf /tmp/documentation.tar.gz -C developer_manual/_build/html/com .
     - name: Upload static documentation
-      uses: actions/upload-artifact@v3.1.3
+      uses: actions/upload-artifact@v4.6.2
       with:
         name: Developer manual.zip
         path: "/tmp/documentation.tar.gz"
@@ -75,7 +75,7 @@ jobs:
       shell: bash
       run: tar czf /tmp/documentation.tar.gz -C admin_manual/_build/html/com .
     - name: Upload static documentation
-      uses: actions/upload-artifact@v3.1.3
+      uses: actions/upload-artifact@v4.6.2
       with:
         name: Administration manual.zip
         path: "/tmp/documentation.tar.gz"

conf.py

@@ -71,6 +71,19 @@ def generateVersionsDocs(current_docs):
 edit_on_github_project = 'nextcloud/documentation'
 edit_on_github_branch = 'master'
 
+# Automatically add EoL warning banner to docs for unsupported releases
+if (version.isdigit() and version < version_start):
+    rst_prolog = """.. danger::
+        **OUTDATED DOCUMENTATION**
+
+        *You are viewing documentation for a retired version of Nextcloud.
+        Do not follow these instructions for current releases.*
+
+        **To ensure you have the most reliable and up-to-date guidance,
+        please visit the** `Nextcloud Documentation homepage
+        <https://docs.nextcloud.com/>`_.
+    """
+
 # user starts in light mode
 default_dark_mode = False