From 1c18d63d0e4ea70256b832b32143838828c1f857 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 921c68628..35f626be6 100644 --- a/conf.py +++ b/conf.py @@ -87,6 +87,19 @@ html_css_files = [ 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 1cedbddf36526c5d8decefa6a2c7f2f029af0190 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 35f626be6..792ee2c15 100644 --- a/conf.py +++ b/conf.py @@ -92,11 +92,11 @@ if (version.isdigit() and version < version_start): 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 bd129e7d6eabda44b04777f7428deb0a8e5e273c 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 792ee2c15..8bbcad78a 100644 --- a/conf.py +++ b/conf.py @@ -92,8 +92,8 @@ 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.* + *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