summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorYuriy Andamasov <yuriy@vyos.io>2026-05-07 15:17:05 +0300
committerGitHub <noreply@github.com>2026-05-07 15:17:05 +0300
commitaaa84557afce543050664e1e23d745bc602db56a (patch)
tree6fdb863a27cb61cff337793ee43e593e577e2385
parent3e26140016eac9304437b25f62ba9ca8fd4dc206 (diff)
parent939496f90f4268b240b2b56bcb527adc4f3a5797 (diff)
downloadvyos-documentation-aaa84557afce543050664e1e23d745bc602db56a.tar.gz
vyos-documentation-aaa84557afce543050664e1e23d745bc602db56a.zip
Merge pull request #1916 from vyos/chore/docs-claude-md-fix-formatting
docs(claude-md): fix llms.txt backtick, redirect aliases, template path examples
-rw-r--r--CLAUDE.md13
1 files changed, 8 insertions, 5 deletions
diff --git a/CLAUDE.md b/CLAUDE.md
index ae0c16f5..f4759273 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -191,7 +191,7 @@ A PR that both adds and removes TODOs is not contradictory; intent matters.
Both files are regenerated on every `html` and `readthedocs` builder run.
The `dirhtml` builder is intentionally skipped — production publishes
-only via `html`/`readthedocs`, and we don't render llms.txt for builds
+only via `html`/`readthedocs`, and we don't render `llms.txt` for builds
we don't ship. Local `make dirhtml` is a developer convenience and
won't emit `llms.txt`.
@@ -209,11 +209,13 @@ Files are shipped at the docs root for each version
When adding new top-level sections to the docs, add a corresponding bullet in
`docs/_templates/llms.txt.j2`. Branch-specific differences (e.g. sagitta has
-no `vpp/` or `contributing/index`) live in that branch's copy of the template.
+no `vpp/index.md` or `contributing/index.md`) live in that branch's copy of the template.
## Read the Docs Layout
-RTD slugs as of 2026-05-04 (verified via API):
+RTD slugs as of 2026-05-04 (verified via API). Re-verify via the RTD
+Versions API (project `vyos`) and update the date stamp before editing this
+table.
| Slug | Verbose | Branch | Role |
|---|---|---|---|
@@ -224,8 +226,9 @@ RTD slugs as of 2026-05-04 (verified via API):
URL-level redirect aliases (resolve to the canonicals above):
`/en/latest/* → /en/rolling/`, `/en/lts/* → /en/1.5/`,
-`/en/stable/* → /en/lts/`, `/en/circinus*`, `/en/sagitta*`,
-`/en/equuleus*`, `/en/crux*` → numeric slugs.
+`/en/stable/* → /en/lts/`, `/en/circinus/* → /en/1.5/`,
+`/en/sagitta/* → /en/1.4/`, `/en/equuleus/* → /en/1.3/`,
+`/en/crux/* → /en/1.2/`.
`html_baseurl` per branch must point at the canonical (numeric or `rolling`),
not the alias, so `<link rel="canonical">` and the sitemap match what RTD