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!).