Notification: allow to disable latest and/or non-stable warning

[humitos]

The current pretty simple logic we have is good and it may work for most of the cases. However, it's a little verbose since it will show a notification in all the versions that are not stable --which could be a lot.

There are users that won't like this pattern and may not want to follow "our proposal to use the platform" here (most users should always read the stable version of the project's documentation) or may require an un-supported way to decide "stable" version.

These users should be able to decide whether or not show a warning notification on latest and/or on non-stable versions independently:

• Enable the addons (disable it completely)
• Show a notification on non-stable versions
• Show a notification on latest version

Related

• Notification: simple stable-latest version warning logic #125
• Addons: allow users to opt-in into the new addons ext-theme#212
• Addons: create project admin page to configure addons ext-theme#211
• Add warning to /latest docs that they document main branch, not released versions cilium/cilium#29969
• Notification: split the WebComponent in, at least, two (latest/stable and external) #201

[Zylann]

Is it about this warning?

I started noticing it only a few weeks ago, and I don't know how to get rid of it. Many users of my project use its latest version and it's annoying. Also even if it were desired, it covers the top of every page, requiring action to dismiss it each time.

Also I notice this is an "addon", but I don't remember setting this up anywhere? (new to this repo, maybe it's not what it means)

[humitos]

Hi @Zylann. This is new to Read the Docs as well. We have been migrating a lot of features we used to perform in the backend build process to a front-end application.

You can read more about this in our blog:

• https://blog.readthedocs.com/addons-flyout-menu-beta/
• https://about.readthedocs.com/blog/2024/04/enable-beta-addons/

Note that you can disable this notification from your project's setting using the beta dashboard (more info about this in the second blog post). Let me know if that helps.