Added Out-Of-Date Documentation Header for v1.24

[sbegin0]

Description

Added a warning header to all docs pages warning user that this version is out-of-date with an option to go to /latest

Reviewers

• Ambient
• Docs
• Installation
• Networking
• Performance and Scalability
• Extensions and Telemetry
• Security
• Test and Release
• User Experience
• Developer Infrastructure
• Localization/Translation

[dhawton]

This branch is not served on any documentation site.

[craigbox]

It will be - that's the point of the exercise. We will regenerate and re-copy the archives to the current site in order to get these changes to apply.

[dhawton]

It will be - that's the point of the exercise. We will regenerate and re-copy the archives to the current site in order to get these changes to apply.

Gotcha.. sorry.. I didn't know that was the plan.

letting Craig run this

[craigbox]

Last fix requests left inline.

Will the lint ever pass? Don't think so, but it should never be a problem as this header is only added when building in archive mode.
The archive pages are not linted, so I think a mass update to those won't cause a problem.

Alternatively we can detect that we're in archive mode and disable link checking.

@dhawton for thoughts

[craigbox]

Not needed any more...

[craigbox]

...but you do need a check that you're in archive mode (.Site.Data.args.archive), else this will show up on latest and preliminary.

[sbegin0]

I see. Then, we'll be able to copy/paste these changes to all applicable branches, and upon a new release, the header will change automatically. Smart.

[craigbox]

Please move all the styles into an assets/sass/misc/_archive.scss and add an input for archive to assets/sass/_all.scss

[craigbox]

sorry for adding yet another hoop but perhaps we should internationalise this text?
Throw the strings in i18n/en.toml and use {{ i18n }} to refer to them. (Plenty of examples to check; look at one that uses %s so you can leave the version part out)

Did you check what happens with this redirect when you're on an archive page that's non-English?

[istio-testing]

@sbegin0: The following test failed, say /retest to rerun all failed tests or /retest-required to rerun all mandatory failed tests:

Test name	Commit	Details	Required	Rerun command
lint_istio.io_release-1.24	f8bcd97	link	true	/test lint

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

[craigbox]

@wilsonwu @Andygol Could you guys please help with translations for

[archive_banner_text]
other = "⚠️ This documentation is for an older version (<strong>%s</strong>) and is no longer updated."

[archive_banner_link]
other = "Read the latest version."

[Andygol]

[archive_banner_text]
other = "⚠️ This documentation is for an older version (<strong>%s</strong>) and is no longer updated."

[archive_banner_link]
other = "Read the latest version."

@craigbox 🇺🇦 Ukrainian translation 👇

[archive_banner_text]
other = "⚠️ Це документація для (застарілої) версії (<strong>%s</strong>), яка вже не підтримується."

[archive_banner_link]
other = "Читати останню версію."