2019-06-10 12:25:00 -07:00
|
|
|
[![Documentation Status](https://readthedocs.org/projects/goquorum/badge/?version=latest)](http://docs.goquorum.com/en/latest/?badge=latest)
|
2016-11-14 16:23:29 -08:00
|
|
|
|
|
|
|
# Quorum documentation
|
|
|
|
|
2019-06-10 12:25:00 -07:00
|
|
|
New Quorum documentation is now published on https://docs.goquorum.com/
|
|
|
|
|
|
|
|
## How to contribute
|
|
|
|
|
|
|
|
Quorum documentation files are written in Markdown and configured with a
|
|
|
|
YAML configuration file from [mkdocs](https://www.mkdocs.org/)
|
|
|
|
|
|
|
|
The documentation site uses [Material theme](https://squidfunk.github.io/mkdocs-material/)
|
|
|
|
which has been configured with number of theme [extensions](https://squidfunk.github.io/mkdocs-material/extensions/admonition/)
|
|
|
|
to enhance documenting experience
|
|
|
|
|
|
|
|
To contribute, here is 3 simple steps
|
|
|
|
|
|
|
|
- Use Python to install `mkdocs` and related dependencies
|
|
|
|
```bash
|
|
|
|
pip install -r requirements.txt
|
|
|
|
```
|
|
|
|
- Add/Modify desired documentation files and preview the site
|
|
|
|
```bash
|
|
|
|
mkdocs serve
|
|
|
|
```
|
|
|
|
- Commit and raise PR against master
|