Field notes for people who make technical products easier to use.
Follow the systems, standards, and editorial practices changing how documentation teams publish,
maintain, and prepare product knowledge for people and AI tools.
Reporting grounded in the work of documentation teams
Browse the published roundups. Each one distills the strongest signals into practical
implications for writers, documentation leads, and developer education teams.
Journeys replace silos, unanswered questions become evidence, and agent interfaces get inspectable
Why docs teams are replacing content silos with reader journeys, treating failed AI answers as editorial evidence, and making agent interfaces inspectable.
Publishing gets a recovery plan, editing becomes multiplayer, and API references outgrow one format
Why mature docs operations now need fast rollback, conflict-safe collaboration, and a reference architecture that can span REST, events, GraphQL, and agent tools.
Docs become queryable endpoints, setup leaves the browser, and measurement splits in two
Why docs teams now need to own machine-facing endpoints, automation-friendly setup, and a cleaner split between content-improvement metrics and executive-proof metrics.