Skip to content

Commit

Permalink
Merge pull request #372 from Living-with-machines/rw_docs
Browse files Browse the repository at this point in the history
Update docs
  • Loading branch information
rwood-97 authored Mar 18, 2024
2 parents 32e8b91 + 3432f08 commit 141fa00
Show file tree
Hide file tree
Showing 2 changed files with 27 additions and 1 deletion.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ The MapReader documentation can be found at https://mapreader.readthedocs.io/en/
- Geospatial images (i.e. maps)
- Non-geospatial images

**Developers and contributors** may also want to refer to the [API documentation](https://mapreader.readthedocs.io/en/latest/api/index.html) and [Contribution guide](https://mapreader.readthedocs.io/en/latest/Contribution-guide.html) for guidance on how to contribute to the MapReader package.
**Developers and contributors** may also want to refer to the [API documentation](https://mapreader.readthedocs.io/en/latest/api/index.html) and [Contribution guide](https://mapreader.readthedocs.io/en/latest/Contribution-guide/Contribution-guide.html) for guidance on how to contribute to the MapReader package.

**Join our Slack workspace!**
Please fill out [this form](https://forms.gle/dXjECHZQkwrZ3Xpt9) to receive an invitation to the Slack workspace.
Expand Down
26 changes: 26 additions & 0 deletions docs/source/Contribution-guide/Code.rst
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,19 @@ In either case, before you begin working, either assign yourself to the issue or

You will then need to fork the `MapReader repository <https://github.com/Living-with-machines/MapReader>`_ in order to make your changes.

Installation in development mode
--------------------------------

To ensure you have all the required dependencies for development, in your development environment, please install MapReader using the following commands:

.. code-block:: bash
git clone https://github.com/Living-with-machines/MapReader.git
cd MapReader
pip install -e ".[dev]"
This will install MapReader in development mode, which means you can make changes to the code and see the effects without having to reinstall the package.

Style guide
-----------

Expand All @@ -36,6 +49,19 @@ When you are done making changes, please:
- Run `black <https://black.readthedocs.io/en/stable/>` to reformat your code
- Run `flake8 <https://flake8.pycqa.org/en/latest/index.html#>` to lint your code.


Running tests
-------------

To run the tests, use the following command:

.. code-block:: bash
python -m pytest .
This will run all the tests in the MapReader package.


When you are finished
----------------------

Expand Down

0 comments on commit 141fa00

Please sign in to comment.