diff options
| -rw-r--r-- | docs/contributing.rst | 4 | ||||
| -rw-r--r-- | docs/installation.rst | 6 |
2 files changed, 10 insertions, 0 deletions
diff --git a/docs/contributing.rst b/docs/contributing.rst index 2a3af02..1ab6300 100644 --- a/docs/contributing.rst +++ b/docs/contributing.rst @@ -71,6 +71,10 @@ Coding Conventions * Follow `PEP-8 conventions <https://www.python.org/dev/peps/pep-0008/>`__ * NOTE: The only variation is that the line-length can be 88 characters vs. 80 +* All code must be formatted using the `Black <https://black.readthedocs.io/>`__ + code formatter. VVP uses the `pre-commit library <https://pre-commit.com/>`__ + to automatically format code at check-in. After running ``pip install``, + run ``pre-commit install`` to initialize the git hook. * Familiarize yourself with the utilities that exist in the following utility modules and leverage them to avoid duplication. diff --git a/docs/installation.rst b/docs/installation.rst index a20bbed..2e561fd 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -52,3 +52,9 @@ or its `GitHub mirror <https://github.com/onap/vvp-validation-scripts>`__. 3. Install the required dependencies with the following command:: > python pip install -r requirements.txt + +4. If you plan to make code changes, then initialize the standard git + commit hooks by initializing pre-commit:: + + > pre-commit install + |