Skip to content

Latest commit

 

History

History
37 lines (26 loc) · 1.36 KB

nb_docs.md

File metadata and controls

37 lines (26 loc) · 1.36 KB

Editing NoSQLBench Docs

The docs that are hosted at docs.nosqlbench.io are built from markdown files found in this project. To make changes or to author these docs, you need to know where to find them.

NoSQLBench docs

The core docs are found under the engine-docs module under /src/main/resources/docs-for-nb/ .

By browsing this directory structure and looking at the frontmatter on each markdown file, you'll get a sense for how they are orgainzed.

Driver Docs

Some of the other docs are found within each driver module. For example, the cql docs are found in the resources root directory of the cql driver module. This is the case for any basic docs provided for a driver. The docs are bundled with modules to allow for them to be maintained by the driver maintainers directly.

Binding Function Docs

All of the binding function docs are generated automatically from source. Javadoc source as well as annotation details are used to decorate the binding functions so that the can be cataloged and shared to the doc site. To improve the binding function docs, you must improve the markdown rendering code which is responsible for this.

Suggestions

The doc system in NoSQLBench is a core element, but it is not really great yet nor is it done. Any help on improving it is appreciated, in any form.