Display banner for versioned docs

[sarjona]

William Entriken requested this at https://tracker.moodle.org/browse/MDLSITE-7820. To implement it, we're taking advantage of the banner setting: https://docusaurus.io/docs/versioning#configuring-versioning-behavior.

[netlify]

✅ Deploy Preview for moodledevdocs ready!

Name	Link
🔨 Latest commit	9a3700b
🔍 Latest deploy log	https://app.netlify.com/sites/moodledevdocs/deploys/67652e37b874540008a0ce19
😎 Deploy Preview	https://deploy-preview-1217--moodledevdocs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[github-actions]

⚡️ Lighthouse report for the deploy preview of this PR

URL	Performance	Accessibility	Best Practices	SEO	PWA	Report
/	🔴 43	🟢 95	🟢 100	🟢 90	🟢 100	Report
/docs/5.0/apis/commonfiles	🟠 59	🟢 93	🟢 100	🟢 100	🟢 100	Report
/general/development/gettingstarted	🟠 55	🟢 95	🟢 100	🟢 90	🟢 100	Report
/general/releases	🟠 58	🟢 95	🟢 100	🟢 100	🟢 100	Report

[andrewnicols]

Can you give an example of where you want to use this?

we already have some custom version-specific banners

[andrewnicols]

I’d prefer to do this in a different test. Check out how it looks sit. This patch on 4.1 for example

[sarjona]

Hi @andrewnicols!
I'm not sure if I understand your question. The idea of this patch is to implement what William Entriken requested at https://tracker.moodle.org/browse/MDLSITE-7820:

Add a warning that you are reading version 4.4 of the docs but a newer version is available. https://moodledev.io/docs/4.4/apis/commonfiles/version.php

Docusaurus implements this with the banner setting, so the patch is enabling this, to display a banner at the top of all the versioned doc pages:

[andrewnicols]

Compare against the message here: https://moodledev.io/general/releases/4.1

this is what I want to show as it has version-specific information and is factually incorrect.

it is not correct to say that 4.5 is “no longer actively maintained”.

If I recall the existing banner shown here is meant to be shown on all pages of versioned docs and something has broken that. The Docusaurus banner is too limiting.

[sarjona]

I'm closing this because a different approach has been prepared in #1219 (although it's unclear if it will be integrated).