Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add clarity for installing dependencies and pip command for Graphviz #304

11 changes: 9 additions & 2 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,14 +102,21 @@ tool. You must have a recent version of Python 3.6+ installed to build the proje
locally. It is also recommended having `make` (otherwise look at the commands used
in `Makefile`).

The `dot` program from Graphviz is needed to render some of the diagrams.

* For Debian/Ubuntu users:
```bash
sudo apt get install graphviz
```
* For non-Debian/Ubuntu users, follow the directions at [the GraphViz download site](https://graphviz.org/download).
```bash
# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate
# update the version of pip, setuptools, and wheel
(venv) pip install -U pip setuptools wheel
# Install the dependencies in your virtual environment
(venv) pip install .[all]
# Install all the dependencies in your virtual environment.
(venv) pip install ".[all]"
# Create the HTML to visualize locally
(venv) make html
(venv) open _build/index.html
Expand Down