juju documentation

Summary

Generate the documentation for all commands

Usage

juju documentation [options] --out <target-folder> --no-index --split --url <base-url> --discourse-ids <filepath>

Options

Flag

Default

Usage

--discourse-ids

File containing a mapping of commands and their discourse ids

--no-index

false

Do not generate the commands index

--out

Documentation output folder if not set the result is displayed using the standard output

--split

false

Generate a separate Markdown file for each command

--url

Documentation host URL

Examples

juju documentation
juju documentation --split 
juju documentation --split --no-index --out /tmp/docs

To render markdown documentation using a list of existing commands, you can use a file with the following syntax

command1: id1
command2: id2
commandN: idN

For example:

add-cloud: 1183
add-secret: 1284
remove-cloud: 4344

Then, the urls will be populated using the ids indicated in the file above.

juju documentation --split --no-index --out /tmp/docs --discourse-ids /tmp/docs/myids

Details

This command generates a markdown formatted document with all the commands, their descriptions, arguments, and examples.