Microsoft Learn, Google for Developers, IBM Documentation और Apple Developer Documentation को केवल official public sources पर compare किया गया।
यह study एक ही method से चार बड़े documentation systems की तुलना करती है: portals, editorial rules, tooling, accessibility, versions और AI access.
Method
केवल official public primary sources और conclusion से पहले defined 0–2 rubric.
Public capability index
चारों कंपनियों पर वही नौ criteria लागू किए गए हैं। हर criterion को 0–2 अंक मिलते हैं; maximum 18 है।
Criteria
0 = reviewed official materials में नहीं मिला · 1 = partial या product-specific · 2 = स्पष्ट और पूर्ण capability
| Criterion | Microsoft | IBM | Apple | |
|---|---|---|---|---|
| Portal और navigation | 2 | 1 | 2 | 2 |
| Public style guide | 2 | 2 | 2 | 1 |
| Visible maintenance | 2 | 2 | 1 | 1 |
| Tutorial / how-to / reference | 2 | 2 | 2 | 2 |
| Versions और archive | 2 | 1 | 2 | 2 |
| Feedback और participation | 1 | 1 | 1 | 1 |
| Authoring integration | 2 | 1 | 2 | 2 |
| Accessibility और localization | 2 | 2 | 2 | 2 |
| AI/agent access | 2 | 2 | 1 | 0 |
Scale: केवल verified numbers
Current page totals comparable रूप में उपलब्ध नहीं हैं।
| Company | Verified scale marker | Source |
|---|---|---|
| Microsoft | 1998 में MSDN Online पर 250,000 से अधिक pages थे। | [M5] |
| Developer Knowledge MCP 18 documentation coverage groups/domains सूचीबद्ध करता है। | [G5] | |
| IBM | IBM के अनुसार IBM Documentation का 80% traffic search के माध्यम से आता है। | [I8] |
| Apple | Documentation Archive में 5,219 archived documents दिखते हैं। | [A2] |
Portals और tooling कैसे बदले
Timeline 1990s से 2026 तक portals और tooling के प्रमुख बदलाव दिखाती है।
Microsoft Developer Network developers के लिए dedicated technical-information service के रूप में शुरू होता है। [M5]
MSDN Online 250,000 pages पार करता है और documentation publishing बड़े पैमाने की infrastructure समस्या बनती है। [M5]
सैकड़ों developers और IT professionals के research के बाद docs.microsoft.com शुरू होता है; Markdown, GitHub contributions, intent-based navigation और छोटे articles model का हिस्सा बनते हैं। [M6]
1 अप्रैल को IBM Knowledge Center को IBM Documentation से बदला जाता है, जिसमें product documentation के लिए नया नाम और नया user experience आता है। [I5]
DocC Xcode 13 के साथ आता है और बाद में open source बनता है; source comments, Markdown, tutorials और documentation builds एक toolchain में आते हैं। [A4]
Google Style Guide accessibility, semantic tables, global writing, paragraph structure, ARIA और task-oriented guidance को बढ़ाता है। [G2]
The Swift Programming Language DocC पर जाता है; conversion के दौरान 50 से अधिक pull requests स्वीकार होते हैं और translations वही pipeline उपयोग करते हैं। [A5]
Generative AI, prompts, accessibility, inclusive language, code formatting और UI wording नियमित editorial topics बनते हैं। [G2]
Microsoft Learn AI tools और agents से official documentation search और retrieve करने के लिए MCP server प्रकाशित करता है। [M4]
Google Developer Knowledge MCP official developer documentation में machine search खोलता है और 18 covered product/domain groups सूचीबद्ध करता है। [G5]
Official CICS documentation तीन या अधिक शब्दों वाली queries के लिए AI-generated search results जोड़ती है। [I7]
Style guides कैसे बदले
Google और Microsoft changelogs दिखाते हैं कि task design, accessibility, global writing, code और AI rules रोज़मर्रा के authoring का हिस्सा बने।
| वर्ष | Company | लेखक के लिए क्या बदला | Source |
|---|---|---|---|
| 2021 | Task context, imperative procedures, global audience और timeless documentation. | [G2] | |
| 2021 | Microsoft | Inclusive language style guide का स्पष्ट विषय बनता है। | [M1] |
| 2022 | Accessibility tables, UI, punctuation, cognitive load और Markdown authoring तक पहुँचती है। | [G2] | |
| 2022 | Microsoft | UI wording और pronoun guidance AI-generated content तक बढ़ती है। | [M1] |
| 2023 | Paragraph structure, ARIA, global language और images के बिना meaning पर जोर बढ़ता है। | [G2] | |
| 2023 | Microsoft | Disability terminology और screen-reader-friendly tables अधिक स्पष्ट होते हैं। | [M1] |
| 2024 | Generative AI word list में आता है; alt text, captions और timeless docs मजबूत होते हैं। | [G2] | |
| 2024 | Microsoft | Prompt और prompting के लिए अलग rules आते हैं। | [M1] |
| 2025 | Prescriptive documentation जुड़ती है; task design, links, code और accessibility साथ आते हैं। | [G2] | |
| 2025 | Microsoft | Code formatting, accessible symbols, identity language और tone update होते हैं। | [M1] |
| 2026 | Global-audience guidance, UI context, code formatting और AI terminology restructure होते हैं। | [G2] | |
| 2026 | Microsoft | Screen reader, alt text, AI prompts, emoji accessibility, tooltips और UI wording routine maintenance बनते हैं। | [M1] |
Technical writer के लिए क्या बदला
काम page/manual से knowledge system तक गया जो web, IDE, search और agents में काम करे।
| अवधि | मुख्य artifact | सामान्य tools | Editorial focus | Delivery | Technical writer की भूमिका |
|---|---|---|---|---|---|
| 1990–2015 | Manual / HTML page | Word, CMS, XML, specialized publishing | Completeness, consistency, reference | Web + PDF | Specialist author |
| 2016–2020 | Task-oriented portal | CMS + Git/Markdown | Search, task success, concise web text, IA | Central portal | Product workflow में content owner |
| 2021–2024 | Code के पास structured knowledge | Git, Markdown, DITA, DocC, CI | Semantics, reuse, accessibility, localization | Portal + IDE + generated reference | Information architect + automation partner |
| 2025–2026 | People और AI के लिए knowledge source | Source + metadata + schemas + retrieval interfaces | Grounding, retrievability, factual quality, machine consumption | Portal + IDE + search + MCP/AI | Editor, system designer, verifier |
मुख्य बदलाव knowledge system की ownership है: structure, verification, maintenance, retrieval और development integration.
हर company से क्या लेना चाहिए
तुलना चार मजबूत approaches दिखाती है: Google editorial guidance, Microsoft infrastructure, IBM quality model और Apple code integration.
| Instruction से पहले condition रखें | Reader action से पहले जानता है कि step लागू होता है या नहीं। |
|---|---|
| Meaning केवल color या position से न दें | Accessibility scanning और localization को भी बेहतर करती है। |
| Global audience के लिए लिखें | Idioms और local references कम करने से translation बेहतर होती है। |
| Mechanical guide compliance से ऊपर clarity रखें | जब text अधिक स्पष्ट हो, Google guidance से अलग होने की अनुमति देता है। |
Microsoft
[M2]| कम शब्दों में अधिक अर्थ दें | Conciseness experience design का हिस्सा है। |
|---|---|
| अनावश्यक `you can` हटाएँ | Direct instruction जल्दी scan होती है। |
| Guide को living product रखें | Changelog AI prompts, accessibility, terminology और UI wording update करता है। |
| Feedback और editing अलग रखें | Public sources में Learn feedback और GitHub editing दोनों देता है। |
IBM
[I2]| Concrete quality characteristics review करें | Task orientation, accuracy, completeness, clarity, style, organization और retrievability review को specific properties पर लाते हैं। |
|---|---|
| Content types को model करें | How-to, API reference, troubleshooting और release notes formal model का हिस्सा हैं। |
| Semantic reuse करें | DITA/Markdown references repeated content को synchronized रखते हैं। |
| User task की रक्षा करें | Quality user goal से शुरू होती है। |
Apple
[A3]| Docs को code के पास रखें | DocC source comments, Markdown, assets और API reference को जोड़ता है। |
|---|---|
| Tutorials को first-class content मानें | Guided learning वही toolchain उपयोग करता है जो reference। |
| Docs को developer workflow में build करें | Xcode और DocC implementation और explanation की दूरी कम करते हैं। |
| Words को interface मानें | Tone और wording user experience quality का हिस्सा हैं। |
Official sources
Evidence base Google, Microsoft, IBM और Apple की official primary materials है।
निष्कर्ष: अलग कामों के लिए अलग विजेता
| Company | सबसे मजबूत क्षेत्र | Research conclusion |
|---|---|---|
| Microsoft | इन्फ्रास्ट्रक्चर | Documentation, learning, versions, feedback और AI access सबसे एकीकृत प्रणाली बनाते हैं। |
| Editorial guidance | सबसे पारदर्शी public style guide, active changelog, accessibility और global-writing rules के साथ। | |
| IBM | Quality model | Quality, content types, findability और reuse का सबसे व्यवस्थित formal model। |
| Apple | Code integration | DocC API reference, articles, tutorials और source code को सबसे करीब लाता है। |
कुल मिलाकर हमारी पहली पसंद Microsoft है: documentation, learning, versions, feedback और machine access को सबसे पूर्ण platform model में जोड़ा गया है।
Google रोज़मर्रा के editorial reference के रूप में सबसे मजबूत है। उसका guide clarity, accessibility, global writing, procedures और UI text को सीधे लागू होने वाले decisions में बदलता है।
IBM mature teams के लिए सबसे कठोर operating model देता है: quality, content types, retrievability, metrics, feedback और maintenance को formalize किया गया है।
Apple developer documentation के भविष्य की सबसे साफ दिशा दिखाता है: API reference, conceptual articles और tutorials code के पास रहते हैं और उसी toolchain से build होते हैं।
सबसे मजबूत model Microsoft के platform thinking, Google की editorial discipline, IBM के quality system और Apple के code-integrated workflow को जोड़ता है.