Update documentation/quickstart pages (pt)

Author: alanwillms

pt/documentation/quickstart/2/index.md

@@ -17,7 +17,7 @@ header: |
 
 ---
 
-E se quisermos dizer “Olá” varias vezes sem cansar os dedos? Temos que
+E se quisermos dizer “Olá” várias vezes sem cansar os dedos? Temos que
 definir um método!
 
 {% highlight irb %}
@@ -27,16 +27,17 @@ irb(main):012:1> end
 => nil
 {% endhighlight %}
 
-O código `def h` começa a definição do método. Diz ao Ruby que estamos a
-definir um método, cujo nome é `h`. A linha seguinte é o corpo do
-método, a mesma frase que vimos antes: `puts "Olá Mundo"`. Finalmente, a
-última linha `end` diz ao Ruby que terminámos a definição do método. A
-resposta do Ruby `=> nil` diz-nos que sabe que terminamos a definição do
-método.
+O código `def h` começa a definição do método. Diz ao Ruby que estamos
+definindo um método, cujo nome é `h`. A linha seguinte é o corpo do
+método, a mesma linha que vimos antes: `puts "Olá Mundo"`. Finalmente, a
+última linha `end` diz ao Ruby que terminámos a definição do método.
+A reposta do Ruby `=> :h` nos diz que ele sabe que estamos definindo um
+método. Essa resposta poderia ser `=> nil` no Ruby 2.0 e versões anteriores.
+Mas isso não é importante agora, vamos seguir em frente.
 
 ## As Breves e Repetitivas Vidas de um Método
 
-Agora tentemos correr o método algumas vezes:
+Agora vamos tentar rodar o método algumas vezes:
 
 {% highlight irb %}
 irb(main):013:0> h
@@ -47,31 +48,31 @@ Olá Mundo!
 => nil
 {% endhighlight %}
 
-Bem, esta foi fácil. Chamar um método em Ruby é tão fácil como mencionar
-o seu nome ao Ruby. Se o método não tiver parâmetros é tudo o que
-precisamos. Podemos também colocar os parênteses vazios se desejar-mos,
-porem estes não são necessários.
+Bem, isso foi fácil. Chamar um método em Ruby é tão fácil como mencionar
+o seu nome ao Ruby. Se o método não tiver parâmetros isso é tudo de que
+precisamos. Podemos também colocar os parênteses vazios se desejarmos,
+porém eles não são necessários.
 
-E se o que queremos é dizer ola a uma pessoa só, e não ao mundo inteiro?
+E se o que queremos é dizer olá a uma pessoa só, e não ao mundo inteiro?
 Para isso basta redifinir `h` para que aceite um nome como parâmetro.
 
 {% highlight irb %}
 irb(main):015:0> def h(nome)
 irb(main):016:1> puts "Olá #{nome}!"
 irb(main):017:1> end
-=> nil
+=> :h
 irb(main):018:0> h("Matz")
-Olá Matz!
+Ola Matz!
 => nil
 {% endhighlight %}
 
-Parece funcionar… mas vamos pausar um minuto para ver o que se passa
+Parece funcionar… mas vamos parar um minuto para ver o que se passa
 aqui.
 
-## Reservando espaços numa String
+## Reservando Espaços numa String
 
-O que significa a expressão @#\{nome}? É a forma de inserir alguma coisa
-numa string. Aquilo que se encontra entre chavetas transforma-se numa
+O que significa a expressão `#{name}`? É a forma de inserir alguma coisa
+numa string. Aquilo que se encontra entre chaves transforma-se numa
 string (se já não o for) e é substituído naquele ponto da string.
 Podemos também usar isto para ter a certeza de que o nome de alguém se
 apresenta em letra maiúscula:
@@ -80,7 +81,7 @@ apresenta em letra maiúscula:
 irb(main):019:0> def h(nome = "Mundo")
 irb(main):020:1> puts "Olá #{nome.capitalize}!"
 irb(main):021:1> end
-=> nil
+=> :h
 irb(main):022:0> h "chris"
 Olá Chris!
 => nil
@@ -89,19 +90,18 @@ Olá Mundo!
 => nil
 {% endhighlight %}
 
-Podemos encontrar aqui um truque ou dois. Um deles é que estamos a
-chamar novamente o método sem recorrer aos parênteses. Se aquilo que
-estamos a fazer for óbvio então os parênteses são opcionais. O outro
+Podemos encontrar aqui um truque ou dois. Um deles é que estamos
+chamando novamente o método sem recorrer aos parênteses. Se aquilo que
+estamos fazendo for óbvio então os parênteses são opcionais. O outro
 truque é o parâmetro `Mundo` usado por omissão. O que isto quer dizer é
-que “Se o nome não for fornecido, então usamos o nome por omissão
+que “Se o nome não for fornecido, então usamos o nome padrão
 `"Mundo"`.
 
 ## Evoluindo para um Anfitrião
 
-E se quisermos criar um Anfitrião mais “sério”? Um que se lembre do
-nosso nome, nos dê as boas vindas e nos trate com o respeio devido?
-Podemos usar um objecto para esse efeito. Vamos então criar, a classe
-“Anfitrião”.
+E se quisermos criar um verdadeiro anfitrião, um que se lembre do
+nosso nome, nos dê as boas vindas e nos trate com o devido respeito?
+Podemos usar um objeto para isso. Então vamos criar a classe “Anfitrião”.
 
 {% highlight irb %}
 irb(main):024:0> class Anfitriao
@@ -118,12 +118,11 @@ irb(main):034:1> end
 => nil
 {% endhighlight %}
 
-A nova palavra chave aqui é `class`. Esta define uma nova classe chamada
-Anfitrião e uma quantidade de métodos para essa classe. E o `@nome` ? É
+A nova palavra-chave aqui é `class`. Ela define uma nova classe chamada
+Anfitrião e alguns métodos para essa classe. E o `@nome` ? É
 uma variável de instância e está disponível para todos os métodos da
-classe. Como podemos ver está a ser utilizada por `diz_ola` e
-`diz_adeus`.
+classe. Como podemos ver, ela é utilizada por `diz_ola` e `diz_adeus`.
 
-Então como é que pomos a classe Anfitrião em movimento? [Criamos um
-objecto.](../3/)
+Então como é que fazemos a classe Anfitrião funcionar? [Criamos um
+objeto.](../3/)
 

pt/documentation/quickstart/3/index.md

@@ -17,40 +17,40 @@ header: |
 
 ---
 
-Agora vamos criar e usar um objecto Anfitrião:
+Agora vamos criar e usar um objeto Anfitrião:
 
 {% highlight irb %}
-irb(main):035:0> h = Anfitriao.new("João")
+irb(main):035:0> g = Anfitriao.new("João")
 => #<Anfitriao:0x16cac @nome="João">
-irb(main):036:0> h.diz_ola
+irb(main):036:0> g.diz_ola
 Ola João
 => nil
-irb(main):037:0> h.diz_adeus
-Adeus João, volta em breve.
+irb(main):037:0> g.diz_adeus
+Adeus João, volte em breve.
 => nil
 {% endhighlight %}
 
-Uma vez criado o objecto `h`, lembra-nos que o nome é João. Mmm, e se
-quisermos aceder directamente ao nome?
+Uma vez criado o objeto `g`, ele se lembra de que o nome é João. Mmm, e se
+quisermos acessar diretamente o nome?
 
-{% highlight irb %}
-irb(main):038:0> h.@nome
+{% highlight ruby %}
+irb(main):038:0> g.@nome
 SyntaxError: compile error
 (irb):52: syntax error
         from (irb):52
 {% endhighlight %}
 
-Não o podemos fazer.
+Nope, não conseguimos.
 
-## Por baixo da pele do objecto
+## Objeto por Baixo da Pele
 
-As variáveis de instância escondem-se dentro do objecto. Não estão assim
-tão bem escondidas, podem ser vistas quando se inspecciona o objecto e
-há outras formas de lhes aceder, mas Ruby é fiel aos bons costumes da
-programação orientada a objectos mantendo os dados o mais privados
+As variáveis de instância escondem-se dentro do objeto. Não estão assim
+tão bem escondidas, podem ser vistas quando se inspeciona o objeto e
+há outras formas de lhes acessar, mas o Ruby é fiel aos bons costumes da
+programação orientada a objetos mantendo os dados o mais privados
 possíveis.
 
-Então, que métodos estão disponíveis para os objectos Anfitrião?
+Então, que métodos estão disponíveis para os objetos Anfitrião?
 
 {% highlight irb %}
 irb(main):039:0> Anfitriao.instance_methods
@@ -66,10 +66,10 @@ irb(main):039:0> Anfitriao.instance_methods
     "instance_variables", "instance_of?"]
 {% endhighlight %}
 
-Bem. São muitos métodos. Nós só definimos dois métodos. O que é que
-aconteceu? Bem estes são **todos** os métodos para os objectos
+Uau. São muitos métodos. Nós só definimos dois métodos. O que é que
+aconteceu? Bem, estes são **todos** os métodos para os objetos
 Anfitrião, uma lista completa, incluindo os que estão definidos nas
-super-classes de Anfitrião. Se só quisermos listar unicamente os métodos
+super-classes de Anfitrião. Se só quisermos listar os métodos
 definidos para a classe Anfitrião, podemos pedir-lhe que não inclua os
 métodos dos seus ancestrais passando-lhe o parâmetro `false`, que
 significa que não queremos os métodos definidos pelos seus ancestrais.
@@ -80,26 +80,26 @@ irb(main):040:0> Anfitriao.instance_methods(false)
 {% endhighlight %}
 
 Há mais coisas a explorar. Vejamos a que métodos pode responder o nosso
-objecto Anfitrião:
+objeto Anfitrião:
 
 {% highlight irb %}
 irb(main):041:0> h.respond_to?("nome")
 => false
-irb(main):042:0> h.respond_to?("dirzer_ola")
+irb(main):042:0> h.respond_to?("diz_ola")
 => true
 irb(main):043:0> h.respond_to?("to_s")
 => true
 {% endhighlight %}
 
-Assim ficamos a saber que responde a `diz_ola`, e `to_s` (que
-significa “converter algo numa string”, um método que está definido por
-omissão para todos os objectos), mas que não reconhece `nome` como
+Assim sabemos que responde a `diz_ola`, e `to_s` (que
+significa “converter algo em uma string”, um método que está definido por
+padrão para todos os objetos), mas que não reconhece `nome` como
 método.
 
-## Modificar classes—Nunca é demasiado tarde
+## Modificando Classes – Nunca é Tarde Demais
 
-E se quiser alterar o nome? Ruby oferece uma forma fácil de lhe permitir
-o acesso às variáveis de um objecto.
+E se quisermos ver ou alterar o nome? Ruby oferece uma forma fácil
+de fornecer acesso às variáveis de um objeto.
 
 {% highlight irb %}
 irb(main):044:0> class Anfitriao
@@ -108,47 +108,45 @@ irb(main):046:1> end
 => nil
 {% endhighlight %}
 
-Em Ruby, podemos voltar a abrir e alterar uma classe. Isso não altera os
-objectos já existentes, mas afecta os novos objectos que se possam
-criar. Assim vamos criar um novo objecto e vamos brincar com a sua
+Em Ruby, podemos abrir uma classe novamente e alterá-la. As mudanças estarão
+presentes em quaisquer objetos criados e até mesmo nos objetos existentes
+dessa classe. Então vamos criar um novo objeto e vamos brincar com a sua
 propriedade `@nome`.
 
-{% highlight irb %}
-irb(main):047:0> h = Anfitriao.new("Pedro")
+{% highlight ruby %}
+irb(main):047:0> g = Anfitriao.new("Pedro")
 => #<Anfitriao:0x3c9b0 @nome="Pedro">
-irb(main):048:0> h.respond_to?("nome")
+irb(main):048:0> g.respond_to?("nome")
 => true
-irb(main):049:0> h.respond_to?("nome=")
+irb(main):049:0> g.respond_to?("nome=")
 => true
-irb(main):050:0> h.diz_ola
+irb(main):050:0> g.diz_ola
 Ola Pedro
 => nil
-irb(main):051:0> h.nome="Matilde"
+irb(main):051:0> g.nome="Matilde"
 => "Matilde"
-irb(main):052:0> h
+irb(main):052:0> g
 => #<Anfitrion:0x3c9b0 @nome="Matilde">
-irb(main):053:0> h.nome
+irb(main):053:0> g.nome
 => "Matilde"
-irb(main):054:0> h.diz_ola
+irb(main):054:0> g.diz_ola
 Ola Matilde
 => nil
 {% endhighlight %}
 
-O uso de `attr_accessor` determina que se tenha definido dois novos
-métodos: `nome` para obter o valor, e `nome=` para o alterar.
+O uso de `attr_accessor` definiu dois novos métodos para nós:
+`nome` para obter o valor e `nome=` para alterá-lo.
 
-## Saudar todos, MegaAnfitriao não nega a saudação a ninguém!
+## Saudando a Tudo e a Todos, MegaAnfitriao não Esquece Ninguém!
 
-De qualquer modo este Anfitrião não é assim tão interessante, só pode
-trabalhar para uma pessoa de cada vez. O que se passaria se tivéssemos
-uma classe MegaAnfitriao que pudesse saudar o mundo inteiro, uma pessoa
-ou uma lista completa de pessoas?
+De qualquer modo este Anfitrião não é assim tão interessante, ele só consegue
+trabalhar com uma pessoa de cada vez. E se tivéssemos uma classe MegaAnfitriao
+que pudesse saudar o mundo inteiro, uma pessoa ou uma lista inteira de pessoas?
 
-Vamos escrever isto num ficheiro em vez de usar directamente o
-interpretador interactivo do Ruby (IRB).
+Vamos escrever isto num arquivo em vez de usar diretamente o interpretador
+interativo do Ruby (IRB).
 
-Para sair do IRB, escrevemos “quit”, “exit” ou simplesmente carregamos
-nas teclas “Control” e “D”.
+Para sair do IRB, digite “quit”, “exit” ou simplesmente pressione “Control+D”.
 
 {% highlight ruby %}
 #!/usr/bin/env ruby
@@ -215,7 +213,7 @@ if __FILE__ == $0
 end
 {% endhighlight %}
 
-Guardar este ficheiro como “ri20min.rb”, e executar com o comando “ruby
+Salve este arquivo como “ri20min.rb”, e execute-o com o comando “ruby
 ri20min.rb”. O resultado deverá ser:
 
     Ola Mundo
@@ -233,6 +231,6 @@ ri20min.rb”. O resultado deverá ser:
     ...
 {: .code}
 
-Há uma série de coisas novas neste novo exemplo às quais podemos [dar
-uma observação mais profunda](../4/)
+Há uma série de coisas novas neste exemplo às quais podemos
+[observar mais profundamente](../4/)