Context
Give the system the right source, version, audience, permissions, and task context.
Latest field notes
Thinking about documentation as the knowledge layer behind AI
My perspective on how documentation architecture, engineering workflows, and AI systems fit together.
My point of view
AI quality depends on the knowledge system behind the answer
AI does not make documentation architecture less important. It makes the underlying choices visible: which source is trusted, what context is available, how an agent is guided, and how a team knows when an answer is wrong. I think about documentation as the maintained knowledge layer that connects product change to useful answers for people and AI.
Read the architectureSkills
Keep agent instructions scoped, versioned, and connected to authoritative documentation.
Harnesses
Test realistic user tasks for retrieval quality, grounding, and reliable completion.
Traces
Inspect sources, context, tools, and outputs to locate where a failure entered the flow.
Documentation Systems
GitHub for writers: Navigating pull request reviews
Learn how pull request reviews work in GitHub. Understand review comments, approvals, requested changes, and how technical writers collaborate confidently using GitHub workflows.
GitHub for writers: Branches and Pull Requests
Learn Git branches and pull requests for documentation. Master the complete workflow from creating branches to submitting PRs—no command line required.
GitHub for Documentation: The Complete Guide for Technical Writers
Master GitHub for documentation with this step-by-step guide. Learn version control, collaboration, and docs-as-code workflows without touching the command line.
Create Your First Docusaurus Documentation Website
Learn how to create a professional Docusaurus documentation website from scratch. This step-by-step tutorial covers setup, configuration, and deployment for beginners.
How to Install Vale Linter in VS Code for Documentation (2026 Guide)
Set up Vale linter in VS Code to automatically check documentation for style, grammar, and consistency issues. Includes CI hooks and contributor setup.
Docusaurus Multiple Sidebars: Complete Setup Guide with Code Examples
Learn to set up multiple sidebars in Docusaurus for multi-product documentation portals. Step-by-step guide with code examples and best practices.
AI & Documentation
How to Make Your Documentation AI-Ready
Learn how to prepare documentation for AI search, RAG, and agents: audit sources, improve structure, manage context, and test answers.
How to Write User-Focused Documentation
Learn how to create effective user-focused documentation with practical tips on developing user personas, mapping content to the user's journey, and incorporating a feedback loop. Enhance your documentation to better support and guide users through their experience.
Should You Migrate Your Documentation System — and Is It AI-Ready?
Is my documentation AI-ready? Scalable, AI-native docs require more than great writing — they need systems built for scale, reuse, and machine understanding.
Developer Experience
How to Create Java Micronaut Microservice?
Micronaut is a modern, JVM based framework to build Microservices. Get started and build your first Java Micronaut Microservice.
Python for Mobile App Development: An In-Depth Look at Popular Frameworks
Learn how to create powerful, cross-platform mobile apps using Python with our in-depth guide. Discover the best frameworks, libraries, and tools for building mobile apps with Python. Optimize for SEO and improve your app's discoverability.
Set JAVA_HOME on Windows, Mac, Linux and Unix
Learn the step-by-step process of setting JAVA_HOME environment variable on different operating systems such as Mac, Windows, Linux, and Unix. Ensure smooth running of Java applications by correctly setting JAVA_HOME with this easy guide.
How to Design User Role Permission Model?
A comprehensive guide to modeling user role permission systems using RBAC and ABAC approaches, with implementation examples and use cases.
