rogerdudler/git-guide — pull request #40 by chesterbr (2012-09-14 04:57:54+00:00)
Title: Using more common terminology

First of all, congratulations for this great guide! It handles gracefully some of the hardest parts of git for beginners.

As a Brazilian, I must add that the pt-br translation is also very good (and important due to the widespread number of developers that don't read English), but I believe it could be improved by using the original terms for commits, branches and merges instead of their translations (confirmação, ramos and mesclas).

I know it's supposed to be targeted at non-English speakers, but the original terms are so commonplace that typical developers even use them as if they were Portuguese words (e.g., "mergear" as if "merge" was a Portuguese verb and we would conjugate it), so it would be in those developers' best interest to present them the commonly-used vocabulary upfront.

I've tried to have the translations displayed on the first occurrences of each English term, and also kept the translated terms on titles, so people can easily incorporate the vocabulary on their daily usage.

Just a suggestion, of course, but one that I believe would make this great "hello, git"-style guide even better.

Obrigado! (Thank you!)