Verglichen wurden Microsoft Learn, Google for Developers, IBM Documentation und Apple Developer Documentation ausschließlich anhand öffentlicher offizieller Quellen.
Die Studie wendet dieselbe Methode auf vier große Dokumentationssysteme an und vergleicht Portale, Redaktionsregeln, Werkzeuge, Barrierefreiheit, Versionen und KI-Zugriff.
Methode
Nur öffentliche Primärquellen; 0–2-Rubrik vor dem Fazit.
Index öffentlicher Fähigkeiten
Für alle vier Unternehmen gelten dieselben neun Kriterien. Jedes Kriterium wird mit 0 bis 2 Punkten bewertet; maximal sind 18 Punkte möglich.
Bewertungskriterien
0 = in den geprüften offiziellen Materialien nicht gefunden · 1 = teilweise oder produktspezifisch · 2 = klar ausgeprägte Funktion
| Kriterium | Microsoft | IBM | Apple | |
|---|---|---|---|---|
| Portal und Navigation | 2 | 1 | 2 | 2 |
| Öffentlicher Styleguide | 2 | 2 | 2 | 1 |
| Sichtbare Pflege | 2 | 2 | 1 | 1 |
| Tutorial / How-to / Reference | 2 | 2 | 2 | 2 |
| Versionen und Archiv | 2 | 1 | 2 | 2 |
| Feedback und Beteiligung | 1 | 1 | 1 | 1 |
| Authoring-Integration | 2 | 1 | 2 | 2 |
| Accessibility und Globalisierung | 2 | 2 | 2 | 2 |
| KI-/Agentenzugriff | 2 | 2 | 1 | 0 |
Umfang: nur überprüfbare Zahlen
Die Studie verwendet vier veröffentlichte Größenindikatoren für Dokumentation.
| Unternehmen | Prüfbarer Größenindikator | Quelle |
|---|---|---|
| Microsoft | MSDN Online hatte 1998 bereits mehr als 250.000 Seiten. | [M5] |
| Developer Knowledge MCP nennt 18 Dokumentationsgruppen/-domains. | [G5] | |
| IBM | IBM berichtet, dass 80 % des Traffics von IBM Documentation über die Suche kommen. | [I8] |
| Apple | Das Documentation Archive enthält 5.219 archivierte Dokumente. | [A2] |
Entwicklung von Portalen und Werkzeugen
Die Zeitlinie verfolgt zentrale Portal- und Werkzeugänderungen von den 1990er Jahren bis 2026.
Microsoft Developer Network startet als spezialisierter Informationsdienst für Entwickler. [M5]
MSDN Online überschreitet 250.000 Seiten; Dokumentationspublikation wird zur Infrastrukturaufgabe. [M5]
docs.microsoft.com startet nach Forschung mit Hunderten Entwicklern und IT-Fachleuten; Markdown, GitHub-Beiträge, intent-basierte Navigation und kürzere Artikel prägen das Modell. [M6]
Am 1. April wird IBM Knowledge Center durch IBM Documentation mit neuem Namen und neuer Benutzeroberfläche ersetzt. [I5]
DocC kommt mit Xcode 13 und wird später Open Source; Source-Kommentare, Markdown, Tutorials und Builds nutzen denselben Toolchain. [A4]
Google Style Guide erweitert Regeln zu Accessibility, semantischen Tabellen, globalem Schreiben, Absatzstruktur, ARIA und task-orientiertem Text. [G2]
The Swift Programming Language wechselt zu DocC; mehr als 50 Pull Requests werden übernommen und Übersetzungen nutzen dieselbe Pipeline. [A5]
Generative KI, Prompts, Accessibility, inklusive Sprache, Codeformatierung und UI-Wording werden normale Redaktionsthemen. [G2]
Microsoft Learn veröffentlicht einen MCP-Server für die Suche und den Abruf offizieller Dokumentation aus KI-Werkzeugen und Agenten. [M4]
Google Developer Knowledge MCP ermöglicht maschinelle Suche in offizieller Entwicklerdokumentation und nennt 18 abgedeckte Produkt-/Domain-Gruppen. [G5]
Die offizielle CICS-Dokumentation ergänzt KI-generierte Suchergebnisse für Suchanfragen mit mindestens drei Wörtern. [I7]
Wie sich die Styleguides veränderten
Die Changelogs von Google und Microsoft zeigen, wie Task Design, Accessibility, globales Schreiben, Code und KI in den Alltag der Autoren einzogen.
| Jahr | Unternehmen | Was sich für Autoren änderte | Quelle |
|---|---|---|---|
| 2021 | Task-Kontext, imperative Verfahren, globale Zielgruppe und zeitlose Dokumentation. | [G2] | |
| 2021 | Microsoft | Inklusive Sprache wird expliziter Bestandteil des Styleguides. | [M1] |
| 2022 | Accessibility erreicht Tabellen, UI, Zeichensetzung, kognitive Last und Markdown-Authoring. | [G2] | |
| 2022 | Microsoft | UI-Wording und Pronomenregeln werden erweitert, auch für KI-generierte Inhalte. | [M1] |
| 2023 | Absatzstruktur, ARIA, globale Sprache und Bedeutung ohne Bilder werden verstärkt. | [G2] | |
| 2023 | Microsoft | Präzisere Disability-Terminologie und screenreader-freundliche Tabellen kommen hinzu. | [M1] |
| 2024 | Generative AI kommt in die Wortliste; Alt-Text, Captions und zeitlose Docs werden gestärkt. | [G2] | |
| 2024 | Microsoft | Eigene Regeln für Prompt und Prompting erscheinen. | [M1] |
| 2025 | Prescriptive Documentation wird ergänzt; Task Design, Links, Code und Accessibility wachsen zusammen. | [G2] | |
| 2025 | Microsoft | Codeformatierung, zugängliche Minuszeichen, Identity Language und Ton werden aktualisiert. | [M1] |
| 2026 | Global-Audience-Guidance, UI-Kontext, Codeformatierung und KI-Terminologie werden überarbeitet. | [G2] | |
| 2026 | Microsoft | Screenreader, Alt-Text, AI Prompts, Emoji Accessibility, Tooltips und UI-Wording werden laufend gepflegt. | [M1] |
Was sich für Technical Writer änderte
Vom einzelnen Dokument zum Wissenssystem für Web, IDE, Suche und Agenten.
| Zeitraum | Hauptartefakt | Typische Werkzeuge | Redaktioneller Fokus | Auslieferung | Rolle |
|---|---|---|---|---|---|
| 1990–2015 | Handbuch / HTML-Seite | Word, CMS, XML, spezialisierte Publikation | Vollständigkeit, Konsistenz, Reference | Web + PDF | Fachautor |
| 2016–2020 | Task-orientiertes Portal | CMS + Git/Markdown | Suche, Task Success, knapper Webtext, IA | Zentrales Portal | Content Owner im Product Workflow |
| 2021–2024 | Strukturiertes Wissen nahe am Code | Git, Markdown, DITA, DocC, CI | Semantik, Reuse, Accessibility, Localization | Portal + IDE + generierte Reference | Informationsarchitekt + Automatisierung |
| 2025–2026 | Wissensquelle für Menschen und KI | Source + Metadata + Schemas + Retrieval Interfaces | Grounding, Auffindbarkeit, Faktenqualität, maschinelle Nutzung | Portal + IDE + Suche + MCP/AI | Editor, Systemdesigner, Verifier |
Der entscheidende Wandel ist die Verantwortung für das Wissenssystem: Struktur, Prüfung, Pflege, Auffindbarkeit und Integration in die Entwicklung.
Was man übernehmen sollte
Der Vergleich zeigt vier starke Schulen: Googles Redaktionsregeln, Microsofts Infrastruktur, IBMs Qualitätsmodell und Apples Code-Integration.
| Bedingungen vor die Anweisung stellen | Leser erkennen vor der Aktion, ob ein Schritt gilt. |
|---|---|
| Bedeutung nicht nur über Farbe oder Position vermitteln | Accessibility verbessert auch Scanbarkeit und Lokalisierung. |
| Für ein globales Publikum schreiben | Weniger Idiome und lokale Anspielungen erleichtern Übersetzung. |
| Klarheit vor mechanische Regelbefolgung stellen | Google erlaubt Abweichungen, wenn der Text dadurch klarer wird. |
Microsoft
[M2]| Mehr Bedeutung mit weniger Wörtern | Kürze ist Teil des Experience Designs. |
|---|---|
| Unnötiges `you can` entfernen | Direkte Anweisungen sind schneller erfassbar. |
| Den Guide als lebendes Produkt pflegen | Das Changelog aktualisiert AI Prompts, Accessibility, Terminologie und UI-Wording. |
| Feedback und Bearbeitung trennen | Learn verbindet Feedback mit GitHub-Bearbeitung bei öffentlichen Quellen. |
IBM
[I2]| Konkrete Qualitätsmerkmale prüfen | Task Orientation, Accuracy, Completeness, Clarity, Style, Organization und Retrievability machen Review überprüfbar. |
|---|---|
| Content-Typen explizit modellieren | How-to, API Reference, Troubleshooting und Release Notes gehören zu einem formalen Modell. |
| Semantisch wiederverwenden | DITA/Markdown-Referenzen halten wiederholte Inhalte synchron. |
| Die Nutzeraufgabe verteidigen | Qualität beginnt beim Nutzerziel. |
Apple
[A3]| Dokumentation nahe am Code halten | DocC verbindet Source Comments, Markdown, Assets und API Reference. |
|---|---|
| Tutorials als vollwertigen Typ behandeln | Guided Learning nutzt denselben Toolchain wie Reference. |
| Docs im Developer Workflow bauen | Xcode und DocC verbinden Implementierung und Erklärung. |
| Wörter als Interface verstehen | Ton und Wording gehören zur User Experience. |
Offizielle Quellen
Die Evidenzbasis besteht aus offiziellen Primärquellen von Google, Microsoft, IBM und Apple.
Fazit: klare Sieger für unterschiedliche Aufgaben
| Unternehmen | Stärkster Bereich | Forschungsergebnis |
|---|---|---|
| Microsoft | Infrastruktur | Dokumentation, Lernen, Versionen, Feedback und KI-Zugriff bilden das am stärksten integrierte System. |
| Redaktionsregeln | Der transparenteste öffentliche Styleguide mit aktivem Changelog, Barrierefreiheit und globalem Schreiben. | |
| IBM | Qualitätsmodell | Die systematischste Formalisierung von Qualität, Content-Typen, Auffindbarkeit und Wiederverwendung. |
| Apple | Code-Integration | DocC verbindet API-Referenz, Artikel, Tutorials und Quellcode besonders eng. |
Unser Gesamtsieger ist Microsoft: Kein anderes System verbindet Dokumentation, Lernen, Versionen, Feedback und maschinellen Zugriff so vollständig zu einer Plattform.
Google gewinnt als tägliches redaktionelles Arbeitswerkzeug. Der öffentliche Styleguide übersetzt Klarheit, Accessibility und globales Schreiben in konkrete Entscheidungen.
IBM ist für reife Teams besonders stark, weil Qualität, Content-Typen, Auffindbarkeit, Metriken, Feedback und Pflege systematisch definiert werden.
Apple zeigt die überzeugendste Richtung für Developer Documentation: Reference, konzeptionelle Artikel und Tutorials leben neben dem Code und durchlaufen denselben Toolchain.
Das stärkste Modell verbindet Microsofts Plattformdenken, Googles Redaktionsdisziplin, IBMs Qualitätssystem und Apples Code-integrierten Workflow.