From bb5416e98c6cf4f1274171999c856e13d6cf2612 Mon Sep 17 00:00:00 2001 From: Joseph Capriotti Date: Sun, 8 Sep 2024 13:52:43 -0600 Subject: [PATCH] Additional version banner details. Add more detailed descriptions on what causes different messages to appear in the version announcement. --- docs/user_guide/announcements.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/user_guide/announcements.rst b/docs/user_guide/announcements.rst index 2b48829aa..bf56edb04 100644 --- a/docs/user_guide/announcements.rst +++ b/docs/user_guide/announcements.rst @@ -89,6 +89,11 @@ In addition to the general-purpose announcement banner, the theme includes a bui "preferred": true } + If the active version compares less than the preferred version, the announcement will inform the user that + they are viewing an older version of the documentation and provide a link to the preferred version. If the + version compares greater than the preferred version (or if the version match contains the strings `"dev"`, + `"rc"` or `"pre"`), the announcement will say they are viewing an unstable development version instead. + If you want similar functionality for *older* versions of your docs (i.e. those built before the ``show_version_warning_banner`` configuration option was available), you can manually add a banner by prepending the following HTML to all pages (be sure to replace ``URL_OF_STABLE_VERSION_OF_PROJECT`` with a valid URL, and adjust styling as desired): .. code-block:: html