Merge pull request #86 from UmiKami/exercise-enhancement-Q3-2023

Exercise enhancement q3 2023 - first 10

Author: alesanchezr

exercises/01-Console/README.es.md

@@ -2,7 +2,7 @@
 
 En Python, usamos **print** para que el computador escriba cualquier cosa que queramos (el contenido de una variable, una string dado, etc.) en algo llamado "la consola".
 
-Cada lenguaje tiene una consola, ya que al principio era la única forma de interactuar con los usuarios (antes de que llegaran Windows, Linux o MacOS).
+Cada lenguaje de programación tiene una consola, ya que al principio era la única forma de interactuar con los usuarios (antes de que llegaran Windows, Linux o MacOS).
 
 Hoy en día, la impresión en la consola se utiliza, sobre todo, como herramienta de monitoreo y depuración, ideal para dejar un rastro del contenido de las variables durante la ejecución del programa.
 
@@ -14,4 +14,12 @@ print("Un texto en la consola")
 
 ## 📝 Instrucciones:
 
-1. usa **print** para escribir `Hello World!` en la consola. Siéntete libre de intentar otras cosas también.
+1. usa **print** para escribir `Hello World!` en la consola. 
+
+## 💡 Pistas:
+
++ Recuerda, para ejecutar el código y ver el resultado en la consola, haz clic en el ícono de caja en la esquina superior izquierda de la pantalla:
+
+https://i.imgur.com/w6u4aDd.png
+
++ Siéntete libre de intentar otras cosas también.

exercises/01-Console/README.md

@@ -6,7 +6,7 @@ tutorial: "https://www.youtube.com/watch?v=2sV-2frucUs"
 
 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 a console, as it was the only way to interact with the users at the beginning (before Windows or MacOS arrived).
+Every programming language has a console, as it was the only way to interact with the users at the beginning (before Windows or MacOS arrived).
 
 Today, printing in the console is used mostly as a monitoring and debugging tool, ideal to leave a trace of the content of variables during the program execution.
 
@@ -18,4 +18,13 @@ print("How are you?")
 
 ## 📝 Instructions:
 
-1. Use **print** to print `Hello World!` on the console. Feel free to try other things as well.
+1. Use **print** to print `Hello World!` on the console. 
+
+
+## 💡 Hints:
+
++ Remember, to run the code and see the output on the console, click on the box icon in the top left of the screen:
+
+https://i.imgur.com/w6u4aDd.png
+
++ Feel free to try other things as well.

exercises/01-Console/test.py

@@ -19,5 +19,5 @@ def test_for_file_output(capsys):
 @pytest.mark.it('Print Hello World! on the console')
 def test_for_console_log(capsys):
     captured = buffer.getvalue()
-    assert captured == "Hello World!\n" #add \n because the console jumps the line on every print
+    assert "Hello World!\n" in captured #add \n because the console jumps the line on every print
 

exercises/02-Declare-Variables/README.es.md

@@ -1,17 +1,21 @@
 # `02` Declare Variables
 
-Las variables actúan como una caja (contenedor) que te permite almacenar distintos tipos de datos. Así es como se define una variable:
+En la programación, usamos variables como si fueran cajas (o contenedores) para guardar diferentes tipos de información. Así es cómo creamos una variable:
 
 ```py
 name = "Daniel"
 ```
 
+En este ejemplo, `name` es la variable, actuando como una caja para almacenar el valor `"Daniel"`. Dentro de esta 'caja', estamos almacenando el valor `"Daniel"`, y podemos usar `name` para referirnos a este valor más tarde. Al nombrar tus variables, puedes elegir casi cualquier nombre, pero debe comenzar con una letra o un guión bajo (`_`). Es útil elegir un nombre que describa lo que hay dentro de la 'caja' para que puedas entender fácilmente lo que representa más adelante.
+
 ## 📝 Instrucciones:
 
-1. Declara una variable con el valor "Yellow" y luego imprímelo en la consola.
+1. Declara una variable con el valor `"Yellow"` y luego imprímelo en la consola.
 
 2. Luego, imprime su valor en la consola usando `print(name)`.
 
 ## 💡 Pista:
 
 + Puedes darle el nombre que quieras a la variable, pero su valor tiene que ser el texto "Yellow".
+
++ Si necesitas más explicación sobre qué son los **strings** y cómo funcionan en Python, puedes ver este clip: https://www.youtube.com/watch?v=yT0jixU3M2c&ab_channel=ProgramaResuelto (`ctrl + click` en el enlance para abrir el video)

exercises/02-Declare-Variables/README.md

@@ -4,18 +4,21 @@ tutorial: "https://www.youtube.com/watch?v=dWWvZkaPwDw"
 
 # `02` Declare Variables
 
-Variables act as a box (container) that lets you store different types of data. This is how we set a variable:
+In programming, we use variables like boxes (or containers) to store different kinds of information. Here's how to create a variable:
 
 ```py
 name = "Daniel"
 ```
 
+In this example, `name` is the variable, acting like a box to store the value `"Daniel"`. Inside this 'box', we're storing the value `"Daniel"`, and we can use `name` to refer to it later. When naming your variables, you can choose almost any name, but it must begin with a letter or an underscore (`_`). It's helpful to pick a name that describes what's inside the 'box' so you can easily understand what it represents later on.
+
 ## 📝 Instructions:
 
-1. Declare a new variable with the string value "Yellow" and print the value to the console.
+1. Declare a new variable with the string value `"Yellow"` and print the value to the console.
 
 2. Then, print its value on the console using `print(name)`.
 
 ## 💡 Hint:
 
 + The name of the variable can be whatever you want, but the value inside has to be the string "Yellow".
++ If you need further explanation on what **strings** are and how they work in python, you can watch this clip: https://youtube.com/clip/UgkxyQ_JLmgSUL4l25c8Ly7cCRvk1Gm-EchU (`ctrl + click` on the link to open the video)

exercises/02-Declare-Variables/app.py

@@ -1 +1 @@
-# your code here
+# ✅ ↓ your code here ↓ ✅

exercises/02-Declare-Variables/solution.hide.py

@@ -1,4 +1,4 @@
-# your code here
+# ✅ ↓ your code here ↓ ✅
 
 color = "Yellow"
 print(color)

exercises/02-Declare-Variables/test.py

@@ -27,6 +27,6 @@ def test_for_variable():
 @pytest.mark.it('Print the variable on the console')
 def test_for_file_output(capsys):
     captured = buffer.getvalue()
-    assert captured == "Yellow\n" #add \n because the console jumps the line on every print
+    assert   "Yellow\n" in captured #add \n because the console jumps the line on every print
 
 

exercises/03-Print-Variables-In-The-Console/README.es.md

@@ -9,6 +9,6 @@ print(my_super_variable)
 
 ## 📝 Instrucciones:
 
-1. Declara una nueva variable llamada `color` y asígnale el valor `red`.
+1. Declara una nueva variable llamada `color` y asígnale el valor `"red"`.
 
 2. Luego, imprime su valor en la consola (puede que tengas que desplazarte en la consola para poder verlo).

exercises/03-Print-Variables-In-The-Console/README.md

@@ -13,6 +13,6 @@ print(my_super_variable)
 
 ## 📝 Instructions:
 
-1. Declare a new variable called `color` and assign the value `red` to it.
+1. Declare a new variable called `color` and assign the value `"red"` to it.
 
 2. Then, print its value on the console (you may have to scroll up in the terminal to see it!).

exercises/03-Print-Variables-In-The-Console/app.py

@@ -1 +1 @@
-#your code here
+# ✅ ↓ your code here ↓ ✅

exercises/03-Print-Variables-In-The-Console/solution.hide.py

@@ -1,4 +1,4 @@
-#your code here
+# ✅ ↓ your code here ↓ ✅
 
 color = "red"
 print(color)

exercises/03-Print-Variables-In-The-Console/test.py

@@ -11,7 +11,7 @@
 @pytest.mark.it("Create a variable named 'color' with the string value red")
 def test_declare_variable():
     result = app.color
-    assert result == "red"
+    assert  result == "red"
 
 @pytest.mark.it('Print on the console the value of the variable ')
 def test_for_printing_variable():
@@ -24,4 +24,4 @@ def test_for_printing_variable():
 @pytest.mark.it('The printed value on the console should be "red"')
 def test_for_file_output(capsys):
     captured = buffer.getvalue()
-    assert captured == "red\n"
+    assert  "red\n" in captured 

exercises/04-Multiply-Two-Values/README.md

@@ -12,7 +12,7 @@ To multiply 2 values in python, you have to use the asterisk operator like this:
 resulting_value = 2 * 3
 ```
 
-In this case, we stored the result value of the multiplication into a variable called `resulting_value`.
+In this case, we stored the resulting value of the multiplication into a variable called `resulting_value`.
 
 ## 📝 Instructions:
 

exercises/04-Multiply-Two-Values/app.py

@@ -1 +1 @@
-# your code here
+# ✅ ↓ your code here ↓ ✅

exercises/04-Multiply-Two-Values/solution.hide.py

@@ -1,3 +1,4 @@
-# your code here
+# ✅ ↓ your code here ↓ ✅
+
 variables_are_cool = 2345 * 7323
 print(variables_are_cool)

exercises/04-Multiply-Two-Values/test.py

@@ -23,7 +23,7 @@ def test_use_variable_name():
 @pytest.mark.it('Print on the console the variables_are_cool value ')
 def test_for_file_output(capsys):
     captured = buffer.getvalue()
-    assert captured == '17172435\n'
+    assert '17172435\n' in captured
 
 @pytest.mark.it('Print on the console the variables_are_cool variable')
 def test_for_print():

exercises/05-User-Inputed-Values/app.py

@@ -1,4 +1,4 @@
 age = int(input('What is your age?\n'))
-# CHANGE THE CODE BELOW TO ADD 10 TO AGE
+# ✅ ↓ CHANGE THE CODE BELOW TO ADD 10 TO AGE ↓ ✅
 
 print("Your age is: "+str(age))

exercises/05-User-Inputed-Values/solution.hide.py

@@ -1,4 +1,4 @@
 age = int(input('What is your age?\n'))
-# CHANGE THE CODE BELOW TO ADD 10 TO AGE
+# ✅ ↓ CHANGE THE CODE BELOW TO ADD 10 TO AGE ↓ ✅
 age = age + 10
 print("Your age is: "+str(age))

exercises/05-User-Inputed-Values/test.py

@@ -16,5 +16,5 @@ def test_plus_ten(stdin):
     sys.stdout = buffer = io.StringIO()
     import app
     captured = buffer.getvalue()
-    assert captured == "Your age is: 60\n"
+    assert   "Your age is: 60\n" in captured
 

exercises/06-String-Concatenation/README.es.md

@@ -1,17 +1,23 @@
 # `06` String Concatenation
 
-Una de las tareas más comunes que tú tendrás que realizar con cualquier lenguaje incluye el unir o combinar strings. 
+La concatenación de strings es una tarea común en la programación que implica combinar o unir dos o más strings.
 
-A esto le llamamos: **concatenar**.
+Puedes pensar en este proceso como conectar dos o más vagones de tren. Si cada string es un vagón, la concatenación es el acoplamiento que los une para formar un tren único.
 
-La mejor forma de explicarlo es cuando tienes dos *strings* separados – almacenados por el intérprete – y tienes que unirlos de forma que sean uno solo.
+En Python, puedes concatenar o unir dos o más strings usando el operador `+`. Así es como funciona:
 
 ```py
+
 one = 'a'
 two = 'b'
-print(one+two); # esto imprimirá 'ab' en la consola.
+print(one + two)  # esto imprimirá 'ab' en la consola.
 ```
 
-## 📝 Instrucciones:
+Aquí, las variables `one` y `two` contienen los strings individuales `'a'` y `'b'`, respectivamente. Cuando usas el operador `+` entre ellos, actúa como un pegamento, uniendo los strings de extremo a extremo. En este caso, une `'a'` y `'b'`, dando como resultado el string concatenado `'ab'`, que se imprime en la consola.
+
+## 📝 Instrucciones: 
+1. Establece los valores para `my_var1` y `my_var2` de manera que, al concatenarlos, el código imprima `Hello World` en la consola.
+
 
-1. Establece valores para las variables `my_var1` y `my_var2` de forma que el código imprima `Hello World` en la consola.
+## 💡 Pista:
++ Si necesitas más explicación sobre como la **concatenación** funciona en Python, puedes ver este clip: https://www.youtube.com/watch?v=T1nyPuAhd1U&ab_channel=ProgramaResuelto (`ctrl + click` en el enlance para abrir el video)

exercises/06-String-Concatenation/README.md

@@ -4,18 +4,23 @@ tutorial: "https://www.youtube.com/watch?v=kS4qpQmHwCs"
 
 # `06` String Concatenation
 
-One common task you’ll need to accomplish with any language involves merging or combining strings.
+String concatenation is a common task in programming that involves combining or linking two or more strings together.
 
-This process is referred to as: **concatenation**.
+You can think of this process as similar to connecting two or more train cars. If each string is a train car, concatenation is the coupling that joins them to form a single train.
 
-The best way to describe it is when you take two separate strings – stored by the interpreter – and merge them so that they become one.
+In Python, you can concatenate, or join together, two or more strings using the `+` operator. This is how it works:
 
 ```py
+
 one = 'a'
 two = 'b'
-print(one+two); #this will print 'ab' on the console.
+print(one + two)  # this will print 'ab' on the console.
 ```
 
-## 📝 Instructions:
+Here, the variables `one` and `two` hold the individual strings `'a'` and `'b'`. When you use the `+` operator between them, it acts like a glue, sticking the strings together end-to-end. In this case, it joins `'a'` and `'b'`, resulting in the concatenated string `'ab'`, which gets printed to the console.
+
+## 📝 Instructions: 
+1. Set the values for `my_var1` and `my_var2` so that when concatenated, the code prints `Hello World` in the console.
 
-1. Set the values for `my_var1` and `my_var2` so the code prints `Hello World` in the console.
+## 💡 Hint:
++ If you need further explanation on how string **concatenation** works in python, you can watch this clip: https://www.youtube.com/watch?v=28FUVmWU_fA&ab_channel=PortfolioCourses (`ctrl + click` on the link to open the video)

exercises/06-String-Concatenation/app.py

@@ -1,4 +1,4 @@
-# Set the values for my_var1 and my_var2 here
+# ✅ ↓ Set the values for my_var1 and my_var2 here ↓ ✅
 
 
 ## Don't change below this line

exercises/06-String-Concatenation/solution.hide.py

@@ -1,4 +1,5 @@
-# Set the values for my_var1 and my_var2 here
+# ✅ ↓ Set the values for my_var1 and my_var2 here ↓ ✅
+
 my_var1 = "Hello"
 my_var2 = "World"
 

exercises/06-String-Concatenation/test.py

@@ -20,12 +20,12 @@ def test_my_var2_exists():
 @pytest.mark.it("Variable my_var1 value should be 'Hello'")
 def test_my_var1_value():
     from app import my_var1
-    assert my_var1 == "Hello"
+    assert  my_var1.lower() == "hello"
 
 @pytest.mark.it("Variable my_var2 value should be 'World'")
 def test_my_var2_value():
     from app import my_var2
-    assert my_var2 == "World"
+    assert   my_var2.lower() == "world"
 
 @pytest.mark.it("Variable my_var2 value should be 'World'")
 def test_the_new_string_exists():
@@ -38,4 +38,4 @@ def test_the_new_string_exists():
 @pytest.mark.it('Print "Hello World" on the console')
 def test_for_file_output():
     captured = buffer.getvalue()
-    assert captured == "Hello World\n" #add \n because the console jumps the line on every print
+    assert "hello world\n" in captured.lower() #add \n because the console jumps the line on every print

exercises/07-Create-a-Basic-HTML/app.py

@@ -7,6 +7,7 @@
 g = '<title>'
 h = '<body>'
 
-# ⬆ DON'T CHANGE THE CODE ABOVE ⬆
-# ↓ start coding below here ↓
+# ❌ ⬆ DON'T CHANGE THE CODE ABOVE ⬆ ❌
+
+# ✅ ↓ start coding below here ↓ ✅
 

exercises/07-Create-a-Basic-HTML/solution.hide.py

@@ -7,8 +7,9 @@
 g = '<title>'
 h = '<body>'
 
-# ⬆ DON'T CHANGE THE CODE ABOVE ⬆
-# ↓ start coding below here ↓
+# ❌ ⬆ DON'T CHANGE THE CODE ABOVE ⬆ ❌
+
+# ✅ ↓ start coding below here ↓ ✅
 
 html_document = e+c+g+a+f+h+d+b
 print(html_document)

exercises/07-Create-a-Basic-HTML/test.py

@@ -13,7 +13,7 @@ def test_html_document_exists():
 def test_html_document_exists():
     try:
         from app import html_document
-        assert html_document == '<html><head><title></title></head><body></body></html>'
+        assert  html_document == '<html><head><title></title></head><body></body></html>' 
     except ImportError:
         raise ImportError("The variable 'html_document' should exist on app.py")
 
@@ -30,4 +30,4 @@ def test_for_concat():
 @pytest.mark.it('Print a basic html layout on the console like this: <html><head><title></title></head><body></body></html>')
 def test_for_file_output():
     captured = buffer.getvalue()
-    assert captured == "<html><head><title></title></head><body></body></html>\n" #add \n because the console jumps the line on every print
+    assert  "<html><head><title></title></head><body></body></html>\n" in captured #add \n because the console jumps the line on every print

exercises/08.1-Your-First-If/README.es.md

@@ -15,3 +15,14 @@ La aplicación actual está preguntando cuánto dinero tiene el usuario. Una vez
 +  Usa un condicional `if/else` para verificar el valor de la variable `total`.
 
 +  Puedes leer más al respecto [aquí](https://docs.python.org/3/tutorial/controlflow.html#if-statements).
+
++ Aquí tienes un recordatorio sobre los operadores relacionales:
+
+  | Operador | Descripción                                                                  | Sintaxis |
+  |----------|------------------------------------------------------------------------------|----------|
+  | >        | Mayor que: Verdadero si el operando izquierdo es mayor que el derecho        | x > y    |
+  | <        | Menor que: Verdadero si el operando izquierdo es menor que el derecho        | x < y    |
+  | ==       | Igual a: Verdadero si ambos operandos son iguales                            | x == y   |
+  | !=       | No igual a – Verdadero si los operandos no son iguales                       | x != y   |
+  | >=       | Mayor o igual que: Verdadero si el operando izquierdo es mayor o igual       | x >= y   |
+  | <=       | Menor o igual que: Verdadero si el operando izquierdo es menor o igual       | x <= y   |

exercises/08.1-Your-First-If/README.md

@@ -4,7 +4,7 @@ tutorial: "https://www.youtube.com/watch?v=x9wqa5WQZiM"
 
 # `08.1` Your First if...
 
-The current application is prompting asking how much money the user has. Once the user inputs the amount, we need to **print** one of the following answers:
+The current application is asking how much money the user has. Once the user inputs the amount, we need to **print** one of the following answers:
 
 ## 📝 Instructions:
 
@@ -19,3 +19,14 @@ The current application is prompting asking how much money the user has. Once th
 + Use an If/else statement to check the value of the `total` variable.
 
 + Further information [here](https://docs.python.org/3/tutorial/controlflow.html#if-statements).
+
++ Here's a quick reminder on relational operators:
+
+  | Operator | Description                                                        | Syntax    |
+  |----------|--------------------------------------------------------------------|-----------|
+  | >        | Greater than: True if the left operand is greater than the right   | x > y     |
+  | <        | Less than: True if the left operand is less than the right         | x < y     |
+  | ==       | Equal to: True if both operands are equal                          | x == y    |
+  | !=       | Not equal to – True if operands are not equal                      | x != y    |
+  | >=       | Greater than or equal to: True if left operand is greater or equal | x >= y    |
+  | <=       | Less than or equal to: True if left operand is less than or equal  | x <= y    |

exercises/08.1-Your-First-If/app.py

@@ -1,3 +1,3 @@
 total = int(input('How much money do you have in your pocket\n'))
 
-# YOUR CODE HERE
+# ✅ ↓ YOUR CODE HERE ↓ ✅