If you’re not sure which article to read first, or how the pieces fit together, this page will point you in the right direction.
If You’re New to AI Concepts
AI terminology can be inconsistent. The same word can mean different things depending on the product, the team, or the context.
This site assumes you are comfortable with basic concepts, but you don’t need technical expertise.
If you want a neutral reference for core terms, start with:
- Coursera’s Artificial Intelligence Glossary: A comprehensive glossary covering essential AI vocabulary and definitions.
You don’t need to memorize terminology. Use it as a reference when something is unclear.
If You’re New to Writing About AI
This series focuses on:
- how AI systems behave from a user’s perspective
- where they tend to be misunderstood
- how documentation shapes understanding, trust, and adoption
A practical reading path:
- Start with Understanding AI Through Goals, Tools, and Overlap
- Read the Writing About AI landing page
- Review the AI Product Landscape
- Choose the category article that matches what you’re documenting
You don’t need to read everything in order.
If You’re Thinking Beyond the Document Level
Writing about AI well is one part of the problem. The other part is understanding the system that documentation lives within. How knowledge is created, where it gets lost, and why certain problems keep recurring regardless of how well individual documents are written.
The Living Knowledge System maps that system. It’s a starting point for technical writers and documentation engineers thinking about documentation at the level of architecture, not just content.
If You’re Looking for Writing Guidance That Applies Everywhere
Visit Technical Writing Best Practices.
These articles focus on foundational writing principles that apply whether or not you document AI. They are designed to remain useful over time.
You can use them alongside the AI-focused guides, or independently.
If You Already Know What You’re Documenting
You can jump directly to:
- the relevant AI product category article
- the corresponding “Documenting X” guide
This site supports non-linear reading. You don’t need to start at the beginning to get value from it.
How This Site Is Organized (At a Glance)
- The Living Knowledge System → how documentation is one layer of a larger system
- Writing About AI → how to document AI products and features
- Technical Writing Best Practices → foundational technical writing principles
- Reflections → perspective and longer-form thinking
- About → author and site context
A Final Note
AI documentation is challenging because AI systems don’t behave like traditional software features.
Confusion is normal. You don’t need to master terminology to write clearly about behavior.
The goal of this series is to offer practical, calm guidance you can return to over time.