Skip to content

Documentation Structure

The file structure of the documentation produced changes, depending on options passed to Markista.

Basic Java Project

In this basic Java project there are no package-info.java or module-info.java files.

Source Code Module Structure

Running Markista with the default options, the following documentation file structure is created:

The documentation is created in a directory with the same name as the project directory as there is no module name to use for it. The top-level index.md file lists the packages that have been documented.

Modular Java Project

In this modular Java project, there are package-info.java and module-info.java files.

Source Code Module Structure

Running Markista with the default options, the following documentation file structure is created with the standard Javadoc layout:

The documentation is created in a directory with the same name as the package being documented. The top-level index.md file is the package documentation, which can contain the package's directives (requires, exports, etc) with links to contained packages and other modules (if relevant).

To flatten the directory structure, run Markista with the --flatten-packages option.

The following documentation file structure is created: