When a link does not reference a version, it produces a 404.

[laurafitzgerald]

Is it possible to inject latest as the default version?
Example of this is referenced in Kuadrant/authorino#513
This would save broken links needing to be fixed.
We already use aliases described here https://github.com/Kuadrant/docs.kuadrant.io?tab=readme-ov-file#mike-aliases not sure if that can provide us with a fix for this.

[jasonmadigan]

I looked into this at one point, as previously we had some doc sets published by default beneath /

Unfortunately, there didn't seem to be a way to create a blank/default version in mike that could be aliased to something else (e.g. a '' -> '/' version) to catch these, so I think we're stuck fixing them as we spot. Thankfully there are less now, some PRs a few months ago fixed most of the broken links

[laurafitzgerald]

Thanks @jasonmadigan I made updates to the existing links to point to latest. I noticed since tho that there is a dev version. Which of the two latest/dev do you think could be more appropriate for links inside authorino repo for example?

[david-martin]

Which of the two latest/dev do you think could be more appropriate for links inside authorino repo for example

I'd avoid linking to /dev as docs there may contain unreleased features and such.
Using /latest is safer, though there's an expectation that the url stays around. That's something to keep in mind. If a linked page moves or is being removed, the content can be updated and/or a redirect added for that page (see #187 where the redirects plugin was added)

[david-martin]

@laurafitzgerald I'm going to close this, given the comments above.
Please do reopen if you think there's more we can do here, given the limitations of mkdocs, mike and gh pages.
I think the redirects option, though manual and case by case, is better than nothing.