Better contribution patches / branches documentation

[Christopher Allan Webber]

We haven't explained now what kind of patches we want or how to
push a branch for us to merge in the docs. Well, at least we
haven't explained the patch part well. We should basically give an
example tutorial session on how to submit a proper patch.

[Christopher Allan Webber]

We could use descriptions of how to use feature branches in the
documentation code soonish. It'll make collaboration a lot easier
to pin that down and have something to point to.

[Will Kahn-Greene]

With Chris' help, I overhauled the chapter on contributing changes.
It should theoretically be clearer and it also has an example
workflow that covers the whole process.

Changes made in:

fb69241 Tweaks git workflow structure
909c639 Fixes git workflow

I'm going to keep this open for comments until we're satisfied.

[Christopher Allan Webber]

I made a slight change and switched "Push your branch" to "Push
your feature/bugfix/issue branch". I know it's already said, just
that if someone's skimming over to the "preferred methods" of
contribution section I'd like that to be clear-ish, or maybe
noticable enough that they'll look for clarity elsewhere in the
doc.

[Will Kahn-Greene]

I pushed some additional tweaks in b2cea31. This includes some
explanation of flags being used, fixes a typo, tweaks the
format-patch command line, and some other minor things.

[Christopher Allan Webber]

There's one more thing I'd like to see in here, and that's that
feature branches have useful names.

I pushed a change that I think handles this better. A few people
have been doing this anyway, and when we do things this way, I find
it really helps.

"issue\_42" -> "bug42\_meaning\_of\_life"

I know that adds a lot of verbosity but it really, really helps
me.

Will, if you object to this or think we can make this better
(remove the "bug" part?) let me know.

[Will Kahn-Greene]

I don't object. Chris made some changes already and I tweaked the
"put your bugfixes in their own branch" text to also talk about
naming the branch in 0a80ad4.

I'm going to mark this as Closed.

[Will Kahn-Greene]

The original url for this bug was ​http://bugs.foocorp.net/issues/333 .