Skip to content

Commit

Permalink
Added contributors info
Browse files Browse the repository at this point in the history
  • Loading branch information
adamgit authored and adamgit committed Dec 22, 2013
1 parent 99e3841 commit e93b95d
Showing 1 changed file with 35 additions and 0 deletions.
35 changes: 35 additions & 0 deletions CONTRIBUTING.md
@@ -0,0 +1,35 @@
# Important info, please read

## Everyone here is another developer

...there's no support team. When you create an Issue, it will be seen by the other users of SVGKit. If someone answers, it's because they're a fellow user and they're trying to help.

Some of them are kind enough to fix things for other developers - but please note they're doing it out of generosity!

## A short (3 sentence) Issue is often the best

The Issues that get fastest response / resolved best are often the shortest - but not TOO short.

Adam <a href="http://t-machine.org/index.php/2013/12/22/reporting-issues-in-open-source-software/">wrote an ultra short guide: How to write a good Issue</a> - it's worth a quick read!

## Pull Requests

We love Pull Requests. Most get accepted within hours.

But there's a couple of hard and fast rules, to protect all of us:

1. A Pull Request MUST be a small, self-contained feature or fix, or a couple of fixes at most. It could stretch over many files, but usually it will be 2-5 files at most.
1. ...because: a Maintainer will *manually check every line of code* in the Pull Request, and make sure it doesn't break anything else
1. If your code breaks other stuff, we'll tell you why and help you to fix it
1. EVERY PULL REQUEST should be first tested using the "Demo-iOS" app (or "Demo-OSX" app) to make sure it works with all our current SVG files
1. If you're fixing a bug, PLEASE CREATE A SIMPLE SVG FILE THAT DEMONSTRATES THE BUG, and then a Maintainer can add it to the Demo app, and use it to "prove" that your fix works. (or you can add it yourself directly, as part of your commit)
1. When you send a Pull Request, you warrant that it's your own code, or that you have permission to donate it to the project (this should be obvious! It's open-source!)

# Coding Style

We have very few rules for coding style. But there are a couple of things that affect other programmers:

1. Don't convert the project to ARC - there are forks for that, if you really want it. We're planning promoting them to default in the future
1. Don't reformat existing code unless it's VERY badly formatted - it makes it TEN TIMES HARDER for us to check your changes (it will mess up all the diff's)
1. Don't use autoboxing ( the "@()/@[]/@{}" syntax ) - some devs are still using old versions of Xcode
1. With @property, add an explicity @synthesize for each new property - again: some devs have old versions of Xcode

0 comments on commit e93b95d

Please sign in to comment.