README-es.md edited on August 3, 2016 at 10:55am

README-es.md

 
 Como habrás aprendido en experiencias de laboratorio anteriores, lograr que un programa compile es solo una pequeña parte de programar. El compilador se encargará de decirte si hubo errores de sintaxis, pero no podrá detectar errores en la lógica del programa. Es muy importante probar las funciones del programa para validar que producen los resultados correctos y esperados.
 
-Una manera de hacer estas pruebas es “a mano”, esto es, corriendo el programa múltiples veces, ingresando valores representativos (por medio del teclado) y visualmente verificando que el programa devuelve los valores esperados. Otra forma más conveniente es implementar funciones dentro del programa cuyo propósito es verificar que otras funciones produzcan resultados correctos. En esta experiencia de laboratorio, practicarás ambos métodos de verificación.
+Una manera de hacer estas pruebas es a mano; esto es, corriendo el programa múltiples veces, ingresando valores representativos (por medio del teclado) y visualmente verificando que el programa devuelve los valores esperados. Otra forma más conveniente es implementar funciones dentro del programa cuyo propósito es verificar que otras funciones produzcan resultados correctos. En esta experiencia de laboratorio practicarás ambos métodos de verificación.
 
 
 ## Objetivos:
 ### La función `assert`
 
 
-La función `assert(bool expression)` se puede utilizar como herramienta rudimentaria para validar funciones. `assert` tiene un funcionamiento muy sencillo y poderoso. Si la expresión que colocamos entre los paréntesis de `assert` es *cierta* la función permite que el programa continúe con la próxima instrucción. De lo contrario, si la expresión que colocamos entre los paréntesis es *falsa*, la función `assert` hace que el programa termine e imprime un mensaje al terminal que informa al usuario sobre la instrucción de `assert` que falló. 
+La función `assert(bool expression)` se puede utilizar como herramienta rudimentaria para validar funciones. `assert` tiene un funcionamiento muy sencillo y poderoso. Si la expresión que colocamos entre los paréntesis de `assert` es *cierta* la función permite que el programa continúe con la próxima instrucción. De lo contrario, si la expresión que colocamos entre los paréntesis es *falsa*, la función `assert` hace que el programa termine e imprima un mensaje al terminal que informe al usuario sobre la instrucción de `assert` que falló. 
 
-Por ejemplo, el siguiente programa correrá de principio a fin sin problemas pues todos las expresiones incluidas en los paréntesis de los asserts evalúan a *true*.
+Por ejemplo, el siguiente programa correrá de principio a fin sin problemas pues todos las expresiones incluidas en los paréntesis de los asserts evalúan a *cierto*.
 
 ---
 
 
 ---
 
-El siguiente programa no correrá hasta el final pues el segundo `assert` (`assert(j == i);`)  contiene una expresión  (`j == i`) que evalúa a *false*.
+El siguiente programa no correrá hasta el final pues el segundo `assert` (`assert(j == i);`)  contiene una expresión  (`j == i`) que evalúa a *falsa*.
 
 ---
 
 
 ```
 
-**Figura 2.** Ejemplo de programa que no "pasa" una prueba de `assert`.
+**Figura 2.** Ejemplo de programa que no pasa una prueba de `assert`.
 
 ---
 
-Al correr el pasado programa, en lugar de obtener la frase `”Eso es todo amigos!”` en el terminal, obtendremos un mensaje como el siguiente:
+Al correr el pasado programa, en lugar de obtener la frase `"Eso es todo amigos!”` en el terminal, obtendremos un mensaje como el siguiente:
 
 `Assertion failed: (j == i), function main, file ../programa01/main.cpp, line 8.`
 
 
 ![figure4.png](images/figure4.png)
 
-**Figura 4** - Interfaz de un programa para hallar el valor máximo entre tres enteros.
+**Figura 4.** Interfaz de un programa para hallar el valor máximo entre tres enteros.
 
 ---
 
 * a = 3, b = 6, c = 2; resultado esperado: 6
 * a = 1, b = 10, c = 100; resultado esperado: 100
 
-Si alguno de estos tres casos no da el resultado esperado, el programa de tu amiga no funciona. Por otro lado, si los tres casos funcionan, entonces el programa tiene una probabilidad alta de estar correcto.
+Si alguno de estos tres casos no da el resultado esperado, el programa de tu amiga no funciona. Por otro lado, si los tres casos funcionan, entonces el programa tiene una alta probabilidad de estar correcto.
+
 
 #### Funciones para validar
 
 
     ![figure5.png](images/figure5.png)
 
-    **Figura 5** - Interfaz de la función `3 Sorts`.
+    **Figura 5.** Interfaz de la función `3 Sorts`.
 
     ---
 
 
     ![figure7.jpg](images/figure7.jpg)
 
-    **Figura 7** - Formas de ganar en el juego "Piedra, papel y tijera".
+    **Figura 7.** Formas de ganar en el juego "Piedra, papel y tijera".
 
     ---
 
     ![figure8.png](images/figure8.png)
 
-    **Figura 8** - Interfaz de la función `Rock, Paper, Scissors`.
+    **Figura 8.** Interfaz de la función `Rock, Paper, Scissors`.
 
     ---
 
 
     ![figure9.png](images/figure9.png)
 
-    **Figura 9** - Interfaz de la función `Zulu time`.
+    **Figura 9.** Interfaz de la función `Zulu time`.
 
     ---
 
   | 2       | "alce", "zorro", "coyote" | "zorro", "alce", "coyote" | ....      | ....       |            |
   | ....    | ....                      | ....                      | ....      | ....       | ....       |
 
-  **Figura 10** - Tabla para organizar los resultados de las pruebas.
+  **Figura 10.** Tabla para organizar los resultados de las pruebas.
 
   ---
 
 
 
 
-### Ejercicio 2: Hacer pruebas "a mano"
+### Ejercicio 2 - Hacer pruebas "a mano"
 
 El proyecto `testing` implementa varias versiones de cada una de las cuatro funciones simples que se decribieron en el Ejercicio 1. Algunas o todas las implementaciones pueden estar incorrectas. Tu tarea es, usando las pruebas que diseñaste en el Ejercicio 1, probar las versiones de cada función para determinar cuáles de ellas, si alguna, están implementadas correctamente.
 
 Este ejercicio **NO requiere programación**, debes hacer las pruebas **sin mirar el código.**
 
-#### Instrucciones:
+#### Instrucciones
 
 1. Carga a `QtCreator` el proyecto `Testing`. Hay dos maneras de hacer esto:
 
     * Utilizando la máquina virtual: Haz doble “click” en el archivo `Testing.pro` que se encuentra en el directorio `/home/eip/labs/testing-testing` de la máquina virtual.
-    * Descargando la carpeta del proyecto de `Bitbucket`: Utiliza un terminal y escribe el commando `git clone http:/bitbucket.org/eip-uprrp/testing-testing` para descargar la carpeta `tema-nombre` de `Bitbucket`. En esa carpeta, haz doble “click” en el archivo `Testing.pro`.
+    * Descargando la carpeta del proyecto de `Bitbucket`: Utiliza un terminal y escribe el comando `git clone http:/bitbucket.org/eip-uprrp/testing-testing` para descargar la carpeta `tema-nombre` de `Bitbucket`. En esa carpeta, haz doble “click” en el archivo `Testing.pro`.
 
 2. Configura el proyecto y corre el programa. Verás una pantalla similar a la siguiente:
   
 
     ![figure11.png](images/figure11.png)
 
-    **Figura 11** - Ventana para seleccionar la función que se va a probar.
+    **Figura 11.** Ventana para seleccionar la función que se va a probar.
 
     ---
 
 3. Selecciona el botón de `3 Sorts` y obtendrás la interfaz de la Figura 5.
 
-4. La "Version Alpha" en la caja indica que estás corriendo la primera versión del algoritmo `3 Sorts`. Usa las pruebas que escribiste en el Ejercicio 1 para validar la "Version Alpha". Luego, haz lo mismo para las versiones Beta, Gamma y Delta. Escribe cuáles son las versiones correctas (si alguna) de la función y porqué. Recuerda que, para cada función, algunas o todas las implementaciones pueden estar incorrectas. Además, especifica cuáles pruebas te permitieron determinar las versiones que son incorrectas.
+4. La "Versión Alpha" en la caja indica que estás corriendo la primera versión del algoritmo `3 Sorts`. Usa las pruebas que escribiste en el Ejercicio 1 para validar la "Version Alpha". Luego, haz lo mismo para las versiones Beta, Gamma y Delta. Escribe cuáles son las versiones correctas (si alguna) de la función y por qué. Recuerda que, para cada función, algunas o todas las implementaciones pueden estar incorrectas. Además, especifica cuáles pruebas te permitieron determinar las versiones que son incorrectas.
 
 
 
-### Ejercicio 3: Usar `assert` para realizar pruebas unitarias
+### Ejercicio 3 - Usar `assert` para realizar pruebas unitarias
 
-Hacer pruebas "a mano" cada vez que corres un programa es una tarea que resulta "cansona" bien rápido. En los ejercicios anteriores lo hiciste para unas pocas funciones simples. ¡Imagínate hacer lo mismo para un programa complejo completo como un navegador o un procesador de palabras!
+Hacer pruebas a mano cada vez que corres un programa es una tarea que puede resultar cansona bien rápido. En los ejercicios anteriores lo hiciste para unas pocas funciones simples. ¡Imagínate hacer lo mismo para un programa complejo como un navegador o un procesador de palabras!
 
 Las *pruebas unitarias* ayudan a los programadores a validar códigos y simplificar el proceso de depuración ("debugging"), a la vez que evitan la tediosa tarea de hacer pruebas a mano en cada ejecución.
 
 
 1. Utiliza "Entrega 1" en Moodle para entregar la tabla con las pruebas que diseñaste en el Ejercicio 1 y que completaste en el Ejercicio 2 con los resultados de las pruebas de las funciones.
 
-2. Utiliza "Entrega 2" en Moodle para entregar el archivo `main.cpp` que contiene las funciones `test_isALetter`, `test_isValidTime`, `test_gcd` y sus invocaciones. Recuerda utilizar buenas prácticas de programación, al incluir el nombre de los programadores y documentar tu programa.
+2. Utiliza "Entrega 2" en Moodle para entregar el archivo `main.cpp` que contiene las funciones `test_isALetter`, `test_isValidTime`, `test_gcd` y sus invocaciones. Recuerda utilizar buenas prácticas de programación, incluye el nombre de los programadores, y documenta tu programa.
 
 ---