Developer's Guide¶
This section gives function and class definitions used in the development of ZFBrain.
Docstrings¶
ZFBrain uses a style derived from NumPy’s docstrings style, which includes giving the types of function arguments.
Documentation¶
Documentation is generated with sphinx and hosted on ReadTheDocs. To generate documentation locally, make sure you are in the “docs” subfolder and type make html in a terminal. Then, the documentation can be found locally in the “docs/html” folder. The “homepage” is the index.rst file.
Testing¶
ZFBrain uses the python unittest package for testing and Travis runs these tests on every commit. To run tests locally before submitting a PR, make sure you are in the home directory of ZFBrain and type python3 -m unittest -v.