mirror of
https://github.com/nosqlbench/nosqlbench.git
synced 2025-02-25 18:55:28 -06:00
update wip devguide
This commit is contained in:
37
devdocs/devguide/nb_docs.md
Normal file
37
devdocs/devguide/nb_docs.md
Normal file
@@ -0,0 +1,37 @@
|
||||
# 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](../../engine-docs)
|
||||
module
|
||||
under [/src/main/resources/docs-for-nb/](../../engine-docs/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.
|
||||
|
||||
Reference in New Issue
Block a user