CONTRIBUTING.rst

Contributing to nrtk-explorer

1. Clone the repository using git clone
2. Install pre-commit via pip install pre-commit
3. Run pre-commit install to set up pre-commit hooks
4. Make changes to the code, and commit your changes to a separate branch
5. Create a fork of the repository on GitHub
6. Push your branch to your fork, and open a pull request

Tips

1. When first creating a new project, it is helpful to run pre-commit run --all-files to ensure all files pass the pre-commit checks.
2. A quick way to fix black issues is by installing black (pip install black) and running the black command at the root of your repository.
3. Sometimes, black and flake8 do not agree. Add options to your .flake8 file to fix these things. See the flake8 configuration docs for more details.
4. A quick way to fix codespell issues is by installing codespell (pip install codespell) and running the codespell -w command at the root of your directory.
5. The .codespellrc file can be used fix any other codespell issues, such as ignoring certain files, directories, words, or regular expressions.