Translation and figure notes -> contributing.md

Author: ben

CONTRIBUTING.md

@@ -3,7 +3,7 @@
 
 ## Licensing
 
-By opening a pull request to this repository, you agree to provide your work under the [project license](LICENSE.asc). 
+By opening a pull request to this repository, you agree to provide your work under the [project license](LICENSE.asc).
 
 ## Small Corrections
 
@@ -15,6 +15,21 @@ If you've never done this before, the [flow guide](https://guides.github.com/int
 
 Open an issue for discussion before you start. These changes tend to be very subjective, often only clarifying things for some small percentage of people and it's rarely worth the time to accept them. Professional copy editors have already reviewed this content multiple times so while you may have somewhat better taste and grammar than we do it's unlikely that your prose is going to be *so* much better that it's worth changing vast swaths of text.
 
-## Translate
+## Figures
 
-If you're interested in translating Pro Git into another language, [read the translation guide](TRANSLATION_NOTES.asc).
+The images in this book were generated using [Sketch 3](http://bohemiancoding.com/sketch/), with the [included sketchbook file](diagram-source/progit.sketch).
+
+To add a figure:
+
+1. Add a page to the sketchbook. Try to use the included symbols wherever possible.
+1. Add a "slice" to your page. Give it a name that matches the destination PNG filename, relative from the root of the source directory.
+1. Make sure your slice is set to export at 3x size.
+
+
+## Translations
+
+Translations to other languages are highly encouraged but handled a little differently than the first edition. We now keep each translation in a separate repository and automatically build the output files through Atlas. This was something that was really difficult in the last edition.
+
+Since each translation is a different repository, we can also have different maintainers for each project. The Pro Git team simply pulls them in and builds them for the translation teams. To get automatic builds, translations repositories will have to be under the [`progit` organization on GitHub](https://github.com/progit).
+
+You can find out information on all the current translations and information on how to start your own at http://progit.org/translations.

README.asc

@@ -10,10 +10,6 @@ A couple of things have changed since open sourcing the first edition. For one,
 
 We've also moved to keeping the translations in separate repositories rather than subdirectories of the English repository. See the Translations section for more information.
 
-== Contributing
-
-If you'd like to help out, take a look at the [contributor's guide](CONTRIBUTING.md).
-
 == How To Generate the Book
 
 There are two ways to generate e-book content from this source code.
@@ -39,20 +35,6 @@ Converting to PDF...
 
 This uses the `asciidoctor`, `asciidoctor-pdf` and `asciidoctor-epub` projects.
 
-== Translations
-
-Translations to other languages are highly encouraged but handled a little differently than the first edition. We now keep each translation in a separate repository and automatically build the output files through Atlas. This was something that was really difficult in the last edition.
-
-Since each translation is a different repository, we can also have different maintainers for each project. The Pro Git team simply pulls them in and builds them for the translation teams. To get automatic builds, translations repositories will have to be under the https://github.com/progit[progit organization on GitHub].
-
-You can find out information on all the current translations and information on how to start your own at: http://progit.org/translations[].
-
-== Figures
-
-The images in this book were generated using http://bohemiancoding.com/sketch/[Sketch 3], with the link:diagram-source/progit.sketch[included sketchbook file].
-
-To add a figure:
+== Contributing
 
-. Add a page to the sketchbook. Try to use the included symbols wherever possible.
-. Add a ``slice'' to your page. Give it a name that matches the destination PNG filename, relative from the root of the source directory.
-. Make sure your slice is set to export at 3x size.
+If you'd like to help out by making a change or contributing a translation, take a look at the [contributor's guide](CONTRIBUTING.md).