finish reviewing instructions

exercises/01-hello-world/README.es.md

@@ -1,15 +1,20 @@
 # Aprende Funciones en Python!
 
 ¡¡Nos estusiasma mucho tenerte aquí!! 🎉 😂
+
 Presiona `Next` `Next →` de arriba a la derecha cuando quieras empezar.
 
 En este curso aprenderás los siguientes conceptos:
 
-1. Cómo crear y llamar Funciones.
-2. Construir tus primeras funciones reales
-3. Sentirte cómod@ usando Funciones Lambda en Python
-4. Construir Funciones con parametros.
-5. Ejemplos de la vida real con funciones
+1. Cómo crear y llamar **funciones.**
+
+2. Construir tus primeras **funciones.** 
+
+3. Sentirte cómod@ usando **funciones Lambda** en Python
+
+4. Construir **funciones** con parámetros.
+
+5. Ejemplos de la vida real con **funciones**
 
 ## Contributors
 

exercises/01-hello-world/README.md

@@ -5,15 +5,20 @@ intro: "https://www.youtube.com/watch?v=awa_yfGgy9s"
 # Learn Python Functions!
 
 We are very excited to have you here !! 🎉 😂
+
 Click `next` on the top right of this instructions when you are ready to start.
 
 During this course you will be learning the following concepts:
 
-1. Learning how to create and call Functions.
-2. Building your first real functions
-3. Get comfortable using Python Lambda Functions
-4. Construct Functions with parameters.
-5. Real life examples for functions
+1. Learning how to create and call **functions.***
+
+2. Building your first real **functions**
+
+3. Get comfortable using Python **Lambda Functions**
+
+4. Construct **functions** with parameters.
+
+5. Real life examples for **functions**
 
 ## Contributors
 

exercises/02-Hello-World/README.es.md

@@ -1,19 +1,20 @@
-# `02` Hola, Mundo
+# `02` Hello World
 
 En Python, usamos `print` para hacer que el computador escriba cualquier cosa que queramos (el contenido de una variable, un texto dado, etc.) en algo llamado `la consola`.
 
-Cada idioma tiene funciones para integrarse con la consola, ya que al principio era la única forma de interactuar con los usuarios (antes de que llegara Windows o MacOS o Linux). Hoy en día, la impresión en la consola se utiliza sobre todo como herramienta de monitorización, ideal para dejar un rastro del contenido de las variables durante la ejecución del programa.
+Cada idioma tiene **funciones** para integrarse con la consola, ya que al principio era la única forma de interactuar con los usuarios (antes de que llegara Windows o MacOS o Linux). Hoy en día, la impresión en la consola se utiliza(`print`) sobre todo como herramienta de monitoreo, ideal para dejar un rastro del contenido de las variables durante la ejecución del programa.
 
-Este es un ejemplo de cómo usarlo:
-```js
+Este es un ejemplo de cómo usarlo
+
+```py
 print("How are you?")
 ```
 
 ## 📝 Instrucciones:
 
-Usa la función `print()` para escribir "Hello World" en la consola. Siéntete libre de intentar otras cosas también.
+1. Usa la función `print()` para escribir `"Hello World"` en la consola. Siéntete libre de intentar otras cosas también.
 
-## 💡 Ayuda:
+## 💡 Pista:
 
-Video de 5 minutos sobre la consola:
++ :video_camera: Puedes ver este breve video (5 minutos) sobre la consola:
 https://www.youtube.com/watch?v=vROGBvX_MHQ

exercises/02-Hello-World/README.md

@@ -6,18 +6,20 @@ tutorial: "https://www.youtube.com/watch?v=voBO7a0KPtE"
 
 In Python, we use `print` to make the computer write anything we want (the content of a variable, a given string, etc.) in something called `the console`.
 
-Every language has functions to integrate with the console, as it was the only way to interact with the users at the beginning (before the Windows or Linux or MacOS arrived). Today, printing in the console is used mostly as a monitoring tool, ideal to leave a trace of the content of variables during the program execution.
+Every language has **functions** to integrate with the console, as it was the only way to interact with the users at the beginning (before the Windows or Linux or MacOS arrived).
+
+Today, printing in the console is used mostly as a monitoring tool, ideal to leave a trace of the content of variables during the program execution.
 
 This is an example of how to use it:
-```js
+```py
 print("How are you?")
 ```
 
 ## 📝 Instructions:
 
-Use print to display "Hello World" on the console. Feel free to try other things as well.
+1. Use `print` to display `"Hello World"` on the console. Feel free to try other things as well.
 
 ## 💡 Hint:
 
-5 minutes video about the console:
++ :video_camera: You can watch this 5 minutes video about the console:
 https://www.youtube.com/watch?v=vROGBvX_MHQ

exercises/03-What-is-a-function/README.es.md

@@ -2,7 +2,7 @@
 
 Puedes ver una función como un **fragmento de código** que puedes encapsular entre llaves para poder usarla varias veces.
 
-Por ejemplo, si queremos obtener la suma de dos números, podemos declarar una función llamada `sum` que devuelve la suma de number1 y number2:
+Por ejemplo, si queremos obtener la suma de dos números, podemos declarar una función llamada `sum` que devuelve la suma de `number1` y `number2`:
 
 ```python
 def sum(number1,number2):
@@ -15,10 +15,10 @@ Después de declarar la función, podemos usarla tantas veces como queramos, as
 total = sum(2,3)
 total2 = sum(5,10)
 
-print(total) # prints 5 on the terminal
-print(total2) # prints 15 on the terminal
+print(total) # imprime 5 en la consola
+print(total2) # imprime 15 en la consola
 ```
 
 # 📝 Instrucciones
 
-Calcula la suma entre **3445324** y **53454423** y asigna el resultado a una variable llamada `super_duper`
+1. Calcula la suma entre **3445324** y **53454423** y asigna el resultado a una variable llamada `super_duper`

exercises/03-What-is-a-function/README.md

@@ -6,7 +6,7 @@ tutorial: "https://www.youtube.com/watch?v=tgTLyZ0cKj4"
 
 You can see a function as a **fragment of code** we can use several times.
 
-For example: If we want to get the sum of two numbers, we can declare a function called `sum` that returns the sum of number1 and number2:
+For example: If we want to get the sum of two numbers, we can declare a function called `sum` that returns the sum of `number1` and `number2`:
 
 ```python
 def sum(number1,number2):
@@ -19,10 +19,10 @@ After the function is declared we can use it as many times as we want, like this
 total = sum(2,3)
 total2 = sum(5,10)
 
-print(total) # prints 5 on the terminal
-print(total2) # prints 15 on the terminal
+print(total) # prints 5 on the console
+print(total2) # prints 15 on the console
 ```
 
 # 📝 Instructions
 
-Please calculate the sum between **3445324** and **53454423** and assign the result to a variable called `super_duper`
+1. Please calculate the sum between **3445324** and **53454423** and assign the result to a variable called `super_duper`

exercises/04-Call-a-function/README.es.md

@@ -2,7 +2,7 @@
 
 Una función podría recibir 0 parámetros y tú puedes devolver algo siempre, incluso si no añades explícitamente el `return`.
 
-:point_up: [Presiona aquí para saber más sobre funciones](https://content.breatheco.de/lesson/working-with-functions-python)
+:point_up: [Presiona aquí para saber más sobre funciones](https://content.breatheco.de/es/lesson/working-with-functions-python/)
 
 Por ejemplo, una función que calcula el área de un cuadrado sería algo como esto:
 
@@ -18,25 +18,29 @@ length = 3
 edge = 6
 ```
 
-Necesitas hacer algo como esto:
+Tendrías que hacer algo como esto:
+
 ```python
 area = calculate_area(3,6)
-# The value of area will be set to 18
+# El valor del área es 18
 ```
 
-# 📝 Instrucciones:
+## 📝 Instrucciones:
+
+
+1. Create a new variable named `square_area1`, `square_area2`, `square_area3` and call the function `calculate_area` three times one for each square in the picture, for example: 
 
-Crea una nueva variable llamada squareArea para cada nueva iteración de la función CalculateArea utilizando las dimensiones de la figura, por ejemplo, para la primera figura,
+1. Crea nuevas variables llamadas `squareArea1`, `square_area2`, `square_area3` y llama a la función `CalculateArea` 3 veces, un por cada cuadrador en la foto, utilizando las dimensiones de la figura, por ejemplo:
 
 ```python
-# For the first figure:
+# para la primera figura:
 square_area1 = calculate_area(4,4)
 ```
 
 ![img](http://i.imgur.com/VyoJRAL.png)
 
-# 💡 Sugerencia:
+## 💡 Pista:
 
 - Llama 3 veces a la función `calculate_area`, una por cada cuadrado, pasando la longitud y el borde de cada cuadrado.
 
-:tv: [Video de 9 min sobre funciones en Python](https://www.youtube.com/watch?v=NE97ylAnrz4)
++ :video_camera: [Video de 9 min sobre funciones en Python](https://www.youtube.com/watch?v=NE97ylAnrz4)

exercises/04-Call-a-function/README.md

@@ -23,14 +23,15 @@ edge = 6
 ```
 
 You need to do something like this:
+
 ```python
 area = calculate_area(3,6)
 # The value of area will be set to 18
 ```
 
-# 📝 Instructions:
+## 📝 Instructions:
 
-Create a new variables named square_area1, square_area2, square_area3 and call the function calculate_area three times one for each square in the picture, for example: 
+1. Create a new variables named `square_area1`, `square_area2`, `square_area3` and call the function `calculate_area` three times one for each square in the picture, for example: 
 
 ```python
 # For the first figure:
@@ -39,9 +40,9 @@ square_area1 = calculate_area(4,4)
 
 ![img](http://i.imgur.com/VyoJRAL.png)
 
-# 💡 Hint:
+## 💡 Hint:
 
-Call the `calculate_area` function three times, one per each square, passing the length and edge of each square.
++ Call the `calculate_area` function three times, one per each square, passing the length and edge of each square.
 
-:tv: [9 min video about functions in python](https://www.youtube.com/watch?v=NE97ylAnrz4)
++ :video_camera: [9 min video about functions in python](https://www.youtube.com/watch?v=NE97ylAnrz4)
 

exercises/05-Defining-vs-Calling-a-function/README.es.md

@@ -1,26 +1,34 @@
 # `05` Definir vs llamar a una función
 
-Las funciones solo existirán si usted u otra persona las define ... es la única forma en que el compilador/intérprete de idiomas sabe que existen, por lo tanto, puede ejecutarlas cuando las llama.
+Las funciones solo existen si tú u otra persona las define... es la única forma en que el compilador/intérprete de idiomas sabe que existen, por lo tanto, puede ejecutarlas cuando las llama.
 
 Para definir una función necesitamos escribir esta fórmula básica de código:
 
 ```python
 def myFunctionName(parameter, parameter2, ...parameterX):
- # the function code here
+ # codigo de la función aquí
  return something
 ```
 
 La palabra `def` es una palabra reservada en Python, esto significa que solo se usa para definir una función.
 
-**El nombre** de la función podría ser lo que quieras. Consejo: usa un nombre descriptivo (no intentes ahorrar palabras, usa tantas como necesites) de esta manera entenderás lo que hace la función -y lo que devuelve-.
-Nombres de ejemplo: add_two_integers , calculate_taxes , get_random_number, etc.
+**El nombre** de la función podría ser lo que quieras.
 
-**Parámetros:** puedes definir tantos parámetros como desees, más aún, si los necesitas. La cantidad de parámetros dependerá de las operaciones realizadas dentro de la función. Ejemplo: si la función está agregando dos enteros (3 + 4), esto significa que la función necesitará dos parámetros (uno para cada entero).
+*Consejo:* usa un nombre descriptivo (no intentes ahorrar palabras, usa tantas como necesites) de esta manera entenderás lo que hace la función -y lo que devuelve-.
 
-**Ámbito:** Todo el código que contenga la función debe tener una sangría a la derecha, todo lo que esté en una sangría diferente no será considerado como parte de la función, esto se llama **ámbito**, y puede ser local (dentro de la función) y global (fuera de la función).
+Nombres de ejemplo: `add_two_integers` (suma dos números enteros, `calculate_taxes` (calcular impuestos) , `get_random_number` (obtener número aleatorio), etc.
 
-**El retorno**: no todas las funciones necesitan devolver algo, pero se recomienda que lo haga.
-Consejo: devolviendo `None` es un buen valor por defecto para cuando, aún, no sabes si se necesita devolver algo.
+**Parámetros:** puedes definir tantos parámetros como desees, más aún, si los necesitas. 
+
+La cantidad de parámetros dependerá de las operaciones realizadas dentro de la función. 
+
+Ejemplo: si la función está sumando dos enteros (3 + 4), esto significa que la función necesitará dos parámetros (uno para cada entero).
+
+**Alcance:** Todo el código que contenga la función debe tener una sangría a la derecha, todo lo que esté en una sangría diferente no será considerado como parte de la función, a esto se llama **alcance**, y puede ser local (dentro de la función) y global (fuera de la función).
+
+**El retorno**: no todas las funciones necesitan devolver algo, pero se recomienda que lo hagan.
+
+*Consejo*: devolver `None` es un buen valor por defecto para cuando, aún, no sabes si tu función debe devolver algo.
 
 Ejemplo de una función:
 
@@ -32,12 +40,14 @@ def concatenate_number_to_string(local_number, local_string):
 ```
 
 
-# 📝 Instrucciones:
+## 📝 Instrucciones:
+
+1. Define una función llamada `multi`.
+
+2. La función `multi` recibe dos números.
 
-1. Define una función llamada "multi".
-2. La función múltiple recibe dos números
 3. Devuelve el resultado de la multiplicación entre ellos.
 
-# 💡 Pista:
+## 💡 Pista:
 
-Recuerda agregar la línea de `return`. Cada función debe devolver algo. En este caso debería ser el resultado de la multiplicación.
++ Recuerda agregar la línea de `return`. Una función siempre debería devolver algo. En este caso debería ser el resultado de la multiplicación.

exercises/05-Defining-vs-Calling-a-function/README.md

@@ -47,10 +47,12 @@ def concatenate_number_to_string(local_number, local_string):
 
 # 📝 Instructions:
 
-1. Define a function called "multi".
-2. Multi function receive two numbers
+1. Define a function called `multi`.
+
+2. The `multi` function receives two numbers.
+
 3. Return the result of the multiplication between them.
 
-# 💡 Hint
+## 💡 Hint
 
-Remember to add the "return" line, every function must return something, in this case it should be the result of the multiplication.
++ Remember to add the `return` line. Every function should return something, in this case it should be the result of the multiplication.

exercises/06-lambda-functions/README.es.md

@@ -1,33 +1,39 @@
 # `06` Funciones Lambda en Python
 
-Una función lambda es una función con solo una línea de código y sin nombre.
-Es un tipo de función muy especial en el mundo Python porque puedes usarla como una pequeña utilidad para una programación muy ágil:
+Una **función lambda** es una función con solo una línea de código y sin nombre.
+
+Es un tipo de función muy especial en el mundo Python porque puedes usarla como una 'pequeña utilidad' para una programación muy ágil:
 
 ```python
-# declaring a normal funcion for multiplication
+# declarando una función normal para una multiplicación
 def multiply(p1, p2):
  return p1 * p2
 
-# declaring it now like a one line lambda
+# declarándola en una línea como una función lambda
 multiply = lambda p1,p2: p1 * p2
 ```
 
-1. Las funciones lambda tiene que ser siempre muy pequeñas
-2. Las funciones lambda pueden tener únicamente una línea
-3. Las funciones lambda no necesitan un `return`, se asume que lo que haya en esa línea devolverá un valor.
-4. Las funciones lambda can be stored in variables or passed as parameters to another function
+1. Las **funciones lambda** tiene que ser siempre muy pequeñas.
+
+2. Las **funciones lambda** pueden tener únicamente una línea.
+
+3. Las **funciones lambda** no necesitan un `return`, se asume que lo que haya en esa línea devolverá un valor.
+
+4. Las **funciones lambda** pueden almacenarse en variables o ser pasadas como parámetro a otra función.
+
+
+## 📝 Instrucciones:
 
-# 📝 Instrucciones:
+1. Crea una variable llamada `is_odd`.
 
-1. Crea una variable llamada `is_odd`
-2. Asígnale una función lambda que devuelva True o False dependiendo de si un número dado es impar o no
+2. Asígnale una función lambda que devuelva `True` o `False` dependiendo de si un número dado es impar o no.
 
-## 💡 Ayuda:
+## 💡 Pista:
 
-Así es como declararías una función normal
++ Así es como declararías una función normal:
 
 ```python
-# this function return True if a number is odd.
+# Esta función retorna `True` si el número es impar
 def is_odd(num):
  return (num % 2) != 0
 ```