Contributing to Nengo SPA

Issues and pull requests are always welcome! We appreciate help from the community to make Nengo SPA better.

Filing issues

If you find a bug in Nengo SPA, or think that a certain feature is missing, please consider filing an issue. Please search the currently open issues first to see if your bug or feature request already exists. If so, feel free to add a comment to the issue so that we know that multiple people are affected.

Making pull requests

If you want to fix a bug or add a feature to Nengo SPA, we welcome pull requests. We try to maintain 100% test coverage, so any new features should also include unit tests to cover that change. If you fix a bug it’s also a good idea to add a unit test, so the bug doesn’t get un-fixed in the future!

Building the documentation

To build the documentation install the required dependencies by running the following command from the root folder of the Nengo SPA source code:

python setup.py -e .[docs]

To build the documentation use one of the following commands:

python setup.py build_sphinx

or if you need set explicitly set the Jupyter kernel for building the notebooks included in the documentation:

sphinx-build docs docs/_build -D nbsphinx_kernel_name=<kernelname>

You will find the build documentation in the docs/_build folder.

Contributor agreement

We require that all contributions be covered under our contributor assignment agreement. Please see the agreement for instructions on how to sign.