From 41073540c13385f64c56648f1a997ef07a1b8baa Mon Sep 17 00:00:00 2001
From: Matt Tancik <tancik@berkeley.edu>
Date: Tue, 14 Jun 2022 09:42:25 -0700
Subject: [PATCH] Update contributing

---
 docs/index.rst                 |  2 +-
 docs/tutorials/contributing.md | 54 ++++++++++++++++++++++++++++++++--
 2 files changed, 53 insertions(+), 3 deletions(-)

diff --git a/docs/index.rst b/docs/index.rst
index 046552332..78f377051 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -27,7 +27,7 @@ Contents
    tutorials/quickstart.md
    tutorials/creating_dataset.md
    tutorials/creating_graphs.md
-   tutorials/contributing.md
+   Contributing <tutorials/contributing.md>
 
 .. toctree::
    :hidden:
diff --git a/docs/tutorials/contributing.md b/docs/tutorials/contributing.md
index 29b31ca7a..deb3c0c83 100644
--- a/docs/tutorials/contributing.md
+++ b/docs/tutorials/contributing.md
@@ -1,11 +1,24 @@
 # Contributing to pyRad workflow
 
+The project is set up for development in VSCode, we reccomend using it if you plan to contribute.
+
+## TLDR
+
+|   |   |
+|---|---|
+| linter | Black |
+| Testing | PyTest |
+| Docs | Sphinx |
+| Docstring style | Google |
+
+## Commiting
+
 1. Make your modifications
 2. Perform local checks
    
    To ensure that you will be passing all tests and checks on github, you will need to run the following command:
 
-   ```
+   ```bash
    python scripts/debugging/run_actions.py
    ```
 
@@ -17,4 +30,41 @@
   
   In order to merge changes to the code base, all of these checks must be passing. If you pass these tests locally, you will likely pass on github servers as well (results in a green checkmark next to your commit).
 
-3. Open pull request
\ No newline at end of file
+3. Open pull request
+
+## Documentation
+
+### Requirements
+
+To install the required packages:
+
+```bash
+pip install -r docs/requirements.txt
+```
+
+You may also need to install [pandoc](https://pandoc.org/). If you are using `conda` you can run the following:
+
+```bash
+conda install -c conda-forge pandoc
+```
+
+### Building
+
+Run the following to build the documentation:
+
+```bash
+cd docs
+make clean
+make html
+```
+
+Rerun `make html` when documentation changes are made, `make clean` is necissary if the documentation structure changes.
+
+### Auto build
+
+If you want the code to build on save you can use [sphinx autobuild](https://github.com/executablebooks/sphinx-autobuild). If changes to the structure are made, the build files may be incorrect.
+
+```bash
+pip install sphinx-autobuild
+sphinx-autobuild docs docs/_build/html
+```