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: