Writing

Write plain technical English for readers who may use English as a second language. Library users usually know Compose but need MapLibre concepts explained. Contributors know Kotlin Multiplatform and need the reasons for project-specific decisions.

Lead with the fact, action, or decision the reader needs. Prefer concrete nouns, direct verbs, and explicit conditions. Avoid promotional language, stock transitions, and metaphors that obscure API behavior. Include the detail the reader needs to understand the subject.

Use paragraphs for explanations, lists for steps or parallel items, and tables for comparisons. Headings use sentence case and identify sections that readers can navigate. Link to existing explanations instead of repeating them.

Documentation site

Pages under docs/src/content/docs/ follow the site's Diátaxis structure: