[BUG]: Links to versioned RTD sites may need updating

[paigem]

Bug description

Thanks to @theoellingsen's issue #1249 , we noticed that the links to RTD sites that enable named versioning may break.

It looks like the OM3 config docs have enabled versioning, with the default version being latest. While links to the home page of the OM3 config docs seem to default to latest if no version name is specified, direct links to other pages on the OM3 config docs (e.g. the broken link found by @theoellingsen https://access-om3-configs.access-hive.org.au/configurations/Overview/) sends a 404 error. His PR updates this to include the version name latest in the URL. (Thanks @theoellingsen!)

We may want to run the link checker to check for other broken links like this one, and this is something we will look out for as other config docs sites enable versioning.

Question for @chrisb13: I see that the OM3 config docs has a few named versions, including latest and stable. Just confirming that you want your default to be latest, and that we should default to linking to the latest version from the Hive Docs (unless there is a need to reference a specific older version)?

Expected Behavior

The links do not throw an error.

Steps to Reproduce

Click on the above links.

[chrisb13]

(e.g. the broken link found by @theoellingsen https://access-om3-configs.access-hive.org.au/configurations/Overview/) sends a 404 error. His PR updates this to include the version name latest in the URL. (Thanks @theoellingsen!)

yeah we've had that pop up in a few places as we made links before we'd implemented versioning. I always just put latest in the url.

Question for @chrisb13: I see that the OM3 config docs has a few named versions, including latest and stable. Just confirming that you want your default to be latest, and that we should default to linking to the latest version from the Hive Docs (unless there is a need to reference a specific older version)?

Yeah I think latest makes the most sense but I'll double check with @anton-seaice.

On a semi-related point, I noticed today that when one uses the version picker that doesn't exist in that version it kinda 404s. Here's an example.

Go to here:
https://access-om3-paper-1.readthedocs.io/latest/

Click on Bottom_age_tracer_in_ACCESS_OM3 the summary page, i.e.
https://access-om3-paper-1.readthedocs.io/latest/experiments/MC_25km_jra_iaf%2Bwombatlite-test4-d28e0359/Bottom_age_tracer_in_ACCESS_OM3/

then click on a version that doesn't have this page, e.g. mc_25km_jra_iafwombatlite_bs2-mpudig-backscat2-0578cc36-2026.07.000

This then tries to go to:
https://access-om3-paper-1.readthedocs.io/mc_25km_jra_iafwombatlite_bs2-mpudig-backscat2-0578cc36-2026.07.000/experiments/MC_25km_jra_iaf+wombatlite-test4-d28e0359/Bottom_age_tracer_in_ACCESS_OM3/

Any suggestions on how to fix this would be appreciated!

[anton-seaice]

Yes latest is fine I think

I added a redirect in the RTD settings to fix this, it feels a bit flakey though, so using links to pages with versions is probably best practice

e.g.

https://access-om3-configs.access-hive.org.au/configurations/Overview/

works now

but i'd still change it to

https://access-om3-configs.access-hive.org.au/latest/configurations/Overview/