Kotlin documentation learning, language guide, platforms, API reference और migration content को एक production system में जोड़ती है।

Structural review में DocLint rules का उपयोग किया गया और editorial review official sources पर manually किया गया।

क्या जाँचा गया

15 अगस्त 2026 तक उपलब्ध public sources.

320

Markdown topics

2

.topic files

16

Tour lessons

2.4.0

stable version

10

criteria

Portal एक बड़ी किताब नहीं है

Learning, tasks, concepts, reference और release content अलग रखे गए हैं।

User needकहाँ जाएँक्या मिलता है
TryTour और PlaygroundIDE के बिना शुरुआत.
StartGet startedPlatform और goal आधारित paths.
UnderstandLanguage guideConcepts और syntax.
APIDokkaSeparate reference.
UpgradeWhat’s new और migrationVersion-specific content.
LibraryKDoc और author guidesPublic API quality.

Implementation

Mature docs-as-code architecture.

1

Markdown + Writerside

Content और navigation.

2

Multiple repos

Sub-documentation integration.

3

CI

Runnable examples verify होते हैं.

4

Publishing

TeamCity build और post-processing.

Editorial score: 82/100

Onboarding, examples और engineering बहुत मजबूत हैं. Localization और troubleshooting कमजोर हैं.

Onboarding
9/10
Architecture
9/10
Examples
10/10
Reference
9/10
Versions
9/10
Troubleshooting
7/10
Findability
8/10
Clarity
8/10
Engineering
10/10
Localization
3/10

82/100

सबसे मजबूत हिस्से

Tour without install

[K3]

16 browser lessons.

Verified examples

[G4]

Runnable snippets CI में check होते हैं.

Navigation as code

[G3]

kr.tree structure को version करता है.

Release docs

[K10]

Documentation changes releases के साथ आती हैं.

Author guidance

[K7]

Personas, failures और API design.

AI maintenance

[G7]

Repo में reproducible agent skills हैं.

अच्छी और कमजोर formulations

Strong engineering editing की जरूरत खत्म नहीं करती.

CriterionWordingAnalysis
Good“New to Kotlin? Take our tour…” [K2]Direct action.
Good“Begin the description of entry points…” [K7]Reviewable rule.
Rewrite“The Kotlin Standard Library provides…” [K5]Opening बहुत abstract है.
Fix“Attempting to access properties…” [K4]अगला example compile error दिखाता है.

क्या कम है

Gapमहत्त्व
Official translationsMain portal English-only है. [K9]
Unified journeyCore, KMP और API अलग spaces लगते हैं. [K11]
Consistent troubleshootingCoverage area के अनुसार बदलती है. [G3]
Tighter proseकुछ foundational pages छोटे हो सकते हैं. [K5]

Evolution

2.1.0

Foundational pages revamped. [K10]

2.2.0

Intermediate Tour और separate KMP portal. [K11]

2.2.20

Web, coroutines और Native docs expanded. [K12]

2.4.0

AI skills, LSP, KSP और Lincheck. [K13]

क्या अपनाएँ

Practiceक्या अपनाएँ
Navigation as codeInformation architecture version करें.
Verified examplesSamples CI में test करें.
Separate content typesTutorial, concept और reference अलग रखें.
Release docsMigration product change के साथ update करें.
Docs as design testDifficult onboarding API problem दिखा सकता है.
AI skillsAgents को explicit steps और validation दें.

Primary sources

[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

निष्कर्ष

Kotlin की सबसे बड़ी ताकत documentation production system है.

Reader journey learning, concepts, reference और migration को सही तरह अलग करती है.

Localization, troubleshooting और tighter editing अगले बड़े सुधार हैं.

Kotlin एक mature documentation engineering model दिखाता है जिसमें examples verify होते हैं और maintenance automation-ready है.