A documentação Kotlin combina aprendizado, guia da linguagem, plataformas, referência de API e migrações.
As regras do DocLint foram usadas na parte estrutural e a análise editorial foi feita manualmente com fontes oficiais.
Escopo
Fontes públicas em 15 de agosto de 2026.
tópicos Markdown
arquivos .topic
lições do Tour
versão estável
critérios
O portal não é um único livro
Aprendizado, tarefas, conceitos, referência e releases ficam separados.
| Necessidade | Onde ir | Resultado |
|---|---|---|
| Experimentar | Tour e Playground | Começar sem IDE. |
| Criar projeto | Get started | Rotas por plataforma e objetivo. |
| Entender | Language guide | Conceitos e sintaxe. |
| Consultar API | Dokka | Referência separada. |
| Atualizar | What’s new e migração | Conteúdo por versão. |
| Criar biblioteca | KDoc e guias | Qualidade da API pública. |
Implementação
Arquitetura docs-as-code madura.
Markdown + Writerside
Conteúdo e navegação.
Vários repositórios
Subdocumentação integrada.
CI
Exemplos executáveis verificados.
Publicação
TeamCity constrói e pós-processa.
Avaliação editorial: 82/100
Muito forte em onboarding, exemplos e engenharia. Localização e troubleshooting são os principais pontos fracos.
82/100
Pontos fortes
Tour sem instalação
[K3]16 lições no navegador.
Exemplos verificados
[G4]Snippets executáveis são testados em CI.
Navegação como código
[G3]kr.tree versiona a estrutura.
Docs por release
[K10]Mudanças documentais acompanham versões.
Guia para autores
[K7]Personas, falhas e design de API.
Manutenção com IA
[G7]O repositório já contém skills reproduzíveis.
Formulações boas e fracas
Boa engenharia não elimina edição.
| Critério | Formulação | Análise |
|---|---|---|
| Boa | “New to Kotlin? Take our tour…” [K2] | Direta e orientada à ação. |
| Boa | “Begin the description of entry points…” [K7] | Regra verificável. |
| Reescrever | “The Kotlin Standard Library provides…” [K5] | Abertura abstrata demais. |
| Corrigir | “Attempting to access properties…” [K4] | O exemplo seguinte produz erro de compilação. |
O que falta
Evolução
O que copiar
| Prática | Adotar |
|---|---|
| Navegação como código | Versionar a arquitetura. |
| Exemplos verificados | Testar snippets em CI. |
| Tipos separados | Distinguir tutorial, conceito e referência. |
| Docs no release | Atualizar migração junto com o produto. |
| Docs como teste de design | Onboarding difícil pode revelar API difícil. |
| AI com skills | Dar procedimentos verificáveis aos agentes. |
Fontes primárias
Conclusão
Kotlin se destaca como sistema de produção documental.
A jornada do leitor separa aprendizado, conceitos, referência e migração.
As prioridades são localização, troubleshooting e edição mais forte.
Kotlin mostra uma arquitetura documental madura com exemplos verificados e manutenção automatizável.