Skip to content

fix(agent-docs): include hero title in markdown endpoint for parity#198

Merged
marc0olo merged 1 commit intomainfrom
infra/agent-docs-parity-fix
May 5, 2026
Merged

fix(agent-docs): include hero title in markdown endpoint for parity#198
marc0olo merged 1 commit intomainfrom
infra/agent-docs-parity-fix

Conversation

@marc0olo
Copy link
Copy Markdown
Member

@marc0olo marc0olo commented May 5, 2026

Closes part of #181 (markdown-content-parity).

Summary

  • Starlight splash pages render hero.title (and hero.tagline if present) in the HTML, but these fields live in frontmatter and are not part of the content body — so they were absent from the generated .md endpoint.
  • The cleanMarkdown() function in plugins/astro-agent-docs.mjs now extracts hero.title and hero.tagline and inserts them between the page title heading and the llms.txt directive, matching what agents see in the HTML.
  • Verified locally: dist/index.md now starts with # Build on the Internet ComputerThe Network is The Cloud. Agents Build. → llms.txt directive → body content.
  • Build passes cleanly.

Sync recommendation

hand-written

@marc0olo marc0olo requested a review from a team as a code owner May 5, 2026 11:03
@marc0olo marc0olo merged commit 634501f into main May 5, 2026
6 checks passed
@marc0olo marc0olo deleted the infra/agent-docs-parity-fix branch May 5, 2026 11:08
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.

2 participants