Skip to content

Latest commit

 

History

History
100 lines (73 loc) · 2.93 KB

contribute.md

File metadata and controls

100 lines (73 loc) · 2.93 KB
Raw

How to contribute

I simply cannot access the huge number of platforms and configurations to run this project on. I want to keep it as easy as possible to contribute changes that get things working in your environment. There are a few guidelines that I need contributors to follow so that I can have a chance of keeping on top of things.

I use Waffle.io to better manage issues. This links in with github issues.

Getting Started

  • Make sure you have a GitHub account
  • Submit a ticket for your issue, assuming one does not already exist.
    • Clearly describe the issue including steps to reproduce when it is a bug.
    • Make sure you fill in the earliest version that you know has the issue.
  • Fork the repository on GitHub

##Types of Contributions

###Report Bugs

Report bugs at https://github.com/thatarchguy/ManaGRR/issues.

If you are reporting a bug, please include:

  • Your operating system name and version.
  • Any details about your local setup that might be helpful in troubleshooting.
  • Detailed steps to reproduce the bug.

###Fix Bugs

Look through the GitHub issues for bugs. Anything tagged with "bug" is open to whoever wants to implement it.

###Implement Features

Look through the GitHub issues for features. Anything tagged with "feature" is open to whoever wants to implement it.

###Write Documentation

ManaGRR could always use more documentation.

###Submit Feedback

The best way to send feedback is to file an issue at https://github.com/thatarchguy/ManaGRR/issues.

If you are proposing a feature:

  • Explain in detail how it would work.
  • Keep the scope as narrow as possible, to make it easier to implement.

##Setting up

Setup for Local Development

  1. Fork the ManaGRR repo on GitHub.
  2. Clone your fork locally::
    $ git clone git@github.com:thatarchguy/ManaGRR.git
  1. Install your local copy into a virtualenv. Assuming you have virtualenvwrapper installed, this is how you set up your fork for local development::
    $ virtualenv -p /usr/bin/python2.7 env
    $ . env/bin/activate 
    $ pip install -r requirements.txt
    $ python manage.py test
  1. Create a branch off of dev for local development::
    $ git checkout -b name-of-your-bugfix-or-feature

Now you can make your changes locally.

  1. When you're done making changes, check that your changes pass flake8 and the tests:
    $ python manage.py lint
    $ python manage.py test
  1. Commit your changes and push your branch to GitHub::
    $ git add .
    $ git commit -m "Your detailed description of your changes."
    $ git push origin name-of-your-bugfix-or-feature

  1. Submit a pull request through the GitHub website.

  2. 99 times out of 100...do not commit to Master. All merges/commits to Master must be GPG signed and signed off by an admin

    $ git merge -S --no-ff dev

or for a quick commit

    $ git commit -s -S -m "edited Makefile"