# Developers

If you would like to contribute to sphinxcontrib.spelling directly, these instructions should help you get started. Patches, bug reports, and feature requests are all welcome through the GitHub site. Contributions in the form of patches or pull requests are easier to integrate and will receive priority attention.

## Running tests

To run the tests, you need `tox` installed, then just run `tox`. This should run the unit tests, the source code linter, and try to build the current documentation.

## Coding style

Python imports are formatted and sorted using isort. To format all files, run:

    $ tox -e style

## Building Documentation

The documentation for sphinxcontrib.spelling is written in reStructuredText and converted to HTML using Sphinx. The build is driven by `tox`. To build only the documentation, run `tox -e docs`.

## Contributing

Please submit changes as pull requests using the GitHub repository.

In the pull request description, link to any issues closed by the changes using `Fixes #NUM`, replacing `NUM` with the issue number.

## Release Notes

Please add a release note for each pull request to `docs/history.rst`.