From 0a53da63b9a372fc1d49d49988ff4d886366726b 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 ada36d875..02d448c58 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 c7246baf843affed8994d602cae196965179f615 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 02d448c58..dded2c580 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 9be24d83f2383e4c5141da7277ba506c59251a8b 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 dded2c580..9b0b42e43 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