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
.