Merge pull request #94 from schacon/trans-help

instructions for translating the work

Author: schacon

README.asc

@@ -47,9 +47,9 @@ This uses the `asciidoctor`, `asciidoctor-pdf` and `asciidoctor-epub` projects.
 
 Translations to other languages are highly encouraged but handled a little differently than the first edition. We now keep each translation in a seperate 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 an builds them for the translation teams. Most translations repositories will be under the https://github.com/progit[progit organization on GitHub], but some may be maintained as forks.
+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/trans[].
+You can find out information on all the current translations and information on how to start your own at: http://progit.org/translations[].
 
 == Figures
 

TRANSLATION_NOTES.asc

@@ -0,0 +1,9 @@
+== Translation Notes
+
+After forking this repository to translate the work, this file is where the notes for coordinating the translation work would go. Things like standardizing on words and expressions so that the work is consistent or notes on how the contributing process is to be handled.
+
+As a translation maintainer, also feel free to modify or completely rewrite the README file to contain instructions specific to your translation.
+
+=== Translation Status
+
+As the work is translated, please update the `status.json` file to indicate the rough percentage complete each file is. This will be shown on various pages to let people know how much work is left to be done.

status.json

@@ -0,0 +1,129 @@
+{
+  "code": "en",
+  "language": "English",
+  "maintainers": ["schacon"],
+  "files": {
+    "01-introduction": {
+      "1-introduction.asc": 0,
+      "sections/about-version-control.asc": 0,
+      "sections/basics.asc": 0,
+      "sections/command-line.asc": 0,
+      "sections/first-time-setup.asc": 0,
+      "sections/help.asc": 0,
+      "sections/history.asc": 0,
+      "sections/installing.asc": 0
+    },
+    "02-git-basics": {
+      "1-git-basics.asc": 0,
+      "sections/aliases.asc": 0,
+      "sections/getting-a-repository.asc": 0,
+      "sections/recording-changes.asc": 0,
+      "sections/remotes.asc": 0,
+      "sections/tagging.asc": 0,
+      "sections/undoing.asc": 0,
+      "sections/viewing-history.asc": 0
+    },
+    "03-git-branching": {
+      "1-git-branching.asc": 0,
+      "sections/basic-branching-and-merging.asc": 0,
+      "sections/branch-management.asc": 0,
+      "sections/nutshell.asc": 0,
+      "sections/rebasing.asc": 0,
+      "sections/remote-branches.asc": 0,
+      "sections/workflows.asc": 0
+    },
+    "04-git-server": {
+      "1-git-server.asc": 0,
+      "sections/generating-ssh-key.asc": 0,
+      "sections/git-daemon.asc": 0,
+      "sections/git-on-a-server.asc": 0,
+      "sections/gitlab.asc": 0,
+      "sections/gitweb.asc": 0,
+      "sections/hosted.asc": 0,
+      "sections/protocols.asc": 0,
+      "sections/setting-up-server.asc": 0,
+      "sections/smart-http.asc": 0
+    },
+    "05-distributed-git": {
+      "1-distributed-git.asc": 0,
+      "sections/contributing.asc": 0,
+      "sections/distributed-workflows.asc": 0,
+      "sections/maintaining.asc": 0
+    },
+    "06-github": {
+      "1-github.asc": 0,
+      "sections/1-setting-up-account.asc": 0,
+      "sections/2-contributing.asc": 0,
+      "sections/3-maintaining.asc": 0,
+      "sections/4-managing-organization.asc": 0,
+      "sections/5-scripting.asc": 0
+    },
+    "07-git-tools": {
+      "1-git-tools.asc": 0,
+      "sections/advanced-merging.asc": 0,
+      "sections/bundling.asc": 0,
+      "sections/credentials.asc": 0,
+      "sections/debugging.asc": 0,
+      "sections/interactive-staging.asc": 0,
+      "sections/notes.asc": 0,
+      "sections/replace.asc": 0,
+      "sections/rerere.asc": 0,
+      "sections/reset.asc": 0,
+      "sections/revision-selection.asc": 0,
+      "sections/rewriting-history.asc": 0,
+      "sections/searching.asc": 0,
+      "sections/signing.asc": 0,
+      "sections/stashing-cleaning.asc": 0,
+      "sections/submodules.asc": 0,
+      "sections/subtree-merges.asc": 0
+    },
+    "08-customizing-git": {
+      "1-customizing-git.asc": 0,
+      "sections/attributes.asc": 0,
+      "sections/config.asc": 0,
+      "sections/hooks.asc": 0,
+      "sections/policy.asc": 0
+    },
+    "09-git-and-other-scms": {
+      "1-git-and-other-scms.asc": 0,
+      "sections/client-hg.asc": 0,
+      "sections/client-p4.asc": 0,
+      "sections/client-svn.asc": 0,
+      "sections/client-tfs.asc": 0,
+      "sections/import-custom.asc": 0,
+      "sections/import-hg.asc": 0,
+      "sections/import-p4.asc": 0,
+      "sections/import-svn.asc": 0,
+      "sections/import-tfs.asc": 0
+    },
+    "10-git-internals": {
+      "1-git-internals.asc": 0,
+      "sections/environment.asc": 0,
+      "sections/maintenance.asc": 0,
+      "sections/objects.asc": 0,
+      "sections/packfiles.asc": 0,
+      "sections/plumbing-porcelain.asc": 0,
+      "sections/refs.asc": 0,
+      "sections/refspec.asc": 0,
+      "sections/transfer-protocols.asc": 0
+    },
+    "A-git-in-other-environments": {
+      "1-git-other-environments.asc": 0,
+      "sections/bash.asc": 0,
+      "sections/eclipse.asc": 0,
+      "sections/guis.asc": 0,
+      "sections/powershell.asc": 0,
+      "sections/visualstudio.asc": 0,
+      "sections/zsh.asc": 0
+    },
+    "B-embedding-git": {
+      "1-embedding-git.asc": 0,
+      "sections/command-line.asc": 0,
+      "sections/jgit.asc": 0,
+      "sections/libgit2.asc": 0
+    },
+    "C-git-commands": {
+      "1-git-commands.asc": 0
+    }
+  }
+}