From 03a768689e784924baa96e96907df1c715e9bf22 Mon Sep 17 00:00:00 2001 From: Josh Date: Wed, 10 Sep 2025 11:34:36 -0400 Subject: [PATCH 1/3] feat: Implement EoL warning banner for unsupported releases Added a warning banner for outdated documentation. Signed-off-by: Josh --- conf.py | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/conf.py b/conf.py index f5adc1f8f8d..2c8703758b4 100644 --- a/conf.py +++ b/conf.py @@ -81,6 +81,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 software. + Do not follow these instructions for current releases.* + + **To ensure you have the most reliable and up-to-date guidance, + please visit the** `official Nextcloud Documentation library + `_. + """ + # user starts in light mode default_dark_mode = False From c50728563749dbaba9b8d8978b3052e089dad7a9 Mon Sep 17 00:00:00 2001 From: Josh Date: Wed, 17 Sep 2025 11:12:19 -0400 Subject: [PATCH 2/3] chore: Apply suggestions from code review Co-authored-by: Daniel Signed-off-by: Josh --- conf.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/conf.py b/conf.py index 2c8703758b4..d5c7fc7345b 100644 --- a/conf.py +++ b/conf.py @@ -86,11 +86,11 @@ def generateVersionsDocs(current_docs): rst_prolog = """.. danger:: **OUTDATED DOCUMENTATION** - *You are viewing documentation for a retired version of Nextcloud software. + *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** `official Nextcloud Documentation library + please visit the** `Nextcloud Documentation homepage `_. """ From f32a25e0ef80bb059c3da9f3741012184dbff375 Mon Sep 17 00:00:00 2001 From: Josh Date: Wed, 17 Sep 2025 11:16:23 -0400 Subject: [PATCH 3/3] chore: drop tab from warning Updated warning message for outdated documentation. Signed-off-by: Josh --- conf.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/conf.py b/conf.py index d5c7fc7345b..c0e9015ef11 100644 --- a/conf.py +++ b/conf.py @@ -86,8 +86,8 @@ def generateVersionsDocs(current_docs): rst_prolog = """.. danger:: **OUTDATED DOCUMENTATION** - *You are viewing documentation for a retired version of Nextcloud. - Do not follow these instructions for current releases.* + *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