Comparamos Microsoft Learn, Google for Developers, IBM Documentation y Apple Developer Documentation usando solo fuentes públicas oficiales.
El estudio aplica una misma metodología a cuatro grandes sistemas de documentación y compara portales, reglas editoriales, herramientas, accesibilidad, versiones y acceso para IA.
Método
Solo fuentes oficiales públicas y una rúbrica 0–2 definida antes de la conclusión.
Índice de capacidades públicas
Aplicamos los mismos nueve criterios a las cuatro compañías. Cada criterio se puntúa de 0 a 2 y el máximo es 18.
Criterios
0 = no encontrado en los materiales oficiales revisados · 1 = parcial o específico de producto · 2 = capacidad clara y completa
| Criterio | Microsoft | IBM | Apple | |
|---|---|---|---|---|
| Portal y navegación | 2 | 1 | 2 | 2 |
| Guía pública de estilo | 2 | 2 | 2 | 1 |
| Mantenimiento visible | 2 | 2 | 1 | 1 |
| Tutorial / how-to / reference | 2 | 2 | 2 | 2 |
| Versiones y archivo | 2 | 1 | 2 | 2 |
| Feedback y participación | 1 | 1 | 1 | 1 |
| Integración de autoría | 2 | 1 | 2 | 2 |
| Accesibilidad e internacionalización | 2 | 2 | 2 | 2 |
| Acceso para IA/agentes | 2 | 2 | 1 | 0 |
Escala: solo cifras verificables
El estudio utiliza cuatro marcadores publicados de escala documental.
| Empresa | Indicador verificable de escala | Fuente |
|---|---|---|
| Microsoft | MSDN Online tenía más de 250 000 páginas en 1998. | [M5] |
| Developer Knowledge MCP enumera 18 grupos/dominios de cobertura documental. | [G5] | |
| IBM | IBM informa de que el 80% del tráfico de IBM Documentation llega a través de la búsqueda. | [I8] |
| Apple | Documentation Archive muestra 5 219 documentos archivados. | [A2] |
Cómo cambiaron portales y herramientas
La cronología recorre los cambios clave de portales y herramientas desde los años noventa hasta 2026.
Microsoft Developer Network nace como servicio especializado de información para desarrolladores. [M5]
MSDN Online supera las 250 000 páginas y la publicación documental pasa a ser una tarea de infraestructura. [M5]
docs.microsoft.com se lanza tras investigar con cientos de desarrolladores y profesionales de TI; entran Markdown, contribuciones en GitHub, navegación por intención y artículos más cortos. [M6]
Knowledge Center se convierte en IBM Documentation, con búsqueda, punto de acceso unificado, investigación de usuarios y feedback. [I5]
DocC llega con Xcode 13 y después se hace open source; comentarios de código, Markdown, tutorials y builds documentales comparten toolchain. [A4]
Google Style Guide amplía accesibilidad, tablas semánticas, escritura global, estructura de párrafos, ARIA y task-oriented writing. [G2]
The Swift Programming Language migra a DocC; se aceptan más de 50 pull requests y las traducciones usan el mismo pipeline. [A5]
IA generativa, prompts, accesibilidad, lenguaje inclusivo, formato de código y UI wording pasan a ser temas editoriales habituales. [G2]
Microsoft Learn publica un servidor MCP para buscar y recuperar documentación oficial desde herramientas y agentes de IA. [M4]
Google Developer Knowledge MCP abre la búsqueda automática sobre documentación oficial y enumera 18 grupos de productos y dominios cubiertos. [G5]
La documentación oficial de CICS añade resultados de búsqueda generados por IA para consultas de tres palabras o más. [I7]
Cómo cambiaron los style guides
Los changelogs de Google y Microsoft muestran cómo task design, accesibilidad, escritura global, código e IA entraron en el trabajo cotidiano.
| Año | Empresa | Qué cambió para el autor | Fuente |
|---|---|---|---|
| 2021 | Contexto de tarea, procedimientos imperativos, audiencia global y documentación atemporal. | [G2] | |
| 2021 | Microsoft | El lenguaje inclusivo entra explícitamente en el guide. | [M1] |
| 2022 | La accesibilidad alcanza tablas, UI, puntuación, carga cognitiva y authoring en Markdown. | [G2] | |
| 2022 | Microsoft | Se amplían reglas de UI y pronombres, incluido contenido generado por IA. | [M1] |
| 2023 | Se refuerzan estructura de párrafos, ARIA, lenguaje global y significado sin imágenes. | [G2] | |
| 2023 | Microsoft | Aparecen reglas más precisas de lenguaje de discapacidad y tablas aptas para screen readers. | [M1] |
| 2024 | Generative AI entra en la lista terminológica junto con alt text, captions y timeless docs. | [G2] | |
| 2024 | Microsoft | Aparecen reglas específicas para prompt y prompting. | [M1] |
| 2025 | Se añade prescriptive documentation y convergen task design, links, code y accessibility. | [G2] | |
| 2025 | Microsoft | Se actualizan code formatting, signos accesibles, identity language y tone. | [M1] |
| 2026 | Se reorganiza global-audience guidance y se actualizan UI context, code formatting y términos de IA. | [G2] | |
| 2026 | Microsoft | Screen reader, alt text, AI prompts, emoji accessibility, tooltips y UI wording pasan al mantenimiento habitual. | [M1] |
Qué cambió para el technical writer
El trabajo pasó de la página a un sistema de conocimiento para web, IDE, búsqueda y agentes.
| Periodo | Objeto principal | Herramientas típicas | Enfoque editorial | Entrega | Rol del technical writer |
|---|---|---|---|---|---|
| 1990–2015 | Manual / página HTML | Word, CMS, XML, publicación especializada | Integridad, consistencia, reference | Web + PDF | Autor especialista |
| 2016–2020 | Portal orientado a tareas | CMS + Git/Markdown | Búsqueda, task success, texto web conciso, IA | Portal central | Responsable de contenido en product workflow |
| 2021–2024 | Base de conocimiento estructurada junto al código | Git, Markdown, DITA, DocC, CI | Semántica, reuse, accesibilidad, localización | Portal + IDE + reference generado | Arquitecto de información + automatización |
| 2025–2026 | Fuente de conocimiento para personas e IA | Source + metadata + schemas + retrieval interfaces | Grounding, encontrabilidad, calidad factual, consumo automático | Portal + IDE + búsqueda + MCP/AI | Editor, diseñador de sistema, verificador |
El cambio decisivo es la responsabilidad sobre el sistema de conocimiento: estructura, verificación, mantenimiento, búsqueda e integración con desarrollo.
Qué copiar de cada compañía
La comparación muestra cuatro escuelas fuertes: reglas editoriales de Google, infraestructura de Microsoft, modelo de calidad de IBM e integración con código de Apple.
| Poner las condiciones antes de la instrucción | El lector sabe si el paso le afecta antes de actuar. |
|---|---|
| No depender solo del color o la posición | La accesibilidad mejora también el escaneo y la localización. |
| Escribir para una audiencia global | Evitar modismos y referencias culturales facilita traducción y comprensión. |
| Priorizar claridad sobre obediencia mecánica al guide | Google permite apartarse de la guía cuando el texto resulta más claro. |
Microsoft
[M2]| Expresar más con menos palabras | La concisión se trata como diseño de experiencia. |
|---|---|
| Eliminar `you can` innecesario | La instrucción directa se escanea mejor. |
| Mantener el guide como producto vivo | El changelog incorpora AI prompts, accesibilidad, terminología y UI wording. |
| Separar feedback y edición | Learn combina feedback con edición en GitHub cuando las fuentes son públicas. |
IBM
[I2]| Revisar características concretas de calidad | Task orientation, accuracy, completeness, clarity, style, organization y retrievability convierten la revisión en una comprobación concreta. |
|---|---|
| Modelar tipos de contenido | How-to, API reference, troubleshooting y release notes forman parte de un modelo formal. |
| Reutilizar semánticamente | Referencias DITA/Markdown ayudan a mantener sincronizado el contenido repetido. |
| Defender la tarea del usuario | La calidad empieza por lo que el usuario necesita lograr. |
Apple
[A3]| Mantener docs cerca del código | DocC reúne source comments, Markdown, assets y API reference. |
|---|---|
| Tratar tutorials como contenido principal | El aprendizaje guiado usa el mismo toolchain que reference. |
| Construir docs dentro del developer workflow | Xcode y DocC acercan implementación y explicación. |
| Tratar las palabras como interfaz | Tone y wording forman parte de la experiencia de usuario. |
Fuentes oficiales
La base de evidencia está formada por materiales oficiales primarios de Google, Microsoft, IBM y Apple.
Conclusión: ganadores claros para tareas diferentes
| Empresa | Punto fuerte | Conclusión del estudio |
|---|---|---|
| Microsoft | Infraestructura | Documentación, formación, versiones, feedback y acceso para IA forman el sistema más integrado. |
| Reglas editoriales | El style guide público más transparente, con changelog activo, accesibilidad y escritura global. | |
| IBM | Modelo de calidad | La formalización más sistemática de calidad, tipos de contenido, encontrabilidad y reutilización. |
| Apple | Integración con código | DocC conecta API reference, artículos, tutorials y código fuente con especial profundidad. |
Nuestro ganador general es Microsoft: es la compañía que más claramente convirtió la documentación en una plataforma con aprendizaje, versiones, feedback y acceso para herramientas de IA.
Google gana como referencia editorial cotidiana. Su guía convierte la claridad, la accesibilidad y la escritura global en decisiones concretas que un redactor puede aplicar mientras trabaja.
IBM es la propuesta más rigurosa para equipos maduros: formaliza calidad, tipos de contenido, encontrabilidad, métricas, feedback y mantenimiento.
Apple marca la dirección más interesante para developer documentation: reference, artículos y tutorials viven junto al código y pasan por el mismo toolchain.
La combinación más fuerte toma de Microsoft la lógica de plataforma, de Google la disciplina editorial, de IBM el sistema de calidad y de Apple el workflow integrado con código.