Episodio 3

Ejercicios en {learnr}

En los tutoriales un chunk de código puede transformarse en un ejercicio. Los ejercicios presentarán al estudiante un espacio para escribir código, ejecutarlo y recibir una respuesta. Este espacio puede estar vacio o puede tener código previo incompleto, para que el estudiante lo complete con la solución correcta. Además hay ejercicios que pueden presentar pistas y/o la solución.

Ejercicio vacio

Para generar un ejercicio simple, sin código, se agrega el parámetro exercice = TRUE al chunk de R:

```{r dos-mas-dos, exercise=TRUE}

```

Cuando compilamos el documento en el lugar del chunk de ejercicio se presenta una “caja” donde se puede escribir código y el botón Run Code (ejecutar código), presionándolo, se ejecuta el código escrito presentando el resultado correspondiente (sea una salida o un mensaje).

Ejercicio con código previo, consejos y solución

Los chunks de ejercicios pueden contener código para completar, como una plantilla, para ayudar al estudiante a resolver la ejercitación o para concentrarse sólo en el tema o característica que estamos enseñando.

```{r funcion-sumar, exercise=TRUE, exercise.lines = 5}
sumar <- function(___,___) {
  ______
}

sumar(___,___)
```

Si se quiere dar algunas pistas para ayudar a los estudiantes en la resolución de los ejercicios, especialmente si conocemos que el tema que estamos enseñando tiene errores de compresión comunes, podemos hacerlo generando un nuevo chunk de R con el mismo nombre que el chunk del ejercicio al que le agregamos la palabra -hint.

```{r funcion-sumar-hint}
sumar <- function(___,___) {
  # Aqui debe ir el calculo sumando los dos parámetros 
  # que debe tener la función para recibir los dos números a sumar
}

sumar(___,___)
```

También podemos proveer la solución esperada, especialmente porque los problemas de programación pueden tener más de una solución válida. Para ello generamos un nuevo chunk de R, con el mismo nombre del ejercicio y le agregamos la palabra -solution.

```{r funcion-sumar-solution}
sumar <- function(numero1,numero2) {
  numero1+numero2
}

sumar(5,3)
```

Cuando escriban estos chunks en RStudio, se van a marcar errores en las secciones donde el código está incompleto, esto se ignora cuando se compila el documento gracias al atributo exercice=TRUE del primer chunk.

Ejercicio: 10 minutos!!!

• Sobre el tutorial que crearon en el ejercicio anterior:
• Revisen los ejercicios propuestos y modifiquen:
  • El primer ejercicio para que incluya una pista (hint) y la solución (solution).
  • El segundo ejercicio para que incluya código y secciones a completar.
• Recuerden compilar el documento para ver los cambios y el funcionamiento de la solución.