Skip to content

docs: refresh the homepage, add blog feeds, make the docs agent-readable - #172

Merged
egeominotti merged 1 commit into
mainfrom
docs/home-refresh
Oct 25, 2026
Merged

egeominotti merged 1 commit into
mainfrom
docs/home-refresh

Conversation

@egeominotti

Copy link
Copy Markdown
Owner

Summary

Homepage

  • Every headline in Inter with tight tracking (same typeface as the docs); condensed Bricolage Grotesque removed (package, preload, CSS).
  • Hero: one announcement (newest release post), muted second sentence, actions under the subtitle. FAQ chevrons on the right, footer links in Inter, docs-style code copy buttons, no "Edit page"/"Last updated".
  • MCP tool count fixed: 79 primary tools in 11 toolsets (the homepage said 75; test/mcp-catalog-measurement.test.ts asserts 79).

Docs readable by AI agents

  • /llms-full.txt and every /<page>.md twin are plain Markdown via docs/src/lib/agent-markdown.ts (imports, JSX and layout HTML removed; tabs → bold labels, asides → blockquotes, cards → titles/links; absolute links). Applied after the existing inlineRawCodeImports/inlineFirstJobCode, which are unchanged.

    Outside code in llms-full.txt Before After
    <div> 957 0
    class="…" 1,448 0
    import lines 97 0
    <Tabs>/<TabItem> tags 2,272 0
    hero blocks 334 0
    code fence lines 3,312 3,312
  • llms.txt lists all 114 pages (was 62), explains the .md twins and the Queue/Worker mode rule; its quick example now passes embedded: true to the worker (without it the worker connected over TCP).

Blog feeds

  • /rss.xml (all posts) and /blog/releases.xml (releases only), auto-discoverable, with category, author, version-ordered same-day releases and lastBuildDate from the newest post. Subscribe links under the blog title and in every post.

Verification

  • bun run build in docs/ + validate-discovery: "Discovery outputs OK: 114 full-text pages, 385 sitemap URLs, 6 inlined sources"
  • Every fenced block in the 114 page sources (1,591) survives the converter byte for byte (scratch check)
  • Docs tests (the docs-only CI selection, 22 files): 220 pass / 0 fail; generate-release-posts.ts --check OK; both feeds are well-formed XML
  • Screenshots: homepage light/dark/mobile, blog index and post

No version bump, no source or test changes.

🤖 Generated with Claude Code

Homepage: set every headline in Inter with tight tracking instead of condensed
Bricolage Grotesque (font package, preload and CSS removed), keep one hero
announcement (the newest release post), mute the headline's second sentence,
put the actions under the subtitle, give FAQ questions a right-hand chevron,
set footer links in Inter, match the docs' code copy buttons, hide "Edit page"
and "Last updated", and fix the MCP tool count (79, not 75).

Agents: /llms-full.txt and every /<page>.md twin are now plain Markdown.
docs/src/lib/agent-markdown.ts removes imports, exports, MDX comments and
layout HTML, turns tabs into bold labels, asides and :::note into blockquotes,
cards into titles and links, keeps only the hero summary, notes interactive
widgets and makes root-relative links absolute. Code blocks are untouched:
3,312 fence lines before and after. llms.txt lists all 114 pages (was 62),
explains the .md twins and the Queue/Worker mode rule, and its quick example
creates the worker with embedded: true.

Blog: two RSS feeds (/rss.xml and /blog/releases.xml) with categories,
authors, version-ordered same-day releases and lastBuildDate from the newest
post; subscribe links under the blog title and in every post.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Oct 25, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Oct 25, 2026 2:52pm UTC

@claude

claude Bot commented Oct 25, 2026

Copy link
Copy Markdown

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@egeominotti
egeominotti merged commit ba04cf3 into main Oct 25, 2026
25 checks passed
@egeominotti
egeominotti deleted the docs/home-refresh branch October 29, 2026 21:59

This branch was successfully deployed

1 active deployment
Preview — 3e5e4c12 Deployed Oct 25, 2026 by vercel[bot]
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.

1 participant