Structuring API Reference So an Agent Can Call It Without Reformatting
Design APIs with explicit schemas so agents can call them reliably.
Yara Salcedo
Yara Salcedo
11 stories
Bundled AI Doc Platforms vs Bolting AI onto an Existing Stack
Bundled platforms prevent architectural gaps that bolt-on tools can't fix.
Yara Salcedo
Knowledge Graph Construction From Documentation Content
Extracting structured knowledge from messy docs requires resolving entities, not just reading text.
Yara Salcedo
MDX-Based Documentation Platforms Compared
MDX platforms split into self-hosted frameworks and managed SaaS services for different team needs.
Yara Salcedo
Chunking Documentation for RAG Pipelines
Chunking strategy matters more than embedding model choice.
Yara Salcedo
Semantic Search Optimization for Documentation Sites
Semantic search matches user intent with docs by meaning, not just keywords.
Yara Salcedo
Building a RAG Pipeline Over Documentation with LangChain
Learn where RAG pipelines fail silently and how to avoid those early mistakes with LangChain.
Yara Salcedo
In-Product AI Assistance Powered by Documentation
Strong documentation structure determines whether AI assistance actually solves problems.
Yara Salcedo
SDKs vs Direct API Calls in Documentation Strategy
Documentation strategy succeeds when someone decides SDK-versus-direct-API before building the docs.
Yara Salcedo
OpenAPI Spec as the Single Source of Truth
Keeping your OpenAPI spec aligned with reality requires more than good intentions.
Yara Salcedo
Git-connected documentation platforms for API teams
How Git-connected platforms prevent API documentation from drifting out of sync.
Yara Salcedo