Skip to content

Commit

Permalink
Add CONTRIBUTING file
Browse files Browse the repository at this point in the history
  • Loading branch information
hagenw committed Oct 26, 2018
1 parent 47574b9 commit e53e231
Showing 1 changed file with 47 additions and 0 deletions.
47 changes: 47 additions & 0 deletions CONTRIBUTING.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
Contributing
------------

If you find errors, omissions, inconsistencies or other things that need
improvement, please create an issue or a pull request at
https://github.com/sfstoolbox/sfs-matlab/.
Contributions are always welcome!

Building the Documentation
^^^^^^^^^^^^^^^^^^^^^^^^^^

If you make changes to the documentation, you can re-create the HTML pages
using Sphinx_.
You can install it and a few other necessary packages with::

python3 -m pip install -r doc/requirements.txt --user

To create the HTML pages, use::

sphinx-build -b html -d ./_build/doctrees . ./_build/html-preview/

The generated files will be available in the directory
``build/sphinx/html-preview/``.

.. _Sphinx: http://sphinx-doc.org/

Creating a New Release
^^^^^^^^^^^^^^^^^^^^^^

New releases are made using the following steps:

#. Bump version number in ``SFS_version.m``
#. Update ``NEWS``
#. Commit those changes as "Release x.y.z"
#. Create an (annotated) tag with ``git tag -a x.y.z``
#. Check that all author details in ``.zenodo.json`` are correct
#. Push the commit and the tag to Github and `add release notes`_ containing a
link to the documentation with http://matlab.sfstoolbox.org/en/x.y.z and the
bullet points from ``NEWS``
#. Check that the new release was built correctly on RTD_, delete the "stable"
version and select the new release as default version
#. Check that the new release was registered at Zenodo_ and edit the release
notes on Github to include the DOI badge

.. _add release notes: https://github.com/sfstoolbox/sfs-matlab/tags
.. _RTD: http://readthedocs.org/projects/sfs-matlab/builds/
.. _Zenodo: https://zenodo.org/search?page=1&size=20&q=sound%20field%20synthesis%20toolbox&sort=bestmatch

0 comments on commit e53e231

Please sign in to comment.