672db5b26b
This commits adds "$" as a prefix for command examples and align with 4 whitespaces. Change-Id: I8c90c8f16b819f0ec141dbf3f6fb99fbce7c5a0c
41 lines
1.2 KiB
Markdown
41 lines
1.2 KiB
Markdown
# Monasca Agent Documentation
|
|
|
|
Please refer to the [project readme](https://github.com/openstack/monasca-agent) for Agent documentation.
|
|
|
|
For full Monasca documentation visit [wiki.openstack.org/wiki/Monasca](https://wiki.openstack.org/wiki/Monasca)
|
|
|
|
# Working with document updates
|
|
|
|
##### Install mkdocs
|
|
$ sudo pip install mkdocs
|
|
|
|
##### Install Nodejs Package Manager NPM
|
|
https://nodejs.org/download/
|
|
|
|
##### Install doctoc
|
|
$ npm install -g doctoc
|
|
|
|
##### Create a mkdocs project structure
|
|
$ cd source/openstack/monasca/monasca-agent
|
|
$ mkdocs new .
|
|
|
|
##### Edit the mkdocs yaml
|
|
site_name: monasca-agent
|
|
repo_url: https://github.com/openstack/monasca-agent
|
|
|
|
##### Move the existing README.md
|
|
$ mv README.md docs
|
|
|
|
##### Copy/create custom docs to the new docs structure
|
|
$ cp README_CUSTOMIZE.md source/openstack/monasca/monasca-agent/docs
|
|
|
|
##### Update the document table of contents on all docs
|
|
$ cd source/openstack/monasca/monasca-agent
|
|
$ find docs/ -name \*.md -exec doctoc {} \;
|
|
|
|
##### View the results
|
|
$ cd source/openstack/monasca/monasca-agent
|
|
$ mkdocs serve
|
|
http://127.0.0.1:8000/
|
|
|