Document how to format and lint the code

Fixes #842

1 files changed, 20 insertions, 2 deletions

diff --git a/docs/contributing.md b/docs/contributing.md
index 963dbf6..f9dfc0e 100644
--- a/docs/contributing.md
+++ b/docs/contributing.md
@@ -24,10 +24,28 @@ $ pipenv install --dev
 The rest of this document assumes that the development environment has been
 activated, and that you have the latest development dependencies installed.
 
+## Formatting
+
+The code is formatted with [`black`](https://black.readthedocs.io/). To format
+all the files, first navigate to the project root, and then execute:
+
+```
+$ black .
+```
+
+## Linting
+
+The code is linted with [`flake8`](https://flake8.pycqa.org/). To lint all the
+files, first navigate to the project root, and then execute:
+
+```
+$ flake8 .
+```
+
 ## Testing
 
-Tests are executed with `pytest`. To run the tests, first navigate to the
-project root, and then execute:
+Tests are executed with [`pytest`](https://pytest.org/). To run the tests,
+first navigate to the project root, and then execute:
 
 ```
 $ pytest