Module documentation
Documentation for a module as a whole, as well as packages in that module, can be provided as separate Markdown files.
File format
Inside the Markdown file, the documentation for the module as a whole and for individual packages is introduced by the corresponding first-level headings. The text of the heading must be Module <module name>
for a module, and Package <package qualified name>
for a package.
The file doesn't have to contain both module and package documentation. You can have files that contain only package or module documentation. You can even have a Markdown file per module or package.
Using Markdown syntax, you can add:
Headings up to level 6
Emphasis with bold or italic formatting
Links
Inline code
Code blocks
Blockquotes
Here's an example file containing both module and package documentation:
To explore an example project with Gradle, see Dokka gradle example.
Pass files to Dokka
To pass these files to Dokka, you need to use the relevant includes option for Gradle, Maven, or CLI:
Use the includes option in Source set configuration.
Use the includes option in General configuration.
If you are using command line configuration, use the includes option in Source set options.
If you are using JSON configuration, use the includes option in General configuration.