justinmclean opened a new pull request, #79:
URL: https://github.com/apache/iggy-website/pull/79

   > Stacked on #77 as it edits `llms.txt`, so it needs that one merged first.
   
   An agent that wants a docs page has to parse the rendered HTML today. This 
writes a Markdown copy next to each page at build time, so 
`/docs/server/security/` is also available as `/docs/server/security.md`.
   
   - `scripts/generate-docs-markdown.mjs` runs in `prebuild` after the stars 
fetch and rewrites the copies from `content/docs` on every build. Generated 
files are gitignored, like `src/github-stars.json`, so they can't drift from 
the source.
   - Each docs page advertises its copy with `<link rel="alternate" 
type="text/markdown">`, and `llms.txt` states the convention.
   - The `.md` files aren't in the sitemap. They're page alternates, not pages.
   
   `npm run build`, then: 76 `.md` files in `out/`, the `rel="alternate"` and 
`rel="canonical"` links both present on a docs page, `index.html` count 
unchanged, and `git status` clean.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to