From aacb255ac7e06c72dbb14bbe3bda9522a94122ae 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 22091a00ef2..6d4938d6e13 100644 --- a/conf.py +++ b/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 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 b7933931581fe7617ac4576f16d36b3513067509 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 6d4938d6e13..431c4abfa47 100644 --- a/conf.py +++ b/conf.py @@ -76,11 +76,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 bc948e38c288b34e7eead0bf0e0484967b50cd03 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 431c4abfa47..b9636e6fb06 100644 --- a/conf.py +++ b/conf.py @@ -76,8 +76,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