[{"data":1,"prerenderedAt":29},["ShallowReactive",2],{"clay-page:\u002Forganizing\u002Fversions":3},{"html":4,"toc":5,"description":25,"hero":26,"list":27,"socialImage":28},"\u003Ch1 id=\"versions\">Versions\u003C\u002Fh1>\n\u003Cp>When a release changes how your project works, readers of older releases still need the old docs. Clay keeps older versions of the docs online next to the latest ones, each with its own navigation, search and URLs.\u003C\u002Fp>\n\u003Ch2 id=\"how-versions-work\">\u003Ca class=\"heading-anchor\" href=\"#how-versions-work\" aria-label=\"Link to this section\" data-route=\"#how-versions-work\">#\u003C\u002Fa>How versions work\u003C\u002Fh2>\n\u003Cp>Most projects never need versions. Their pages are right in \u003Ccode>docs\u002F\u003C\u002Fcode>, and Clay shows no version switcher.\u003C\u002Fp>\n\u003Cp>With versions, each version has a folder of its own inside \u003Ccode>docs\u002F\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cdiv class=\"file-tree not-prose\">\u003Cul>\u003Cli>\u003Cdetails open=\"\">\u003Csummary class=\"file-tree-entry file-tree-folder\">\u003Ci class=\"fa-solid fa-chevron-right file-tree-chevron\" aria-hidden=\"true\">\u003C\u002Fi>\u003Ci class=\"fa-solid fa-folder-open file-tree-open\" aria-hidden=\"true\">\u003C\u002Fi>\u003Ci class=\"fa-solid fa-folder file-tree-closed\" aria-hidden=\"true\">\u003C\u002Fi>\u003Cspan class=\"file-tree-name\">my-project\u003C\u002Fspan>\u003C\u002Fsummary>\u003Cul>\u003Cli>\u003Cspan class=\"file-tree-entry\">\u003Cspan class=\"file-tree-chevron\" aria-hidden=\"true\">\u003C\u002Fspan>\u003Ci class=\"fa-regular fa-file-code\" aria-hidden=\"true\">\u003C\u002Fi>\u003Cspan class=\"file-tree-name\">clay.yaml\u003C\u002Fspan>\u003Cspan class=\"file-tree-comment\">version: \"3.x\" names the latest\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fli>\u003Cli>\u003Cdetails open=\"\">\u003Csummary class=\"file-tree-entry file-tree-folder\">\u003Ci class=\"fa-solid fa-chevron-right file-tree-chevron\" aria-hidden=\"true\">\u003C\u002Fi>\u003Ci class=\"fa-solid fa-folder-open file-tree-open\" aria-hidden=\"true\">\u003C\u002Fi>\u003Ci class=\"fa-solid fa-folder file-tree-closed\" aria-hidden=\"true\">\u003C\u002Fi>\u003Cspan class=\"file-tree-name\">docs\u003C\u002Fspan>\u003C\u002Fsummary>\u003Cul>\u003Cli>\u003Cdetails open=\"\">\u003Csummary class=\"file-tree-entry file-tree-folder\">\u003Ci class=\"fa-solid fa-chevron-right file-tree-chevron\" aria-hidden=\"true\">\u003C\u002Fi>\u003Ci class=\"fa-solid fa-folder-open file-tree-open\" aria-hidden=\"true\">\u003C\u002Fi>\u003Ci class=\"fa-solid fa-folder file-tree-closed\" aria-hidden=\"true\">\u003C\u002Fi>\u003Cspan class=\"file-tree-name\">latest\u003C\u002Fspan>\u003Cspan class=\"file-tree-comment\">the latest docs, at \u002F\u003C\u002Fspan>\u003C\u002Fsummary>\u003Cul>\u003Cli>\u003Cspan class=\"file-tree-entry\">\u003Cspan class=\"file-tree-chevron\" aria-hidden=\"true\">\u003C\u002Fspan>\u003Ci class=\"fa-brands fa-markdown\" aria-hidden=\"true\">\u003C\u002Fi>\u003Cspan class=\"file-tree-name\">index.md\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fli>\u003Cli>\u003Cspan class=\"file-tree-entry file-tree-folder\">\u003Cspan class=\"file-tree-chevron\" aria-hidden=\"true\">\u003C\u002Fspan>\u003Ci class=\"fa-solid fa-folder\" aria-hidden=\"true\">\u003C\u002Fi>\u003Cspan class=\"file-tree-name\">guides\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fli>\u003C\u002Ful>\u003C\u002Fdetails>\u003C\u002Fli>\u003Cli>\u003Cspan class=\"file-tree-entry file-tree-folder\">\u003Cspan class=\"file-tree-chevron\" aria-hidden=\"true\">\u003C\u002Fspan>\u003Ci class=\"fa-solid fa-folder\" aria-hidden=\"true\">\u003C\u002Fi>\u003Cspan class=\"file-tree-name\">2.x\u003C\u002Fspan>\u003Cspan class=\"file-tree-comment\">at \u002F2.x\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fli>\u003Cli>\u003Cspan class=\"file-tree-entry file-tree-folder\">\u003Cspan class=\"file-tree-chevron\" aria-hidden=\"true\">\u003C\u002Fspan>\u003Ci class=\"fa-solid fa-folder\" aria-hidden=\"true\">\u003C\u002Fi>\u003Cspan class=\"file-tree-name\">1.x\u003C\u002Fspan>\u003Cspan class=\"file-tree-comment\">at \u002F1.x\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fli>\u003C\u002Ful>\u003C\u002Fdetails>\u003C\u002Fli>\u003C\u002Ful>\u003C\u002Fdetails>\u003C\u002Fli>\u003C\u002Ful>\u003C\u002Fdiv>\n\u003Cul>\n\u003Cli>\u003Ccode>docs\u002Flatest\u002F\u003C\u002Fcode> is always the \u003Cstrong>latest\u003C\u002Fstrong> version. It lives at the root of the site: \u003Ccode>\u002Fguides\u002Fsetup\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>Every other folder in \u003Ccode>docs\u002F\u003C\u002Fcode> is an \u003Cstrong>older\u003C\u002Fstrong> version, a copy of \u003Ccode>docs\u002Flatest\u002F\u003C\u002Fcode> saved when that version was current. \u003Ccode>docs\u002F1.x\u002F\u003C\u002Fcode> lives under \u003Ccode>\u002F1.x\u003C\u002Fcode>: \u003Ccode>\u002F1.x\u002Fguides\u002Fsetup\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>All versions sit at the same depth\u003C\u002Fstrong>, so a path that leads out of the docs, like an \u003Ca href=\"\u002Fclay-example-repo\u002Fwriting\u002Fsnippets-and-variables\" data-route=\"\u002Fwriting\u002Fsnippets-and-variables\">include\u003C\u002Fa> of \u003Ccode>..\u002F..\u002F..\u002Fclay.yaml\u003C\u002Fcode>, works the same in each copy.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>This site works this way: its pages are in \u003Ccode>docs\u002Flatest\u002F\u003C\u002Fcode>, the docs of Clay 4 in \u003Ccode>docs\u002F4.x\u002F\u003C\u002Fcode> and those of Clay 3 in \u003Ccode>docs\u002F3.x\u002F\u003C\u002Fcode>, online at \u003Ca href=\"https:\u002F\u002Fclay-doc.github.io\u002Fclay-example-repo\u002F4.x\u002F\" target=\"_blank\" rel=\"noopener noreferrer\">\u003Ci class=\"fa-solid fa-arrow-up-right-from-square clay-external-icon\" aria-hidden=\"true\">\u003C\u002Fi>\u002F4.x\u003C\u002Fa> and \u003Ca href=\"https:\u002F\u002Fclay-doc.github.io\u002Fclay-example-repo\u002F3.x\u002F\" target=\"_blank\" rel=\"noopener noreferrer\">\u003Ci class=\"fa-solid fa-arrow-up-right-from-square clay-external-icon\" aria-hidden=\"true\">\u003C\u002Fi>\u002F3.x\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"saving-a-version\">\u003Ca class=\"heading-anchor\" href=\"#saving-a-version\" aria-label=\"Link to this section\" data-route=\"#saving-a-version\">#\u003C\u002Fa>Saving a version\u003C\u002Fh2>\n\u003Cdiv class=\"clay-steps\">\u003Col>\n\u003Cli>\u003Cp>\u003Cstrong>Save the latest docs\u003C\u002Fstrong>, right before the release changes them:\u003C\u002Fp>\n\u003Cdiv class=\"code-block is-terminal has-bar\">\u003Cdiv class=\"code-terminal\" aria-hidden=\"true\">\u003Cspan>\u003C\u002Fspan>\u003Cspan>\u003C\u002Fspan>\u003Cspan>\u003C\u002Fspan>\u003C\u002Fdiv>\u003Cpre class=\"shiki shiki-themes light-plus dark-plus\" style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4;--shiki-light-bg:#FFFFFF;--shiki-dark-bg:#1E1E1E\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line command\">\u003Cspan style=\"--shiki-light:#695221;--shiki-dark:#DCDCAA\">npx\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\"> clay\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\"> version\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\"> 2.x\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cbutton type=\"button\" class=\"copy-code btn btn-sm btn-square btn-ghost\" title=\"Copy code\" aria-label=\"Copy code\">\u003Ci class=\"fa-solid fa-copy\">\u003C\u002Fi>\u003C\u002Fbutton>\u003C\u002Fdiv>\n\u003Cp>This copies \u003Ccode>docs\u002Flatest\u002F\u003C\u002Fcode> to \u003Ccode>docs\u002F2.x\u002F\u003C\u002Fcode>. In \u003Ccode>clay edit\u003C\u002Fcode>, \u003Ckbd>V\u003C\u002Fkbd> does the same and switches the editor to the new version.\u003C\u002Fp>\n\u003Cp>A saved version keeps today’s text: in the copy, Clay fills in the \u003Ca href=\"\u002Fclay-example-repo\u002Fwriting\u002Fsnippets-and-variables\" data-route=\"\u002Fwriting\u002Fsnippets-and-variables\">variables\u003C\u002Fa> and writes out includes of files outside \u003Ccode>docs\u002Flatest\u002F\u003C\u002Fcode>, like \u003Ccode>config\u002F\u003C\u002Fcode> or \u003Ccode>docs\u002F_snippets\u002F\u003C\u002Fcode>. When the latest docs move on to a new version number, the old ones keep theirs.\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>\u003Cstrong>Label the latest docs\u003C\u002Fstrong> in \u003Ccode>clay.yaml\u003C\u002Fcode>. Without \u003Ccode>version\u003C\u002Fcode>, the switcher calls them “Latest”.\u003C\u002Fp>\n\u003Cdiv class=\"code-block has-title\">\u003Cdiv class=\"code-title\">\u003Ci class=\"fa-regular fa-file-lines\" aria-hidden=\"true\">\u003C\u002Fi>\u003Cspan>clay.yaml\u003C\u002Fspan>\u003C\u002Fdiv>\u003Cpre class=\"shiki shiki-themes light-plus dark-plus\" style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4;--shiki-light-bg:#FFFFFF;--shiki-dark-bg:#1E1E1E\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#800000;--shiki-dark:#569CD6\">version\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">: \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#A31515;--shiki-dark:#CE9178\">\"3.x\"\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cbutton type=\"button\" class=\"copy-code btn btn-sm btn-square btn-ghost\" title=\"Copy code\" aria-label=\"Copy code\">\u003Ci class=\"fa-solid fa-copy\">\u003C\u002Fi>\u003C\u002Fbutton>\u003C\u002Fdiv>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>\u003Cstrong>Update \u003Ccode>docs\u002Flatest\u002F\u003C\u002Fcode>\u003C\u002Fstrong> for the new release, commit and release. The old docs are online at \u003Ccode>\u002F2.x\u003C\u002Fcode> from the first build.\u003C\u002Fp>\n\u003C\u002Fli>\n\u003C\u002Fol>\n\u003C\u002Fdiv>\n\u003Cp>Version names become part of URLs, so they may contain letters, digits, \u003Ccode>.\u003C\u002Fcode>, \u003Ccode>-\u003C\u002Fcode> and \u003Ccode>_\u003C\u002Fcode>. \u003Ccode>latest\u003C\u002Fcode>, \u003Ccode>docs\u003C\u002Fcode>, \u003Ccode>_clay\u003C\u002Fcode> and \u003Ccode>_nuxt\u003C\u002Fcode> are reserved.\u003C\u002Fp>\n\u003Ch2 id=\"the-first-version\">\u003Ca class=\"heading-anchor\" href=\"#the-first-version\" aria-label=\"Link to this section\" data-route=\"#the-first-version\">#\u003C\u002Fa>The first version\u003C\u002Fh2>\n\u003Cp>While the pages are right in \u003Ccode>docs\u002F\u003C\u002Fcode>, the first \u003Ccode>clay version\u003C\u002Fcode> moves them into \u003Ccode>docs\u002Flatest\u002F\u003C\u002Fcode> before it saves the copy. It shows what it is about to do and asks first:\u003C\u002Fp>\n\u003Cdiv class=\"code-block is-terminal has-bar\">\u003Cdiv class=\"code-terminal\" aria-hidden=\"true\">\u003Cspan>\u003C\u002Fspan>\u003Cspan>\u003C\u002Fspan>\u003Cspan>\u003C\u002Fspan>\u003C\u002Fdiv>\u003Cpre class=\"shiki shiki-themes light-plus dark-plus\" style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4;--shiki-light-bg:#FFFFFF;--shiki-dark-bg:#1E1E1E\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">┌  Clay 5.1.0 · version\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">│\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">│  Clay keeps each version of the docs in a folder of its own inside docs\u002F:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">│\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">│    docs\u002Flatest\u002F  at \u002F     the latest docs: docs\u002F moves here (110 files)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">│    docs\u002F1.x\u002F     at \u002F1.x  a copy of docs\u002Flatest\u002F\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">│\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">│  Every version sits at the same depth, so paths that lead out of docs\u002F work in each copy.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">│\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">│  docs\u002Flatest\u002F is one level deeper than docs\u002F, so Clay changes these paths:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">│    docs\u002Flatest\u002Fwriting\u002Fsnippets.md: ..\u002F..\u002Fclay.yaml#variables → ..\u002F..\u002F..\u002Fclay.yaml#variables\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">│\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">│  These name paths in docs\u002F, which Clay does not change; point them into docs\u002Flatest\u002F if they mean the latest docs:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">│    .gitignore: docs\u002Fapi\u002F\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">│\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">│  Git keeps the history of the moved files. Commit the move on its own, so it is easy to review.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">│\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#000000;--shiki-dark:#D4D4D4\">◆  Go ahead? (y\u002FN)\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cbutton type=\"button\" class=\"copy-code btn btn-sm btn-square btn-ghost\" title=\"Copy code\" aria-label=\"Copy code\">\u003Ci class=\"fa-solid fa-copy\">\u003C\u002Fi>\u003C\u002Fbutton>\u003C\u002Fdiv>\n\u003Cul>\n\u003Cli>\u003Cstrong>Paths that lead out of \u003Ccode>docs\u002F\u003C\u002Fcode>\u003C\u002Fstrong> get one more \u003Ccode>..\u002F\u003C\u002Fcode>: includes, links, images and files in HTML. Paths within the docs move along and stay as they are.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ccode>favicon\u003C\u002Fcode> and \u003Ccode>navbar.logo\u003C\u002Fcode>\u003C\u002Fstrong> in \u003Ccode>clay.yaml\u003C\u002Fcode> follow when they point into \u003Ccode>docs\u002F\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Commands and lists\u003C\u002Fstrong> that name paths in \u003Ccode>docs\u002F\u003C\u002Fcode>, like \u003Ccode>generate\u003C\u002Fcode> in \u003Ccode>clay.yaml\u003C\u002Fcode>, \u003Ccode>.gitignore\u003C\u002Fcode> or the scripts in \u003Ccode>package.json\u003C\u002Fcode>, are listed for you to check: only you know whether they mean the latest docs.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Dates stay\u003C\u002Fstrong>: Clay reads “last updated” from git, which sees the move as a rename.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>In scripts and CI, where nobody can answer, add \u003Ccode>--yes\u003C\u002Fcode>. Without it, nothing changes.\u003C\u002Fp>\n\u003Cdiv class=\"markdown-alert markdown-alert-tip\">\n\u003Cp class=\"markdown-alert-title text-primary\">\u003Ci class=\"fa-solid fa-lightbulb mr-2\">\u003C\u002Fi>Tip\u003C\u002Fp>\n\u003Cp>Folders in \u003Ccode>docs\u002F\u003C\u002Fcode> that start with \u003Ccode>_\u003C\u002Fcode> are no versions. Snippets that every version shares can live in \u003Ccode>docs\u002F_snippets\u002F\u003C\u002Fcode>.\u003C\u002Fp>\n\u003C\u002Fdiv>\n\u003Ch2 id=\"the-version-switcher\">\u003Ca class=\"heading-anchor\" href=\"#the-version-switcher\" aria-label=\"Link to this section\" data-route=\"#the-version-switcher\">#\u003C\u002Fa>The version switcher\u003C\u002Fh2>\n\u003Cp>As soon as there is an older version, the navbar shows a version switcher, newest first. Switching keeps the page you are reading when the other version has it, and otherwise opens that version’s start page. It keeps the \u003Ca href=\"\u002Fclay-example-repo\u002Forganizing\u002Ftranslations\" data-route=\"\u002Forganizing\u002Ftranslations\">language\u003C\u002Fa> too.\u003C\u002Fp>\n\u003Cp>Pages of older versions show a banner that says which version they belong to and links to the same page in the latest version.\u003C\u002Fp>\n\u003Ch2 id=\"what-each-version-has-of-its-own\">\u003Ca class=\"heading-anchor\" href=\"#what-each-version-has-of-its-own\" aria-label=\"Link to this section\" data-route=\"#what-each-version-has-of-its-own\">#\u003C\u002Fa>What each version has of its own\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>\u003C\u002Fth>\n\u003Cth>Per version\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Pages, images and files\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>docs\u002F<name>\u002F\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Start page, folder titles, icons and order\u003C\u002Ftd>\n\u003Ctd>The version’s \u003Ccode>index.md\u003C\u002Fcode> files\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Search index\u003C\u002Ftd>\n\u003Ctd>Results stay within the version\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Edit links\u003C\u002Ftd>\n\u003Ctd>Lead into \u003Ccode>docs\u002F<name>\u002F\u003C\u002Fcode>, when \u003Ccode>editURL\u003C\u002Fcode> ends in \u003Ccode>docs\u002F\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Translations\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>*.de.md\u003C\u002Fcode> files inside the version’s folder\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca href=\"\u002Fclay-example-repo\u002Forganizing\u002Fredirects\" data-route=\"\u002Forganizing\u002Fredirects\">Redirects\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Stay within the version\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Ccode>clay.yaml\u003C\u002Fcode> is shared: all versions have the same title and navbar.\u003C\u002Fp>\n\u003Ch2 id=\"editing-older-versions\">\u003Ca class=\"heading-anchor\" href=\"#editing-older-versions\" aria-label=\"Link to this section\" data-route=\"#editing-older-versions\">#\u003C\u002Fa>Editing older versions\u003C\u002Fh2>\n\u003Cp>Older versions are plain files: fix a typo in \u003Ccode>docs\u002F1.x\u002F\u003C\u002Fcode> like anywhere else, or switch \u003Ccode>clay edit\u003C\u002Fcode> to the version with \u003Ckbd>v\u003C\u002Fkbd>. Links inside an older version stay in that version, as long as they are relative: \u003Ccode>[Setup](setup.md)\u003C\u002Fcode> links to \u003Ccode>\u002F1.x\u002Fsetup\u003C\u002Fcode>. Links starting with \u003Ccode>\u002F\u003C\u002Fcode> lead to the latest version.\u003C\u002Fp>\n\u003Cdiv class=\"markdown-alert markdown-alert-note\">\n\u003Cp class=\"markdown-alert-title text-base-content\">\u003Ci class=\"fa-solid fa-sticky-note mr-2\">\u003C\u002Fi>Note\u003C\u002Fp>\n\u003Cp>Each saved version adds its pages to the build. Keep the versions your users actually run, and delete the folders of versions nobody uses anymore.\u003C\u002Fp>\n\u003C\u002Fdiv>\n",[6,10,13,16,19,22],{"id":7,"text":8,"level":9},"how-versions-work","How versions work",2,{"id":11,"text":12,"level":9},"saving-a-version","Saving a version",{"id":14,"text":15,"level":9},"the-first-version","The first version",{"id":17,"text":18,"level":9},"the-version-switcher","The version switcher",{"id":20,"text":21,"level":9},"what-each-version-has-of-its-own","What each version has of its own",{"id":23,"text":24,"level":9},"editing-older-versions","Editing older versions","Keep the docs of older releases online, with a version switcher and a banner that leads to the latest docs.",null,false,"\u002F_clay\u002Fsocial\u002Forganizing\u002Fversions.png",1792666370098]