Comparamos Microsoft Learn, Google for Developers, IBM Documentation e Apple Developer Documentation usando apenas fontes oficiais públicas.
A pesquisa aplica a mesma metodologia a quatro grandes plataformas de documentação e compara portais, regras editoriais, ferramentas, acessibilidade, versões e acesso para IA.
Método
Somente fontes oficiais públicas e rubrica 0–2 definida antes da conclusão.
Índice de capacidades públicas
Os mesmos nove critérios são aplicados às quatro empresas. Cada critério vale de 0 a 2 pontos, com máximo de 18.
Critérios
0 = não encontrado nos materiais oficiais analisados · 1 = parcial ou específico de produto · 2 = capacidade clara e completa
| Critério | Microsoft | IBM | Apple | |
|---|---|---|---|---|
| Portal e navegação | 2 | 1 | 2 | 2 |
| Style guide público | 2 | 2 | 2 | 1 |
| Manutenção visível | 2 | 2 | 1 | 1 |
| Tutorial / how-to / reference | 2 | 2 | 2 | 2 |
| Versões e arquivo | 2 | 1 | 2 | 2 |
| Feedback e participação | 1 | 1 | 1 | 1 |
| Integração de authoring | 2 | 1 | 2 | 2 |
| Acessibilidade e globalização | 2 | 2 | 2 | 2 |
| Acesso para IA/agentes | 2 | 2 | 1 | 0 |
Escala: apenas números verificáveis
O estudo usa quatro indicadores publicados da escala da documentação.
| Empresa | Indicador verificável de escala | Fonte |
|---|---|---|
| Microsoft | MSDN Online já tinha mais de 250.000 páginas em 1998. | [M5] |
| Developer Knowledge MCP lista 18 grupos/domínios de documentação. | [G5] | |
| IBM | IBM informa que 80% do tráfego do IBM Documentation chega pela busca. | [I8] |
| Apple | Documentation Archive mostra 5.219 documentos arquivados. | [A2] |
Como portais e ferramentas mudaram
A cronologia acompanha mudanças centrais de portais e ferramentas dos anos 1990 a 2026.
Microsoft Developer Network começa como serviço especializado de informação para desenvolvedores. [M5]
MSDN Online ultrapassa 250 mil páginas e a publicação de documentação vira uma questão de infraestrutura. [M5]
docs.microsoft.com é lançado após pesquisa com centenas de desenvolvedores e profissionais de TI; Markdown, contribuições via GitHub, navegação por intenção e artigos menores entram no modelo. [M6]
Em 1º de abril, IBM Knowledge Center é substituído por IBM Documentation, com novo nome e nova experiência de uso. [I5]
DocC chega com Xcode 13 e depois vira open source; source comments, Markdown, tutorials e builds usam o mesmo toolchain. [A4]
Google Style Guide amplia acessibilidade, tabelas semânticas, global writing, estrutura de parágrafos, ARIA e orientação por tarefa. [G2]
The Swift Programming Language migra para DocC; mais de 50 pull requests são aceitos e traduções usam o mesmo pipeline. [A5]
IA generativa, prompts, acessibilidade, linguagem inclusiva, formatação de código e UI wording tornam-se temas editoriais rotineiros. [G2]
Microsoft Learn publica um servidor MCP para pesquisar e recuperar documentação oficial a partir de ferramentas e agentes de IA. [M4]
Google Developer Knowledge MCP abre a busca por máquina na documentação oficial e lista 18 grupos de produtos/domínios cobertos. [G5]
A documentação oficial do CICS adiciona resultados de busca gerados por IA para consultas com três palavras ou mais. [I7]
Como os style guides mudaram
Os changelogs de Google e Microsoft mostram task design, acessibilidade, escrita global, código e IA entrando no trabalho cotidiano.
| Ano | Empresa | O que mudou para o autor | Fonte |
|---|---|---|---|
| 2021 | Contexto da tarefa, procedimentos no imperativo, audiência global e documentação duradoura. | [G2] | |
| 2021 | Microsoft | Linguagem inclusiva entra explicitamente no guide. | [M1] |
| 2022 | Acessibilidade chega a tabelas, UI, pontuação, carga cognitiva e authoring em Markdown. | [G2] | |
| 2022 | Microsoft | Regras de UI wording e pronomes passam a incluir conteúdo gerado por IA. | [M1] |
| 2023 | Estrutura de parágrafos, ARIA, global language e significado sem imagens ganham força. | [G2] | |
| 2023 | Microsoft | Terminologia de deficiência fica mais precisa e tabelas para screen readers são reforçadas. | [M1] |
| 2024 | Generative AI entra na word list junto com alt text, captions e timeless docs. | [G2] | |
| 2024 | Microsoft | Aparecem regras específicas para prompt e prompting. | [M1] |
| 2025 | Prescriptive documentation é adicionada; task design, links, code e accessibility convergem. | [G2] | |
| 2025 | Microsoft | Code formatting, sinais acessíveis, identity language e tom são atualizados. | [M1] |
| 2026 | Global-audience guidance, contexto de UI, code formatting e terminologia de IA são reorganizados. | [G2] | |
| 2026 | Microsoft | Screen reader, alt text, AI prompts, emoji accessibility, tooltips e UI wording entram na manutenção regular. | [M1] |
O que mudou para o technical writer
Da página isolada para um sistema de conhecimento usado por web, IDE, busca e agentes.
| Período | Objeto principal | Ferramentas típicas | Foco editorial | Entrega | Papel |
|---|---|---|---|---|---|
| 1990–2015 | Manual / página HTML | Word, CMS, XML, publicação especializada | Completude, consistência, reference | Web + PDF | Autor especialista |
| 2016–2020 | Portal orientado a tarefas | CMS + Git/Markdown | Busca, task success, texto web conciso, IA | Portal central | Content owner no product workflow |
| 2021–2024 | Conhecimento estruturado perto do código | Git, Markdown, DITA, DocC, CI | Semântica, reuse, acessibilidade, localização | Portal + IDE + reference gerada | Arquiteto de informação + automação |
| 2025–2026 | Fonte de conhecimento para pessoas e IA | Source + metadata + schemas + retrieval interfaces | Grounding, encontrabilidade, qualidade factual, consumo por máquinas | Portal + IDE + busca + MCP/AI | Editor, designer de sistema, verificador |
A mudança decisiva é assumir o sistema de conhecimento: estrutura, verificação, manutenção, busca e integração com desenvolvimento.
O que vale copiar
A comparação mostra quatro escolas fortes: regras editoriais do Google, infraestrutura da Microsoft, modelo de qualidade da IBM e integração com código da Apple.
| Colocar condições antes da instrução | O leitor sabe se a etapa se aplica antes de agir. |
|---|---|
| Não depender só de cor ou posição | Acessibilidade melhora também leitura rápida e localização. |
| Escrever para audiência global | Evitar expressões locais facilita tradução. |
| Priorizar clareza sobre obediência mecânica ao guide | Google permite desvio quando o resultado fica mais claro. |
Microsoft
[M2]| Dizer mais com menos palavras | Concisão faz parte do design da experiência. |
|---|---|
| Remover `you can` desnecessário | A instrução direta é mais fácil de escanear. |
| Manter o guide como produto vivo | O changelog atualiza AI prompts, acessibilidade, terminologia e UI wording. |
| Separar feedback de edição | Learn combina feedback com edição no GitHub quando as fontes são públicas. |
IBM
[I2]| Revisar características concretas de qualidade | Task orientation, accuracy, completeness, clarity, style, organization e retrievability tornam a revisão verificável. |
|---|---|
| Modelar tipos de conteúdo | How-to, API reference, troubleshooting e release notes fazem parte de um modelo formal. |
| Reutilizar semanticamente | Referências DITA/Markdown mantêm conteúdo repetido sincronizado. |
| Defender a tarefa do usuário | Qualidade começa pelo objetivo do usuário. |
Apple
[A3]| Manter docs perto do código | DocC reúne source comments, Markdown, assets e API reference. |
|---|---|
| Tratar tutorials como conteúdo principal | Aprendizado guiado usa o mesmo toolchain que reference. |
| Construir docs dentro do developer workflow | Xcode e DocC aproximam implementação e explicação. |
| Tratar palavras como interface | Tone e wording fazem parte da experiência do usuário. |
Fontes oficiais
A base de evidências é formada por materiais oficiais primários de Google, Microsoft, IBM e Apple.
Conclusão: vencedores claros para tarefas diferentes
| Empresa | Ponto forte | Conclusão da pesquisa |
|---|---|---|
| Microsoft | Infraestrutura | Documentação, aprendizado, versões, feedback e acesso para IA formam o sistema mais integrado. |
| Regras editoriais | O style guide público mais transparente, com changelog ativo, acessibilidade e escrita global. | |
| IBM | Modelo de qualidade | A formalização mais sistemática de qualidade, tipos de conteúdo, encontrabilidade e reutilização. |
| Apple | Integração com código | DocC conecta API reference, artigos, tutorials e código-fonte com especial proximidade. |
Nosso vencedor geral é a Microsoft: nenhuma outra plataforma combina documentação, aprendizado, versões, feedback e acesso por máquina de forma tão completa.
O Google vence como referência editorial diária. O guia transforma clareza, acessibilidade e escrita global em decisões concretas para o trabalho do redator.
A IBM é especialmente forte para equipes maduras porque formaliza qualidade, tipos de conteúdo, encontrabilidade, métricas, feedback e manutenção.
A Apple aponta a direção mais convincente para developer documentation: reference, artigos conceituais e tutorials vivem junto do código e passam pelo mesmo toolchain.
O modelo mais forte combina a lógica de plataforma da Microsoft, a disciplina editorial do Google, o sistema de qualidade da IBM e o workflow integrado ao código da Apple.