Repository navigation
site: publish per-page Markdown and fix llms.txt and llms-full.txt - #3435
Merged
Benjamin Elder (BenTheElder) merged 3 commits intoOct 30, 2026
Merged
Conversation
raw-markdown.html wrote to an HTML template buffer and expanded include-file with replaceRE. That HTML-escaped code blocks and blockquotes in llms-full.txt and "Copy as Markdown", and stripped $VAR shell references as regexp capture groups. Return a plain string, replace include-file literally, drop decorative diagram HTML, and rewrite relative links to absolute URLs across llms-full.txt, "Copy as Markdown", and the new per-page index.md output format. Update llms.txt to link to each page's index.md build, include page status tags, link the protobuf, CRD, and metric schemas, and summarize the sandbox model and the split between ate.dev/v1 CRDs and the ate-api-server gRPC API. Replace leftover ateom and ate-api references with ateworker, atenet-router, and ate-api-server. Signed-off-by: Mofi Rahman <[email protected]>
Mofi Rahman (moficodes)
added
the
kind/docs
Remove leftover references to the retired "herder" term from the overview diagram, architecture guide, and WorkerPool API documentation. Signed-off-by: Mofi Rahman <[email protected]>
Link kind to https://kind.sigs.k8s.io/ in the overview and quickstart pages, and use lowercase kind consistently there and on the 404 card. Signed-off-by: Mofi Rahman <[email protected]>
Benjamin Elder (BenTheElder)
approved these changes
Oct 30, 2026
1 of 2 tasks
Dmitry Berkovich (dberkov)
pushed a commit
that referenced
this pull request
Nov 2, 2026
…3435) `ate.dev/llms.txt` linked to full Docsy HTML pages instead of standalone Markdown files, omitted page status markers and schema links, and still used the old `ateom` component name. Meanwhile, `raw-markdown.html` wrote into an HTML template buffer and expanded `include-file` with `replaceRE`, which HTML-escaped code blocks and blockquotes across `ate.dev/llms-full.txt` and "Copy as Markdown" (`'`, `"`, `>`), stripped `$VAR` shell references as regexp capture groups, left relative links unrewritten, and kept decorative `<figure>` HTML blocks. - Add the `MARKDOWN` output format for doc pages (`site/layouts/docs/single.md`) so each page publishes a clean `index.md` alongside `index.html` and exposes `<link rel="alternate" type="text/markdown">` in `<head>`. - Return a plain string from `raw-markdown.html`, expand `include-file` with literal replacement, drop decorative diagram HTML, and rewrite relative links to absolute URLs across `llms-full.txt`, per-page `index.md`, and "Copy as Markdown". - Update `index.llms.txt` to link to each page's `index.md` build, include `[Status: ...]` labels from front matter, link the `ateapi.proto`, `ate.dev/v1` CRD, and OpenTelemetry Weaver metric schemas, and summarize the sandbox model and the split between `ate.dev/v1` Kubernetes CRDs and the `ate-api-server` gRPC API. - Replace leftover `ateom`, `ate-api`, and `herder` references in docs with `ateworker`, `atenet-router`, and `ate-api-server`, and add template tests in `hack/test-site-templates.sh`. AI use: AI-assisted, I reviewed and tested it. - [x] Tests pass - [x] Docs updated --------- Signed-off-by: Mofi Rahman <[email protected]> (cherry picked from commit 61ea6c6) Signed-off-by: Eitan Yarmush <[email protected]>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
ate.dev/llms.txtlinked to full Docsy HTML pages instead of standalone Markdown files, omitted page status markers and schema links, and still used the oldateomcomponent name. Meanwhile,raw-markdown.htmlwrote into an HTML template buffer and expandedinclude-filewithreplaceRE, which HTML-escaped code blocks and blockquotes acrossate.dev/llms-full.txtand "Copy as Markdown" (',",>), stripped$VARshell references as regexp capture groups, left relative links unrewritten, and kept decorative<figure>HTML blocks.MARKDOWNoutput format for doc pages (site/layouts/docs/single.md) so each page publishes a cleanindex.mdalongsideindex.htmland exposes<link rel="alternate" type="text/markdown">in<head>.raw-markdown.html, expandinclude-filewith literal replacement, drop decorative diagram HTML, and rewrite relative links to absolute URLs acrossllms-full.txt, per-pageindex.md, and "Copy as Markdown".index.llms.txtto link to each page'sindex.mdbuild, include[Status: ...]labels from front matter, link theateapi.proto,ate.dev/v1CRD, and OpenTelemetry Weaver metric schemas, and summarize the sandbox model and the split betweenate.dev/v1Kubernetes CRDs and theate-api-servergRPC API.ateom,ate-api, andherderreferences in docs withateworker,atenet-router, andate-api-server, and add template tests inhack/test-site-templates.sh.AI use: AI-assisted, I reviewed and tested it.