Changing Default Paths within kairos.io Documentation

[wcrum]

In reference to #4107, currently kairos.io documentation defaults to showing "next" / origin main documentation. Opening this discussion to determine if we should modify the routes within kairos.io so that the primary / default view of the documentation is latest release, and it requires a explicit version change to go to "next" / "head".

We see this pattern in several locations. Example of which.

Examples of Recommended Implementation

1. https://docs.k0sproject.io/

   • k0s documentation defaults to latest / stable version. Requiring a user to go into the version dropdown and select head, then adding a banner of "You are not currently viewing the documentation for the current stable release of k0s."

2. https://argo-cd.readthedocs.io/

   • Argo CD documentation, bottom right defaults to "stable" then requiring a user to open the box, then selecting "latest".

3. https://docs.crossplane.io/

• Crossplane documentation, top right, defaults to latest release version, requiring a dropdown to then select "master".

Possible Issues

1. In reference to the comment here, Carrusel links should open on latest stable #4107 (comment), there could be SEO implications and issues with the significant migration.

cc: @mauromorales

[mauromorales]

I'm looking at this a bit late so I'm not sure if things have changed in the meantime but seems to me like right now both the links in the homepage as the docs link at the nav bar take you to the stable version. Would that address the request?

[wcrum]

Partially.

Yes the default behavior of the carousel / docs link at the nav bar take you to stable version (right now 4.1.2). This is by passing down latestVersion to every frontend prop.

But if you look at the footer, every documentation link is to latest / next. https://kairos.io/docs/installation/ instead of https://kairos.io/docs/v4.1.2/installation/.

My recommendation being is to restructure the kairos.io documentation so the default is latest / stable.

In theory going to https://kairos.io/docs/installation/ would take you to the latest, while https://kairos.io/docs/[KEYWORD]/installation/ would take you to next / latest / main.

This would decrease "link sprawl" and default link behavior is ALWAYS stable.

Where [KEYWORD] could be main, latest, next, dev etc.

[wcrum]

The core benefit of this, is links to Kairos will always default to just latest stable.