Nous comparons Microsoft Learn, Google for Developers, IBM Documentation et Apple Developer Documentation uniquement à partir de sources officielles publiques.
L’étude applique la même méthode à quatre grands systèmes de documentation et compare portails, règles éditoriales, outils, accessibilité, versions et accès IA.
Méthode
Sources primaires publiques et grille 0–2 définie avant la conclusion.
Indice de capacités publiques
Les mêmes neuf critères sont appliqués aux quatre entreprises. Chaque critère vaut de 0 à 2 points, pour un maximum de 18.
Critères
0 = non trouvé dans les documents officiels étudiés · 1 = partiel ou spécifique à certains produits · 2 = capacité claire et complète
| Critère | Microsoft | IBM | Apple | |
|---|---|---|---|---|
| Portail et navigation | 2 | 1 | 2 | 2 |
| Guide de style public | 2 | 2 | 2 | 1 |
| Maintenance visible | 2 | 2 | 1 | 1 |
| Tutorial / how-to / reference | 2 | 2 | 2 | 2 |
| Versions et archives | 2 | 1 | 2 | 2 |
| Feedback et participation | 1 | 1 | 1 | 1 |
| Intégration authoring | 2 | 1 | 2 | 2 |
| Accessibilité et internationalisation | 2 | 2 | 2 | 2 |
| Accès IA/agents | 2 | 2 | 1 | 0 |
Échelle : uniquement des chiffres vérifiables
L’étude utilise quatre indicateurs publiés de l’échelle documentaire.
| Entreprise | Indicateur vérifiable d’échelle | Source |
|---|---|---|
| Microsoft | MSDN Online dépassait déjà 250 000 pages en 1998. | [M5] |
| Developer Knowledge MCP énumère 18 groupes/domaines de couverture documentaire. | [G5] | |
| IBM | IBM indique que 80 % du trafic d’IBM Documentation arrive par la recherche. | [I8] |
| Apple | Documentation Archive affiche 5 219 documents archivés. | [A2] |
Évolution des portails et des outils
La chronologie suit les principales évolutions des portails et des outils des années 1990 à 2026.
Microsoft Developer Network démarre comme service d’information spécialisé pour les développeurs. [M5]
MSDN Online dépasse 250 000 pages : la publication documentaire devient un sujet d’infrastructure. [M5]
docs.microsoft.com est lancé après des recherches auprès de centaines de développeurs et professionnels IT ; Markdown, contributions GitHub, navigation par intention et articles plus courts entrent dans le modèle. [M6]
Le 1er avril, IBM Knowledge Center est remplacé par IBM Documentation, avec un nouveau nom et une nouvelle expérience utilisateur. [I5]
DocC arrive avec Xcode 13 puis devient open source ; commentaires source, Markdown, tutorials et builds documentaires partagent le même toolchain. [A4]
Google Style Guide renforce accessibilité, tableaux sémantiques, écriture globale, structure des paragraphes, ARIA et rédaction orientée tâche. [G2]
The Swift Programming Language migre vers DocC ; plus de 50 pull requests sont acceptées et les traductions utilisent le même pipeline. [A5]
IA générative, prompts, accessibilité, langage inclusif, formatage du code et UI wording deviennent des sujets éditoriaux courants. [G2]
Microsoft Learn publie un serveur MCP pour rechercher et récupérer la documentation officielle depuis des outils et agents IA. [M4]
Google Developer Knowledge MCP ouvre la recherche machine dans la documentation officielle et répertorie 18 groupes de produits/domaines couverts. [G5]
La documentation officielle CICS ajoute des résultats de recherche générés par IA pour les requêtes d’au moins trois mots. [I7]
Comment les guides de style ont évolué
Les changelogs de Google et Microsoft montrent l’arrivée du task design, de l’accessibilité, de l’écriture globale, du code et de l’IA dans le travail courant.
| Année | Entreprise | Ce qui a changé pour l’auteur | Source |
|---|---|---|---|
| 2021 | Contexte de tâche, procédures à l’impératif, audience globale et documentation intemporelle. | [G2] | |
| 2021 | Microsoft | Le langage inclusif devient un sujet explicite du guide. | [M1] |
| 2022 | L’accessibilité couvre tableaux, UI, ponctuation, charge cognitive et authoring Markdown. | [G2] | |
| 2022 | Microsoft | Les règles de UI wording et de pronoms s’étendent aux contenus générés par IA. | [M1] |
| 2023 | Structure de paragraphe, ARIA, langage global et sens sans image sont renforcés. | [G2] | |
| 2023 | Microsoft | Terminologie du handicap plus précise et tableaux compatibles screen reader. | [M1] |
| 2024 | Generative AI entre dans la word list ; alt text, captions et timeless docs sont renforcés. | [G2] | |
| 2024 | Microsoft | Des règles spécifiques pour prompt et prompting apparaissent. | [M1] |
| 2025 | Prescriptive documentation est ajoutée ; task design, links, code et accessibility convergent. | [G2] | |
| 2025 | Microsoft | Code formatting, signes moins accessibles, identity language et ton sont mis à jour. | [M1] |
| 2026 | Global-audience guidance, contexte UI, code formatting et terminologie IA sont réorganisés. | [G2] | |
| 2026 | Microsoft | Screen reader, alt text, AI prompts, emoji accessibility, tooltips et UI wording deviennent de la maintenance courante. | [M1] |
Ce qui a changé pour le technical writer
Le travail passe de la page à un système de connaissances pour web, IDE, recherche et agents.
| Période | Objet principal | Outils typiques | Priorité éditoriale | Diffusion | Rôle |
|---|---|---|---|---|---|
| 1990–2015 | Manuel / page HTML | Word, CMS, XML, publication spécialisée | Complétude, cohérence, reference | Web + PDF | Auteur spécialiste |
| 2016–2020 | Portail orienté tâche | CMS + Git/Markdown | Recherche, task success, texte web concis, IA | Portail central | Content owner dans le product workflow |
| 2021–2024 | Connaissance structurée proche du code | Git, Markdown, DITA, DocC, CI | Sémantique, reuse, accessibilité, localisation | Portail + IDE + reference générée | Architecte de l’information + automatisation |
| 2025–2026 | Source de connaissance pour humains et IA | Source + metadata + schemas + retrieval interfaces | Grounding, trouvabilité, qualité factuelle, consommation machine | Portail + IDE + recherche + MCP/AI | Éditeur, concepteur système, vérificateur |
Le changement décisif est la responsabilité du système de connaissances : structure, vérification, maintenance, recherche et intégration au développement.
Ce qu’il faut reprendre
La comparaison fait ressortir quatre écoles fortes : règles éditoriales Google, infrastructure Microsoft, modèle qualité IBM et intégration au code Apple.
| Placer les conditions avant l’instruction | Le lecteur sait si l’étape le concerne avant d’agir. |
|---|---|
| Ne pas transmettre le sens uniquement par couleur ou position | L’accessibilité améliore aussi le balayage et la localisation. |
| Écrire pour une audience globale | Éviter idiomes et références culturelles facilite la traduction. |
| Privilégier la clarté à l’application mécanique du guide | Google autorise une dérogation si elle rend le texte plus clair. |
Microsoft
[M2]| Exprimer davantage avec moins de mots | La concision fait partie de l’expérience utilisateur. |
|---|---|
| Supprimer les `you can` inutiles | Une instruction directe se scanne plus vite. |
| Maintenir le guide comme un produit vivant | Le changelog couvre AI prompts, accessibilité, terminologie et UI wording. |
| Séparer feedback et édition | Learn combine feedback et édition GitHub lorsque les sources sont publiques. |
IBM
[I2]| Vérifier des caractéristiques concrètes de qualité | Task orientation, accuracy, completeness, clarity, style, organization et retrievability rendent la revue vérifiable. |
|---|---|
| Modéliser explicitement les types de contenu | How-to, API reference, troubleshooting et release notes appartiennent à un modèle formel. |
| Réutiliser sémantiquement | Les références DITA/Markdown maintiennent synchronisé le contenu répété. |
| Défendre la tâche utilisateur | La qualité commence par l’objectif utilisateur. |
Apple
[A3]| Garder la documentation proche du code | DocC rassemble source comments, Markdown, assets et API reference. |
|---|---|
| Traiter les tutorials comme un type majeur | L’apprentissage guidé utilise le même toolchain que reference. |
| Construire les docs dans le developer workflow | Xcode et DocC rapprochent implémentation et explication. |
| Traiter les mots comme une interface | Tone et wording font partie de l’expérience utilisateur. |
Sources officielles
La base de preuves est constituée de sources officielles primaires de Google, Microsoft, IBM et Apple.
Verdict : des gagnants clairs selon les besoins
| Entreprise | Point fort | Conclusion de l’étude |
|---|---|---|
| Microsoft | Infrastructure | Documentation, formation, versions, feedback et accès IA forment le système le plus intégré. |
| Règles éditoriales | Le guide de style public le plus transparent, avec changelog actif, accessibilité et écriture globale. | |
| IBM | Modèle de qualité | La formalisation la plus systématique de la qualité, des types de contenu, de la trouvabilité et de la réutilisation. |
| Apple | Intégration au code | DocC relie très étroitement API reference, articles, tutorials et code source. |
Notre vainqueur général est Microsoft : aucune autre plateforme ne réunit aussi complètement documentation, apprentissage, versions, feedback et accès machine.
Google gagne comme référence éditoriale quotidienne. Son guide transforme clarté, accessibilité et écriture globale en décisions concrètes applicables pendant la rédaction.
IBM est particulièrement fort pour les équipes matures : qualité, types de contenu, trouvabilité, métriques, feedback et maintenance sont formalisés comme un système.
Apple montre la direction la plus convaincante pour la developer documentation : reference, articles conceptuels et tutorials vivent près du code et passent par le même toolchain.
Le modèle le plus fort combine la logique de plateforme de Microsoft, la discipline éditoriale de Google, le système qualité d’IBM et le workflow intégré au code d’Apple.