Skip to content

[codex] Improve docs AI visibility#1

Closed
ifrederico wants to merge 1 commit into
mainfrom
codex/ai-visibility-docs
Closed

[codex] Improve docs AI visibility#1
ifrederico wants to merge 1 commit into
mainfrom
codex/ai-visibility-docs

Conversation

@ifrederico

Copy link
Copy Markdown
Contributor

Summary

  • Fixes llms.txt links and adds the 10 priority tea documentation URLs.
  • Expands Mintlify product content with category intros, structured tea entries, and 10 dedicated tea sub-pages.
  • Adds JSON-LD schema for brewing guides, tea article pages, and contact LocalBusiness data, plus a local validation script.

Why

The docs site had crawlable structure but thin product prose and broken llms.txt links. This makes the Mintlify docs more discoverable, extractable, and citation-friendly for AI search and LLM crawlers.

Validation

  • node scripts/validate-ai-visibility.mjs
  • npx --yes mintlify@latest validate
  • git diff --check
  • Local Mintlify preview checks for llms.txt, priority tea routes, and rendered JSON-LD source

Post-deploy checks

  • Verify production https://docs.tecompanytea.com/llms.txt now serves the new text/plain file.
  • Verify all new /products/tea/{slug} production URLs return 200.
  • Verify production sitemap.xml includes the 10 new pages.
  • Run the key production URLs through Google Rich Results Test and Schema.org validator.

@ifrederico ifrederico closed this May 16, 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