Command line interface
docs-builder
is the binary used to invoke various commands.
These commands can be roughly grouped into three main categories
The following options are available for all commands:
--log-level <level>
- Change the log level one of (
trace
,debug
,info
,warn
,error
,critical
). Defaults toinfo
--config-source
or-c
- Explicitly set the configuration source one of
local
,remote
orembedded
. Defaults tolocal
if available other wiseembedded
Commands that operate over a single documentation set.
A Documentation Set
is defined as a folder containing a docset.yml file.
These commands are typically what you interface with when you are working on the documentation of a single repository locally.
See available CLI commands for documentation sets
Outbound links, those going from the documentation set to other sources, are validated as part of the build process.
Inbound links, those going from other sources to the documentation set, are validated using specialized commands.
See available CLI commands for inbound links
Assembler builds bring together all isolated documentation set builds and turn them into the overall documentation that gets published.