Versioning

main        → docs.site.com (latest)
v2          → v2.docs.site.com
v1          → v1.docs.site.com

docs/
  v3/          → current
  v2/          → previous
  v1/          → legacy

import { VersionSelect } from "fromsrc/client";

<VersionSelect
  current="v3"
  versions={[
    { id: "v3", label: "v3 (latest)", href: "/" },
    { id: "v2", label: "v2", href: "https://v2.docs.site.com" },
    { id: "v1", label: "v1", href: "https://v1.docs.site.com" },
  ]}
/>;

v2.docs.example.com → version 2
v1.docs.example.com → version 1
docs.example.com    → latest

docs.example.com/v2/ → version 2
docs.example.com/v1/ → version 1
docs.example.com/    → latest

export const metadata = {
  alternates: {
    canonical: "https://docs.example.com/guide",
  },
};

<url>
  <loc>https://docs.example.com/guide</loc>
  <priority>1.0</priority>
</url>
<url>
  <loc>https://v2.docs.example.com/guide</loc>
  <priority>0.5</priority>
</url>

import { Banner } from "fromsrc/client";

{
  version !== "latest" && (
    <Banner variant="warning">
      you're viewing docs for {version}.<a href="/">switch to latest</a>
    </Banner>
  );
}