La documentation Kotlin combine apprentissage, guide du langage, plateformes, référence API et migrations.

Les règles DocLint ont servi à la partie structurelle, puis l’analyse éditoriale a été réalisée manuellement sur les sources officielles.

Périmètre

Sources publiques au 15 août 2026.

320

sujets Markdown

2

fichiers .topic

16

leçons du Tour

2.4.0

version stable

10

critères

Le portail n’est pas un livre unique

Apprentissage, tâches, concepts, référence et releases sont séparés.

BesoinDestinationRésultat
EssayerTour et PlaygroundCommencer sans IDE.
DémarrerGet startedPar plateforme et objectif.
ComprendreLanguage guideConcepts et syntaxe.
RéférenceDokkaAPI séparée.
Mettre à jourWhat’s new et migrationsContenu versionné.
Créer une bibliothèqueKDoc et guides auteursQualité des API publiques.

Implémentation

Architecture docs-as-code mature.

1

Markdown + Writerside

Contenu et navigation.

2

Plusieurs dépôts

Sous-documentations intégrées.

3

CI

Exemples exécutables vérifiés.

4

Publication

TeamCity construit et post-traite.

Évaluation éditoriale : 82/100

Très bon onboarding, exemples et engineering. Localisation et troubleshooting restent en retrait.

Onboarding
9/10
Architecture
9/10
Exemples
10/10
Référence
9/10
Versions
9/10
Troubleshooting
7/10
Recherche
8/10
Clarté
8/10
Engineering
10/10
Localisation
3/10

82/100

Points forts

Tour sans installation

[K3]

16 leçons dans le navigateur.

Exemples vérifiés

[G4]

Les snippets exécutables sont testés en CI.

Navigation comme code

[G3]

kr.tree versionne la structure.

Docs par release

[K10]

Les mises à jour documentaires accompagnent les releases.

Guides auteurs

[K7]

Personas, échecs et conception API.

Maintenance assistée par IA

[G7]

Le dépôt contient déjà des skills reproductibles.

Formulations à garder ou revoir

L’ingénierie ne remplace pas l’édition.

CritèreFormulationAnalyse
Réussi“New to Kotlin? Take our tour…” [K2]Direct et orienté action.
Réussi“Begin the description of entry points…” [K7]Règle vérifiable.
À réécrire“The Kotlin Standard Library provides…” [K5]Introduction trop abstraite.
À corriger“Attempting to access properties…” [K4]L’exemple suivant montre une erreur de compilation.

Ce qui manque

ManqueImportance
Traductions officiellesLe site principal reste anglais. [K9]
Parcours plus unifiéCore, KMP et API restent des espaces distincts. [K11]
Troubleshooting homogèneLa profondeur varie selon les sections. [G3]
Prose plus serréeCertaines pages de base sont trop longues. [K5]

Évolution

2.1.0

Refonte de pages fondamentales. [K10]

2.2.0

Intermediate Tour et portail KMP séparé. [K11]

2.2.20

Extension des docs web, coroutines et Native. [K12]

2.4.0

AI skills, LSP, KSP et Lincheck. [K13]

Pratiques à reprendre

PratiqueÀ reprendre
Navigation comme codeVersionner l’architecture.
Exemples vérifiésTester les snippets en CI.
Types de contenu séparésDistinguer tutoriel, concept et référence.
Docs dans le releaseMettre à jour les migrations avec le produit.
Docs comme test de designUn onboarding difficile peut révéler une API difficile.
AI avec procéduresDonner aux agents des skills vérifiables.

Sources primaires

[K1]kotlinlang.org/docs/reference/[K2]kotlinlang.org/docs/getting-started.html[K3]kotlinlang.org/docs/kotlin-tour-welcome.html[K4]kotlinlang.org/docs/null-safety.html[K5]kotlinlang.org/docs/collections-overview.html[K6]kotlinlang.org/docs/coding-conventions.html[K7]kotlinlang.org/docs/api-guidelines-informative-documentation.html[K8]kotlinlang.org/docs/kotlin-doc.html[K9]kotlinlang.org/docs/contribute.html[K10]kotlinlang.org/docs/whatsnew21.html[K11]kotlinlang.org/docs/whatsnew22.html[K12]kotlinlang.org/docs/whatsnew2220.html[K13]kotlinlang.org/docs/whatsnew24.html[G1]github.com/JetBrains/kotlin-web-site[G2]github.com/JetBrains/kotlin-web-site/blob/master/docs/writerside.cfg[G3]github.com/JetBrains/kotlin-web-site/blob/master/docs/kr.tree[G4]github.com/JetBrains/kotlin-web-site/blob/master/.github/workflows/verify-samples.yml[G5]github.com/JetBrains/kotlin-web-site/blob/master/.teamcity/documentation/builds/WritersideBuilder.kt[G6]github.com/JetBrains/kotlin-web-site/blob/master/.teamcity/documentation/builds/KotlinWithCoroutines.kt[G7]github.com/JetBrains/kotlin-web-site/blob/master/.claude/skills/add-writerside-doc-module/SKILL.md[G8]github.com/JetBrains/kotlin-web-site/blob/master/.claude/skills/add-api-reference/SKILL.md

Conclusion

Kotlin se distingue surtout par son système de production documentaire.

Le parcours utilisateur sépare correctement apprentissage, concepts, référence et migration.

Les priorités suivantes sont la localisation, le troubleshooting et une édition plus stricte.

Kotlin montre une architecture documentaire mature, avec exemples vérifiés et maintenance automatisable.