django-oidc-provider/docs/sections/contribute.rst

38 lines
1.3 KiB
ReStructuredText
Raw Normal View History

2016-02-11 20:24:34 +00:00
.. _contribute:
Contribute
##########
We love contributions, so please feel free to fix bugs, improve things, provide documentation. You SHOULD follow this steps:
* Fork the project.
* Make your feature addition or bug fix.
2016-07-28 20:18:11 +00:00
* Add tests for it inside ``oidc_provider/tests``. Then run all and ensure everything is OK (read docs for how to test in all envs).
2016-02-11 20:24:34 +00:00
* Send pull request to the specific version branch.
Running Tests
=============
Use `tox <https://pypi.python.org/pypi/tox>`_ for running tests in each of the environments, also to run coverage among::
2016-07-28 20:18:11 +00:00
# Run all tests.
2016-02-11 20:24:34 +00:00
$ tox
2016-08-11 19:43:30 +00:00
# Run with Python 2.7 and Django 1.9.
$ tox -e py27-django19
2016-07-28 20:18:11 +00:00
2016-08-17 14:35:01 +00:00
# Run single test file.
$ python runtests.py oidc_provider.tests.test_authorize_endpoint
2016-02-11 20:24:34 +00:00
Also tests run on every commit to the project, we use `travis <https://travis-ci.org/juanifioren/django-oidc-provider/>`_ for this.
2016-04-25 20:33:52 +00:00
Improve Documentation
=====================
We use `Sphinx <http://www.sphinx-doc.org/>`_ for generate this documentation. I you want to add or modify something just:
* Install Sphinx ``pip install sphinx`` and this theme ``pip install sphinx-rtd-theme``.
* Move inside the docs folder. ``cd docs/``
* Generate the HTML. ``make html``
* Open ``docs/_build/html/index.html`` on a browser.