Merge pull request #48 from git-em/ortografia-readme

Melhorar a formatação e correções ortográficas

Author: sergiocabral

README.asc

@@ -1,27 +1,27 @@
 = Pro Git, Segunda Edição, Português do Brasil
 
-Bem-vindo à segunda edição do livro Pro Git
+Bem-vindo à segunda edição do livro Pro Git.
 
 > Se você está procurando pela versão oficial, em Inglês, vá para o link https://github.com/progit/progit2[].
 
 Você pode achar esse livro online em: http://git-scm.com/book
 
-Como a primeira, a segunda edição do livro Pro Git é open source sob uma licença Creative Commons.
+Como a primeira edição, a segunda edição do livro Pro Git é open source sob uma licença Creative Commons.
 
-Algumas coisas mudaram desde quando a primeira edição foi disponibilizada de forma livre.
-Umas delas foi que mudamos o texto do livro de Markdown para o maravilhoso formato Asciidoc. Nós também passamos a usar a https://atlas.oreilly.com[Plataforma Atlas] da O'Reilly para a geração contínua dos livros, assim os formatos mais conhecidos estão sempre disponíves em todas os idiomas.
+Algumas coisas mudaram desde que a primeira edição foi disponibilizada de forma livre.
+Umas delas foi que mudamos o texto do livro de Markdown para o maravilhoso formato Asciidoc; confira aqui um https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/[guia rápido de AsciiDoc] (em inglês). Nós também passamos a usar a https://atlas.oreilly.com[Plataforma Atlas] da O'Reilly para a geração contínua dos livros. Assim os formatos mais conhecidos estão sempre disponíves em todos os idiomas.
 
 Nós também passamos a manter as traduções em repositórios separados em vez usar de subdiretórios do repositório original em inglês.
-Veja link:CONTRIBUTING.md[o documento para contribuições] para mais informações.
+Veja o link:CONTRIBUTING.md[documento para contribuições] para mais informações.
 
 == Contribuindo com a tradução
 
 Se você quiser contribuir para a tradução do livro Pro Git para o português brasileiro, é só seguir os seguintes passos:
 
-- Crie uma link:https://github.com/progit/progit2-pt-br/issues/new[issue] dizendo qual parte do livro deseja traduzir (isso evita que mais de uma pessoa comece a traduzir a mesma parte.)
-- Antes de começar a traduzir, é recomendado que você leia as partes do livro já traduzidas. Isso lhe dará uma ideia das convenções e escolhas de traduções sendo usadas.
+- Crie uma link:https://github.com/progit/progit2-pt-br/issues/new[issue] dizendo qual parte do livro deseja traduzir (isso evita que mais de uma pessoa comece a traduzir a mesma parte).
+- Antes de começar a traduzir, é recomendado que você leia as partes do livro já traduzidas. Isso lhe dará uma ideia das convenções de tradução sendo utilizadas.
 - Envie um link:https://github.com/progit/progit2-pt-br/pulls[pull request] com a sua contribuição. Possivelmente solicitaremos algumas alterações, visando corrigir problemas ou adequar suas escolhas de tradução ao estilo vigente no restante do livro. Você pode então fazer as alterações e enviar mais commits para seu branch.
-- Caso você seja iniciante em colaborar com projetos open-source no GitHub, leia o link:beginners-guide.asc[guia que preparamos] para você se familiarizar com o processo.
+- Caso você seja iniciante em colaborar com projetos open-source no GitHub, leia o link:beginners-guide.asc[guia que preparamos] para se familiarizar com o processo.
 
 == Como gerar o livro
 
@@ -54,46 +54,50 @@ Usamos os projetos `asciidoctor`, `asciidoctor-pdf` e `asciidoctor-epub`.
 
 === No MacOS
 
-Sugerido que utilize o http://brew.sh/[] para gerenciar as dependências de sistema (no caso, instalar o `ruby` e o `rubygems` mais recentes, para então instalar o `asciidoctor`).
+Sugerimos que utilize o http://brew.sh/[] para gerenciar as dependências de sistema (no caso, instalar o `ruby` e o `rubygems` mais recentes, para então instalar o `asciidoctor`).
 
----
-# install updated version of ruby
+==== Instalar versão atualizado do ruby
+
+----
 $ ruby -v
 $ brew install ruby
 $ source ~/.bashrc # or source ~/.zshrc
 $ ruby -v
+----
 
-# update system rubygems
+==== Atualizar rubygems do sistema
+----
 $ gem update --system
+----
 
-# config nokogiri to build using system libraries
+==== Configurar nokogiri para o build usando libraries do sistema
+----
 $ bundle config build.nokogiri --use-system-libraries
----
-
-Depois disso tudo, é só gerar os livros
+----
 
----
+==== Depois disso tudo, é só gerar os livros:
+----
 $ bundle exec rake book:build
----
+----
 
 === Via Docker
 
-Você não precisa instalar todas as dependências do Asciidoctor em seu sistema: usando Docker, com apenas um comando o livro é gerado por meio de um container efêmero. Esse só vai existir durante a geração do livro e depois some do sistema. O comando é esse aqui:
+Você não precisa instalar todas as dependências do Asciidoctor em seu sistema. Usando o Docker, o livro pode ser gerado com apenas um comando, através de um container efêmero. Esse container só existirá durante a geração do livro e depois desaparecerá do sistema.
+
+Para tanto, execute o seguinte código no seu terminal:
 
 ----
 $ docker run -it --rm \
     -v `pwd`:/documents/ \
     rogeriopradoj/progit2
 ----
 
-Copie todas as linhas e cole de uma vez no seu terminal. Pronto!
-
 == Indicação de problemas
 
-Antes de abrir uma issue indicando um problema, por favor verifique se já não existe alguma parecida aberta no sistema de [rastreio de bugs](https://github.com/progit/progit2/issues) do repositório original em inglês.
+Se possível, antes de abrir uma issue indicando um problema, verifique se já não há alguma issue semelhante aberta, utilizando o sistema de https://github.com/progit/progit2/issues[rastreio de bugs do repositório original] (em inglês).
 
-Além disso, se esse problema foi apontado no site git-scm.com, verifique também se ele não está presente aqui neste reposítorio.
-O problema pode ser sido resolvido, mas as mudanças ainda não terem sido implantadas e publicadas (deploy).
+Além disso, se o problema já tiver sido apontado no site https://git-scm.com, verifique se ele não está presente neste repositório.
+O problema pode ser sido resolvido, mas as mudanças ainda não terem sido implantadas e publicadas.
 
 == Contribuição