Skip to content

Commit

Permalink
Create CONTRIBUTING.md (agstrike#1)
Browse files Browse the repository at this point in the history
  • Loading branch information
simhnna authored Nov 4, 2017
1 parent 2220807 commit bd1c74f
Showing 1 changed file with 53 additions and 0 deletions.
53 changes: 53 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
# Contributing to SilverStrike

Thanks for concidering to contribute! Even if not explicitly said, it's appreciated!

You can contribute in different ways. You can write code, file bugs and feature requests.
If you're more of a designer (I'm not) you are very welcome to help with layouts.

### Reporting Bugs

If you found a flaw, search for it in the open and closed issues. If you can't find anything proceed with opening an issue.

> **Note:** If you find a **Closed** issue that seems like it is the same thing that you're experiencing, open a new issue and include a link to the original issue in the body of your new one.
Explain the problem and include additional details to help reproduce the problem:

* **Use a clear and descriptive title** for the issue to identify the problem.
* **Describe the exact steps which reproduce the problem** in as many details as possible.
* **Describe the behavior you observed after following the steps** and point out what exactly is the problem with that behavior.
* **Explain which behavior you expected to see instead and why.**
* **Include screenshots** if you think they are helpful
* **If you're reporting that an unhandled exception**, include a stack trace. If it's rather small, include it in the issue itself. Otherwise please attach it as a file or paste the content to some pasting service like [dpaste](https://dpaste.de)
* **Can you reproduce the problem in the [demo](https://silverstrike.herokuapp.com)?**

### Feature Requests

I'm always looking for good features to add to SilverStrike. Before creating a new issue for it try searching the existing issues labled `feature-request`. If you found it, use the thumbs up and add comments if you want to detail something specific. Otherwise open a new issue.

* **Use a clear and descriptive title** for the issue to identify the suggestion.
* **Provide a step-by-step description of the suggested enhancement** in as many details as possible.
* **Explain why this enhancement would be useful**.

### Your First Code Contribution

Unsure where to begin contributing? I'll try to add issues with `beginner` and `help-wanted` labels.
They will most likely be easiest to fix if you're unfamiliar with Django or the code itself.

### Pull Requests

* Do not include issue numbers in the PR title
* Make sure the tests pass locally by running `tox`
* If travis shows errors, please fix them
* Please try to write tests to cover the code you introduce

### Git Commit Messages

* Use the present tense ("Add feature" not "Added feature")
* Use the imperative mood ("Move cursor to..." not "Moves cursor to...")
* Limit the first line to 72 characters or less
* Reference issues and pull requests after the first line
* If you think travis builds aren't needed include `[ci skip]` in the commit description


This page is heavily inspired by the [contribution guide](https://github.com/atom/atom/blob/master/CONTRIBUTING.md) of [atom](https://atom.io/)

0 comments on commit bd1c74f

Please sign in to comment.