La documentación de Kotlin combina aprendizaje, guía del lenguaje, plataformas, referencia API, migraciones y documentación de bibliotecas.
Para la parte estructural se usaron las reglas de DocLint y la evaluación editorial se realizó manualmente sobre fuentes oficiales.
Qué revisamos
Corte de fuentes públicas disponible el 15 de agosto de 2026.
temas Markdown
archivos .topic
lecciones de Kotlin Tour
versión estable
criterios
El portal no es un solo libro
Kotlin separa aprendizaje, tareas, conceptos, referencia y cambios de versión.
| Necesidad | Dónde ir | Resultado |
|---|---|---|
| Probar el lenguaje | Kotlin Tour y Playground | Ejercicios sin instalar IDE. |
| Empezar un proyecto | Get started y tutoriales | Rutas por plataforma y objetivo. |
| Entender el lenguaje | Language guide | Conceptos y sintaxis. |
| Consultar API | Dokka | Referencia separada del aprendizaje. |
| Actualizar | What’s new y migraciones | Cambios por versión. |
| Crear bibliotecas | KDoc y guías para autores | Calidad de API pública. |
Cómo está implementado
Arquitectura docs-as-code madura.
Markdown + Writerside
Contenido y árbol de navegación.
Varios repositorios
Documentación externa integrada.
CI
Ejemplos ejecutables verificados.
Publicación
TeamCity y postprocesado.
Evaluación editorial: 82/100
Fortalezas en onboarding, ejemplos e ingeniería. Debilidades en localización y troubleshooting.
82/100
Lo mejor
Tour sin instalación
[K3]16 lecciones en el navegador.
Ejemplos verificados
[G4]Los snippets ejecutables se comprueban en CI.
Navegación como código
[G3]kr.tree versiona la arquitectura de información.
Documentación por release
[K10]Las versiones publican también cambios documentales.
Guías para autores
[K7]Personas, fallos, ejemplos y diseño de API.
Mantenimiento asistido por IA
[G7]El repositorio ya define skills repetibles.
Formulaciones acertadas y mejorables
La ingeniería fuerte no elimina la necesidad de edición.
| Criterio | Texto | Análisis |
|---|---|---|
| Bien | “New to Kotlin? Take our tour…” [K2] | Audiencia y acción directas. |
| Bien | “Begin the description of entry points…” [K7] | Regla verificable. |
| Reescribir | “The Kotlin Standard Library provides…” [K5] | Inicio demasiado abstracto. |
| Corregir | “Attempting to access properties…” [K4] | El ejemplo siguiente produce error de compilación. |
Qué falta
| Carencia | Importancia |
|---|---|
| Traducciones oficiales | El portal principal solo se publica en inglés. [K9] |
| Recorrido más unificado | Core docs, KMP y API se sienten como espacios distintos. [K11] |
| Troubleshooting más uniforme | La cobertura de errores varía entre áreas. [G3] |
| Prosa más corta | Algunas páginas básicas pueden editarse con más fuerza. [K5] |
Evolución
Qué copiar
| Práctica | Qué adoptar |
|---|---|
| Navegación como código | Versionar la IA. |
| Ejemplos verificados | Probar snippets en CI. |
| Tipos de contenido separados | Distinguir tutorial, concepto y referencia. |
| Docs en el release | Actualizar migraciones con el producto. |
| Docs como prueba del diseño | Un onboarding difícil puede revelar una API difícil. |
| AI con procedimientos | Skills concretos y verificables. |
Fuentes primarias
Conclusión
Kotlin destaca como sistema de producción documental, no solo por páginas individuales.
El recorrido del lector está bien dividido entre aprendizaje, conceptos, referencia y migración.
Las mejoras prioritarias son localización oficial, troubleshooting uniforme y edición más estricta.
Kotlin muestra una arquitectura documental madura con ejemplos verificados y mantenimiento preparado para automatización.