Revisão seção de Ruby

Author: karynemayer

ruby/booleanos.md

@@ -14,6 +14,8 @@ evento_feio = false
 
 ‘**False**’ é falso em inglês.
 
+**Obs**: Um aspecto importante sobre o nome que damos às variáveis: elas não devem conter espaços, como podemos ver nas variáveis criadas aqui o espaço foi substituído por *underline* (\_).
+
 ```ruby
 (irb)> true != false
 # true

ruby/comentarios.md

@@ -2,7 +2,7 @@
 
 Antes de prosseguirmos, só um comentáriozinho ;)
 
-Comentários são partes do código que não serão executados, podem ser usados para lembrar de algo naquela parte do código, por exemplo. São muito bons quando estamos aprendendo, pois podemos comentar o que o código está fazendo:
+Comentários são partes do código que não serão executadas. Eles podem ser usados para lembrar de algo naquela parte do código, por exemplo. São muito bons quando estamos aprendendo, pois podemos comentar o que o código está fazendo:
 
 ```ruby
 # Este é um comentário que não é executado
@@ -12,4 +12,4 @@ def linguagem_de_programacao
 end
 ```
 
-Para criarmos um comentário, iniciamos a frase com ‘#’, assim, o ruby sabe que ali tem um comentário e ele não precisa executar nada.
+Para criarmos um comentário, iniciamos a linha com ‘#’, assim, o ruby sabe que ali tem um comentário e ele não precisa executar nada. Você pode utilizar '#' em quantas linhas quiser.

ruby/controle_fluxo.md

@@ -1,8 +1,8 @@
 ### Controle de fluxo
 
-Até então escrevemos código que é executado sequencialmente e nesta seção mostraremos uma forma de controlar o fluxo do programa, a partir de alguma condição. Com isso poderemos realizar decisões durante a execução da nossa aplicação.
+Até então escrevemos código que é executado sequencialmente. Nesta seção mostraremos uma forma de controlar o fluxo do programa, a partir de alguma condição. Com isso poderemos realizar decisões durante a execução da nossa aplicação.
 
-Parece difícil, mas bem simples e fica mais ainda a medida que vamos praticando. Pense como uma tomada de decisão, a partir de uma sentença, escolhemos o que o programa irá fazer.
+Parece difícil, mas é bem simples e fica mais ainda a medida que vamos praticando. Pense como uma tomada de decisão: a partir de uma sentença, escolhemos o que o programa irá fazer.
 
 Por exemplo, vamos imprimir no método `escrever_nome` criado na seção anterior apenas se o nome não estiver em branco.
 
@@ -12,7 +12,7 @@ if nome != ''
 end
 ```
 
-Outra forma de implementar seria utilizando o método `empty?`
+Outra forma de implementar seria utilizando o método `empty?`, que significa _vazio?_ em inglês. Fica bem mais fácil de ler, não é mesmo?
 
 ```ruby
 if !nome.empty?

ruby/inteiros_decimais.md

@@ -14,8 +14,6 @@ preco = 4.5
 
 Sendo `4,5` o valor no exemplo, pois o Ruby representa esses valores com ponto.
 
-**Obs**: Um ponto importante para citar aqui, é sobre o nome que damos às variáveis: elas não devem conter espaços, como podemos ver nas variáveis criadas aqui o espaço foi substituído por *underline* (\_).
-
 Experimente no **irb** algumas operações com números:
 
 ```ruby
@@ -34,4 +32,4 @@ E também alguns métodos:
 (irb)> (1+2).next.next # 5
 ```
 
-Falaremos mais sobre mais métodos ainda neste capítulo.
+Falaremos mais sobre métodos ainda neste capítulo.

ruby/lacos_repeticao.md

@@ -1,10 +1,10 @@
 ### Laço de repetição
 
-Em algumas situações precisamos repetir um operação em elementos de um conjunto de dados e podemos realizar tal tarefa utilizando laços.
+Em algumas situações precisamos repetir uma operação em elementos de um conjunto de dados. Podemos realizar esta tarefa utilizando laços.
 
-Imprimir 2 nomes de uma lista é fácil, certo? Mas imagina escrever 100 nomes!! Utilizamos laços para nos poupar de escrever códigos duplicados.
+Imprimir 2 nomes de uma lista é fácil, certo? Mas imagina escrever 100 nomes! Utilizamos laços para nos poupar de escrever códigos duplicados.
 
-Por exemplo, podemos imprimir os nomes de uma lista utilizando o `for`, percorrendo a lista, item a item:
+Por exemplo, podemos imprimir todos os nomes em uma lista utilizando o `for`, percorrendo a lista, item a item:
 
 ```ruby
 lista_de_nomes = ["Juliana", "Enzo", "Roberto"]

ruby/listas.md

@@ -1,6 +1,6 @@
 ### Listas de dados
 
-As listas de dados são chamados de `Array` e serve para armazenarmos valores de vários tipos:
+As listas de dados são chamados de `Array`. Elas servem para armazenarmos uma lista de valores de vários tipos:
 
 Palavras ou frases:
 

ruby/metodos.md

@@ -12,21 +12,21 @@ Ok, mas o que significa tudo isso?
 
 * `def` \- estamos dizendo que estamos definindo um método
 * `escrever_nome` \- esse é o nome do nosso método. Note que nele substituímos
-  os espaços por traços (\_)
+  os espaços por traços (\_), assim como nas variáveis
 * `(nome)` \- é o parâmetro do nosso método, uma variável que mandamos para o
   método, para que ele faça algo com ela. Métodos podem receber nenhum, um ou
   mais parâmetros.
-* `“Seu nome é #{nome}”` \- é o que o método vai retornar para a gente,
-  note que usamos o parâmetro nome na frase
+* `“Seu nome é #{nome}”` \- é o que o método vai retornar para a gente.
+  Note que usamos o parâmetro nome na frase.
 * `end` \- estamos dizendo que estamos finalizando o método
 
-Agora utilizando nosso método:
+Utilizando nosso método:
 
 ```ruby
 texto = escrever_nome("Carol")
 ```
 
-Assim o método retornaria `"Seu nome é Carol"` e `texto` agora tem essa frase como valor.
+Assim o método retornaria `"Seu nome é Carol"` e a variável `texto` agora tem essa frase como valor.
 
 Podemos agora utilizar o método `print` já disponibilizado pelo Ruby para "imprimir" a frase na linha de comando:
 

ruby/onde_aprender_mais.md

@@ -1,6 +1,6 @@
 ### Onde aprender mais sobre Ruby?
 
-Abaixo, alguns links que podem ajudar a ver mais sobre ruby, e a treinar um pouquinho também :)
+Abaixo, alguns links que podem ajudar você a saber mais sobre ruby, e a treinar um pouquinho também :)
 
 * [https://www.codecademy.com/pt-BR/courses/ruby-beginner-pt-BR](https://www.codecademy.com/pt-BR/courses/ruby-beginner-pt-BR)
 * [https://howtocode.io/ruby/](https://howtocode.io/ruby/) está em inglês, mas é bom tentar dar uma olhada ;) vai firme do Google Tradutor :P