Skip to content

Comments

Add better agent discoverability#1733

Merged
mirekm merged 6 commits intomainfrom
feature/md
Jan 21, 2026
Merged

Add better agent discoverability#1733
mirekm merged 6 commits intomainfrom
feature/md

Conversation

@mirekm
Copy link
Member

@mirekm mirekm commented Jan 17, 2026

AI Agent Discoverability

Added resources to make Saleor documentation easily discoverable by AI agents and LLMs.

Changes

1. New file: static/llms.txt

A structured documentation index for AI agents, served at https://docs.saleor.io/llms.txt.

Contains:

  • Quick links (docs, GitHub, GraphQL schema)
  • Complete documentation map organized by section
  • URL patterns for accessing raw MDX source files

2. Enhanced: docs/developer/ai.mdx

Expanded the AI integration page with:

  • Proper frontmatter (title, description, tags)
  • "For AI Agents" section with explicit URL patterns
  • Key entry points table with full public URLs + raw MDX links
  • Reorganized MCP configuration section

Why

  • No llms.txt existed — now AI agents have a standard entry point
  • Existing AI page lacked context for automated discovery
  • Relative MDX links were confusing for LLMs reading raw files — now uses explicit full URLs

Files

@mirekm mirekm requested a review from a team as a code owner January 17, 2026 14:04
@vercel
Copy link

vercel bot commented Jan 17, 2026

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

Project Deployment Review Updated (UTC)
saleor-docs Ready Ready Preview, Comment Jan 21, 2026 2:37pm

Request Review

peelar
peelar previously approved these changes Jan 19, 2026
lkostrowski
lkostrowski previously approved these changes Jan 20, 2026
NyanKiyoshi
NyanKiyoshi previously approved these changes Jan 20, 2026
@mirekm mirekm merged commit 6a1f88b into main Jan 21, 2026
9 checks passed
@mirekm mirekm deleted the feature/md branch January 21, 2026 14:46
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.

4 participants