Skip to content

docs: more fixes for afdocs - #216

Merged
damirka merged 9 commits into
mainfrom
even-more-afdocs
May 5, 2026
Merged

docs: more fixes for afdocs#216
damirka merged 9 commits into
mainfrom
even-more-afdocs

Conversation

@jessiemongeon1

@jessiemongeon1 jessiemongeon1 commented May 4, 2026

Copy link
Copy Markdown
Collaborator

⏺ Summary of all changes in ~/move-book:

Fix 2 — content-negotiation:

  • site/src/plugins/llms-txt.ts: Added content-negotiation middleware that
    checks Accept: text/markdown and serves .md files
  • site/serve-with-rewrites.js: New production test server with content
    negotiation

Fix 3 — markdown-code-fence-validity:

  • reference/index-syntax.md:104: Fixed 4-backtick typo to 3 backticks
  • site/src/plugins/llms-txt.ts: Added stripHtmlComments() to remove HTML
    comments from exported markdown (fixed the struct-methods.md
    fence-inside-comment issue)

Fix 4 — llms-txt-coverage:

  • book/sidebar.yml: Added link to Guides category, uncommented
    open-sourcing-libraries, added 6 programmability pages
  • reference/sidebar.yml: Made Abilities a category with abilities/object
    sub-item
  • site/src/plugins/llms-txt.ts: Added /search page to llms.txt and generates
    search.md

Fix 5 — llms-txt-directive:

  • site/src/plugins/llms-txt.ts: Moved
    move.ebnf/move-semantics.md/llms-full.txt into the blockquote description so
    they aren't sampled as doc pages for directive checking

Comment thread site/serve-with-rewrites.js Fixed
Comment thread site/serve-with-rewrites.js Fixed
Comment thread site/serve-with-rewrites.js Dismissed
Comment thread site/serve-with-rewrites.js Fixed
Comment thread site/serve-with-rewrites.js Fixed
Comment thread site/serve-with-rewrites.js Fixed
Comment thread site/serve-with-rewrites.js Dismissed
Comment thread site/serve-with-rewrites.js Dismissed
Comment thread site/src/plugins/llms-txt.ts Fixed
Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
Comment thread site/serve-with-rewrites.js Dismissed
Comment thread site/serve-with-rewrites.js Dismissed
Comment thread site/serve-with-rewrites.js Dismissed
Comment thread site/serve-with-rewrites.js Dismissed
Comment thread site/serve-with-rewrites.js Fixed
jessiemongeon1 and others added 4 commits May 4, 2026 12:15
…ed in path expression'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
…ed in path expression'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
…ed in path expression'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
Comment thread site/serve-with-rewrites.js Dismissed
Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
@jessiemongeon1
jessiemongeon1 requested a review from damirka May 4, 2026 17:39
Comment thread book/sidebar.yml
Comment thread book/sidebar.yml
Comment thread reference/sidebar.yml Outdated

@damirka damirka left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

llms-txt is alright, I'm not sure how the "serve-with-rewrites.js" is used

@jessiemongeon1

Copy link
Copy Markdown
Collaborator Author

@damirka serve-with-rewrites.js is used for content negotiation where the same URL returns different content based on Accept: text/markdown.

@damirka
damirka merged commit 3a0d7ee into main May 5, 2026
6 checks passed
@damirka
damirka deleted the even-more-afdocs branch May 5, 2026 15:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants