docs: serve an llms.txt index of the documentation - #1939
Draft
ghostiee-11 wants to merge 4 commits into
Draft
Conversation
Zensical copies static files from docs/ to the site root, so this needs no build changes. A test keeps the link list in sync with the pages that actually exist.
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## main #1939 +/- ##
==========================================
+ Coverage 72.32% 72.37% +0.04%
==========================================
Files 203 204 +1
Lines 35666 35714 +48
==========================================
+ Hits 25796 25848 +52
+ Misses 9870 9866 -4 ☔ View full report in Codecov by Harness. 🚀 New features to boost your workflow:
|
Contributor
|
Let's wait for https://github.com/holoviz/hvplot/pull/1732/changes to settle |
ahuang11
marked this pull request as draft
July 21, 2026 22:41
Collaborator
Author
|
Okay!! |
Replaces the hand-written docs/llms.txt with a build step, following the approach in holoviz/hvplot#1732. The zensical nav is the single source of truth, so pages and labels can never drift from the site, and the linked markdown is mirrored under /markdown so an LLM can fetch the prose without parsing the rendered HTML.
ghostiee-11
marked this pull request as ready for review
July 24, 2026 17:20
The tutorials index links seven tutorials but the nav only carried four, so the rest were published without a sidebar entry and were skipped by llms.txt, which is generated from the nav. Labels match the index page.
Contributor
|
Do you have an example artifact I can look at |
Collaborator
Author
Contributor
Is this necessary for the LLM to know? And is it named These markdown files should help the LLM develop (think of it like a CLAUDE.md file). |
Contributor
|
Let's wait until holoviz-dev/nbsite#361 is merged |
ahuang11
marked this pull request as draft
August 4, 2026 16:08
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.

LLM assistants now handle a large share of the "which library should I use for this" questions that used to go to search, and they read a site far better when it publishes a curated index than when they have to crawl it. llms.txt is the convention for that. marimo and Vizro both serve one. No HoloViz site does.
This adds
docs/llms.txt.