Renata Haddad

Connecting documentation pages reveals relationships that flat search indexes can't find.

AI agents can update their knowledge mid-conversation instead of relying on frozen training data.

Rebuilding workflows for AI collaboration matters more than which tools you choose.

Real GitHub integration means docs stay current with code, not just linked to it.

Automated code samples eliminate the trust damage when developers find errors in your docs.

Choose the right tool to auto-generate your API docs from specs.

Teams adopted Git for docs in job postings but haven't implemented the actual workflow.

AI speeds technical writing when verification is built into the workflow from the start.

Your markup language choice will shape tooling, contributors, and future migrations for years.

Different AI crawlers extract value differently, and blocking one doesn't block them all.

A plain-text file helps AI systems navigate the web more efficiently than traditional crawling.

LLMs hallucinate on unfamiliar documentation, and measurement reveals why.

Stale training data makes AI confident about outdated APIs with no internal warning signal.

Organize documentation by how LLMs will chunk and retrieve it, not just for human readers.

A minimal specification for helping AI agents navigate your documentation efficiently.