|
 |
Technical Documentation: The Missing Pillar in Microsoft's AI Readiness Assessment
The assessment measures strategy, governance, data, and infrastructure, and never asks whether the product usage instructions are explicit enough for a machine to use
|
| |||||||||||||||
I’ve spent a lot of time telling anyone who’ll listen that AI readiness is a documentation problem wearing an AI Halloween 🎃 costume. While I was researching how organizations measure AI readiness, I came across Microsoft’s AI Readiness Assessment.
It attempts to evaluate organizational preparedness across seven pillars. The strange thing is, technical documentation isn’t one of them. That sent me looking for where, exactly, technical documentation should fit into Microsoft’s model, and whether an organization can call itself AI-ready while the documentation feeding its answer engine isn’t.
What Microsoft Means By AI Readiness
Microsoft’s AI Readiness Assessment evaluates whether an organization has the strategy, governance, data, people, infrastructure, and model-management capabilities to adopt AI securely and at scale.
It’s built around seven pillars:
Business Strategy
AI Governance & Security
Data Foundations
AI Strategy & Experience
Organization & Culture
Infrastructure for AI
Model Management
The assessment runs on multiple-choice / multiple-response questions. Completing it produces an overall score, category-level recommendations, and links to related guidance. Signed-in participants can export their results to a CSV file.
 |
This assessment approach seems like a reasonable way to size up organizational readiness. Companies looking to put AI to work need leadership support, real safeguards, usable data, decent infrastructure, and people who know WTF they’re doing.
But there’s a question hiding inside those seven pillars that Microsoft never asks directly:
What knowledge is the AI actually going to use when someone asks a question (and expects an accurate answer) about how our products work?
Where’s Documentation In This Picture?
Documentation (or content, in general) isn’t named anywhere in the public list of pillars the assessment attempts to cover. That’s not proof it ignores content (and, more specifically, documentation). The assessment questions aren’t available to see until and unless you take the assessment. That’s a problem for tech writers looking for themselves in a framework that wasn’t written with them in mind.
My first guess was I’d find questions about content in the Data Foundations section. It’s the pillar built for exactly this kind of question: is the information accurate, current, complete? That seemed like the obvious home right up until I started mapping documentation against the other six pillars one at a time.
👉🏾 Governance asked which sources counted as authoritative.
👉🏾 Infrastructure asked whether the content could be crawled and chunked.
👉🏾 Model Management asked whether the generated answers could be traced back to a source at all.
By the time I’d worked through all seven pillars one-by-one, I stopped looking for documentation’s one home. It touches nearly every pillar Microsoft lists, for the same reason it kept surfacing in Governance, Infrastructure, and Model Management: sooner or later, each one has to support an AI system answering a product, support, or procedural question.
 |
Once documentation enters the picture, an honest AI-readiness review has to cover knowledge management and publishing right alongsi