Skip to content

chore: improve llms and seo discoverability - #29

Closed
nibzard wants to merge 2 commits into
mainfrom
niko/llms
Closed

chore: improve llms and seo discoverability#29
nibzard wants to merge 2 commits into
mainfrom
niko/llms

Conversation

@nibzard

@nibzard nibzard commented Mar 27, 2026

Copy link
Copy Markdown
Contributor

Summary

Improve docs discoverability for both search engines and coding agents.

This PR:

  • adds a standard alternate head link for /llms.txt
  • improves dynamic docs metadata with canonical, Open Graph, and Twitter fields
  • updates the root llms.txt generator with a stronger intro, top-level section ordering, and an optional link to /llms-full.txt
  • adds an Instructions for AI Agents card to the overview resources section
  • fixes robots.txt host/sitemap entries for docs.steel.dev

Why

The docs site had a few missed discoverability signals:

  • docs pages only returned title and description
  • robots.txt still pointed at an old Hiro host
  • llms.txt existed, but was not surfaced as clearly as it could be from metadata, docs navigation, or its generated contents

Impact

  • Better canonical and social metadata coverage across doc pages
  • Clearer agent-facing discovery via /llms.txt and /llms-full.txt
  • Better overview-page entry point for agents landing on the docs UI
  • Correct crawler metadata in robots.txt

Validation

  • bun run check
  • bun run generate-llms

@vercel

vercel Bot commented Mar 27, 2026

Copy link
Copy Markdown
Contributor

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

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Mar 27, 2026 5:48pm

Request Review

@nibzard
nibzard marked this pull request as ready for review March 27, 2026 17:47
@nibzard
nibzard requested review from hussufo and junhsss March 27, 2026 17:47
@nibzard nibzard changed the title [codex] improve llms and seo discoverability feat: improve llms and seo discoverability Mar 27, 2026
@nibzard nibzard changed the title feat: improve llms and seo discoverability chore: improve llms and seo discoverability Mar 27, 2026
@nibzard nibzard closed this Mar 31, 2026
@nibzard
nibzard deleted the niko/llms branch March 31, 2026 14:47
hussufo added a commit that referenced this pull request Jun 12, 2026
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