From 79f5e956cab75537032d9001964f10dabf7cd137 Mon Sep 17 00:00:00 2001 From: Jeff Quast Date: Wed, 15 Apr 2015 14:30:11 -0700 Subject: Add docs/contributing.rst section --- CONTRIBUTING | 1 + docs/contributing.rst | 49 +++++++++++++++++++++++++++++++++++++++++++++++++ docs/index.rst | 1 + 3 files changed, 51 insertions(+) create mode 120000 CONTRIBUTING create mode 100644 docs/contributing.rst diff --git a/CONTRIBUTING b/CONTRIBUTING new file mode 120000 index 0000000..7c5f320 --- /dev/null +++ b/CONTRIBUTING @@ -0,0 +1 @@ +docs/contributing.rst \ No newline at end of file diff --git a/docs/contributing.rst b/docs/contributing.rst new file mode 100644 index 0000000..e02606f --- /dev/null +++ b/docs/contributing.rst @@ -0,0 +1,49 @@ +Contributing +============ + +Contributors should create a GitHub account if they do not have one. +If you are opposed to having a GitHub account, you may e-mail the +maintainers a patch, though it reduces the chance of being accepted). + +How to make a pull request +-------------------------- + +All aspects of using git and GitHub is well-documented by GitHub: + +- `Fork a Repo `_ +- `Creating a pull request + `_ + +Preparing a Developer Environment +--------------------------------- + +Install git, python2, python3, pip, then virtualenvwrapper:: + + pip install virtualenvwrapper + +Then, Load virtualenvwrapper and prepare a developer environment +for blessings. From the blessings code folder:: + + . `which virtualenvwrapper.sh` + mkvirtualenv blessings + pip install --editable . + +Running tests +------------- + +:: + tox + +Test Coverage +------------- + +Blessings has 99% code coverage. New features will not be accepted +without coverage. Bugfixes will not be accepted without a complimentary +test that demonstrates the bug. + +Style, static analysis +---------------------- + +The test runner (``tox``) ensures all code and documentation complies +with standard python style guides, pep8 and pep257, as well as various +static analysis tools. diff --git a/docs/index.rst b/docs/index.rst index 17e46ab..227eed5 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -14,6 +14,7 @@ Contents: further pains api + contributing history ======= -- cgit v1.2.1