However, Dokka does support embedding documentation from

.md

files, so you can leverage that. There's no strict rules on where the files should be defined though, as long as you can pass it to Dokka. Example of what it'll look like: https://kotlinlang.org/api/kotlinx.coroutines/ Given that it's a simple markdown file, you don't have to use Dokka and can just read it from within the IDE, of course. Documentation on this: https://kotlinlang.org/docs/dokka-module-and-package-docs.html For instance, in

kotlinx.coroutines

you have

README.md

files in the root of each module, which contain descriptions for both the module (only one) and the packages within it. Example: https://github.com/Kotlin/kotlinx.coroutines/blob/master/kotlinx-coroutines-core/README.md In

kotlinx.serialization

there's a single file in the root of the project that describes all modules and all packages at once. Example: https://github.com/Kotlin/kotlinx.serialization/blob/master/dokka/moduledoc.md