This repository is the source for https://kotlinlang.org.
| Website page | Source files |
|---|---|
| Main page | templates/pages/index.html |
| Kotlin docs | docs/topics |
| Community | docs/pages/community |
| Education | docs/pages/education |
Note that source files for the server-side landing page and KMM landing page are not publicly available.
Source files for KMM docs, coroutine docs, and language specification are stored in separate repositories:
| Website page | GitHub repository |
|---|---|
| KMM docs | kotlin-mobile-docs |
| Coroutine docs | kotlinx.coroutines |
| Language specification | kotlin-spec |
API reference documentation is generated based on comments in the Kotlin code. Learn more about documenting the Kotlin code.
The Kotlin grammar reference is generated by the Kotlin grammar generator from the Kotlin grammar definition.
| Configuration | File |
|---|---|
| Navigation and structure | kr.tree for docs and _nav.yml for other pages |
| Variables, such as release version | v.list for docs and releases.yml for other pages |
| Community events on the map | events.xml |
| Video list (outdated) | videos.yml |
The Kotlin website uses Jinja2 templates from the templates directory.
Note that all Markdown files, except for docs, are processed as Jinja templates before HTML conversion.
This allows using all Jinja benefits for Markdown (for example, building URLs with the url_for function).
You can contribute to the Kotlin website by sending us a pull request. If you're going to propose a big change, discuss your idea with the team via doc-feedback@kotlinlang.org.
For the Kotlin documentation, follow these guidelines on style and formatting.
For other pages, follow the complete syntax reference at the kramdown site. You can also include metadata fields. Learn more in the Jekyll docs.
Currently, there is no way to deploy the Kotlin website locally. This ticket tracks the effort of adding support for local testing: KT-47049.
You can contribute to the Kotlin website by sending us a pull request.
You can:
- Share feedback in the #docs-revamped channel in our Kotlin public Slack (get an invite).
- Report an issue to our issue tracker.
- Email us at doc-feedback@kotlinlang.org.