From ce186d882fc39180403bf8d3a10a76328e565921 Mon Sep 17 00:00:00 2001 From: erexer <13180883+erexer@users.noreply.github.com> Date: Wed, 21 Feb 2024 14:39:07 -0800 Subject: [PATCH] add pre-commit instructions to contributing.rst --- README.md | 8 ++++---- docs/source/contributing.rst | 11 +++++++++-- 2 files changed, 13 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 538640a5d7..321663d19d 100755 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ # naturf -#### `naturf` (Neighborhood Adaptive Tissues for Urban Resilience Futures) is an open-source geospatial Python package for calculating urban building parameters to be compiled and input to the Weather Research and Forecasting model (WRF). +#### Neighborhood Adaptive Tissues for Urban Resilience Futures (`naturf`) is an open-source geospatial Python package that calculates and compiles urban building parameters to be input to the Weather Research and Forecasting model (WRF). ### Purpose `naturf` was created to: @@ -14,7 +14,7 @@ - Compile the parameters at sub-kilometer resolutions into binary files, - Prepare binary files to be fed into WRF to understand the effect of building morphology on the urban microclimate. -### Install `naturf` +### Install ```bash pip install naturf @@ -26,9 +26,9 @@ Run `naturf` using the quickstart tutorial: [`naturf` Quickstarter](https://immm ### User guide -Our user guide provides in-depth information on the key concepts of `naturf` with useful background information and explanation. See our [User Guide](https://immm-sfa.github.io/naturf/user_guide.html) +Our [user guide](https://immm-sfa.github.io/naturf/user_guide.html) provides in-depth information on the key concepts of `naturf` with useful background information and explanation. -### Contributing to `naturf` +### Contributing Whether you find a typo in the documentation, find a bug, or want to develop functionality that you think will make `naturf` more robust, you are welcome to contribute! See our [Contribution Guidelines](https://immm-sfa.github.io/naturf/contributing.html) diff --git a/docs/source/contributing.rst b/docs/source/contributing.rst index f0abf7ce88..02edde794d 100644 --- a/docs/source/contributing.rst +++ b/docs/source/contributing.rst @@ -21,12 +21,19 @@ The following is the recommended workflow for contributing to **naturf**: git clone https://github.com//naturf - Cloning the repository will give you access to the test suite. It is important to install the package in development mode before running tests. This will give you the flexibility to make changes in the code without having to rebuild your package before running tests. To do this run the following from your terminal in the **naturf** directory containing your ``setup.py`` script: + Cloning the repository will give you access to the test suite. It is important to install the package in development mode before running tests. This will give you the flexibility to make changes in the code without having to rebuild your package before running tests. : .. code-block:: bash - python setup.py develop + cd naturf + pip install -e . + + `Install \`pre-commit\` `_, then install the hooks within the repo to auto format code: + + .. code-block:: bash + + pre-commit install 2. Create a branch for your changes