Merge pull request #45 from CodeToCommunicate/mdpiper/add-homework-and-quizzes

Add homework and quizzes to lessons 1 and 2

Author: mdpiper

01_setup_coding_environment.md renamed to 01_coding_environment.md

@@ -397,6 +397,30 @@ medida que avanzamos en CoCo.
 Al final, podrá usar estas herramientas en su investigación y permanecerán en
 su computadora mucho después de la última lección de CoCo.
 
+# Homework | Tarea
+
+After completing this lesson, please try to install
+
+- Anaconda,
+- Git for Windows (Windows only), and
+- VS Code
+
+on your computer using the information above.
+
+If you have any question about this, please write in the Slack.
+
+---
+
+Después de completar esta lección, intente instalar
+
+- Anaconda,
+- Git para Windows (solo Windows) y
+- Código VS
+
+en su computadora utilizando la información anterior.
+
+Si tiene alguna pregunta sobre esto, por favor escriba en Slack.
+
 <!-- Links, by alpha -->
 
 [badge]: https://img.shields.io/badge/CSDMS-JupyterHub-orange.svg

02_shell.md

@@ -31,8 +31,8 @@ with the operating system of a computer.
 
 ---
 
-Aquí, aprenderemos sobre el _shell_, que es una interfaz basada en comandos para
-interactuar con el sistema operativo de una computadora.
+Aquí, aprenderemos sobre el _shell_, que es una interfaz basada en comandos
+para interactuar con el sistema operativo de una computadora.
 
 ## Open a terminal | Abrir una terminal
 
@@ -72,13 +72,14 @@ if you want to change from one application to another, it's much faster to hit
 to go find the other application window.
 
 Commands tend to be terse to the point of being cryptic, not that different
-from texting shorthand: instead of brb or ttyl, it's `cd` (change directory) or `rm` (remove).
-And it's done for the same reason: speed.
-
-Commands can also be gathered into _scripts_ that can be executed as a single unit.
-With a script, you can automate a repetitive task.
-Scripts are marvelous for data processing pipelines, and can improve reproducibility.
-We won't cover scripting here, but there's more information in Software Carpentry's
+from texting shorthand: instead of brb or ttyl, it's `cd` (change directory) or
+`rm` (remove). And it's done for the same reason: speed.
+
+Commands can also be gathered into _scripts_ that can be executed as a single
+unit. With a script, you can automate a repetitive task.
+Scripts are marvelous for data processing pipelines, and can improve
+reproducibility. We won't cover scripting here, but there's more information in
+Software Carpentry's
 [The Unix Shell](https://swcarpentry.github.io/shell-novice/) lesson, on which
 this lesson is based.
 
@@ -87,17 +88,18 @@ this lesson is based.
 Porque funciona realmente bien.
 
 Cuando utilizas los comandos de shell en una terminal, puedes realizar tareas
-específicas del sistema de archivos (mover, copiar, renombrar, eliminar archivos
-y directorios) mucho más rápido y eficientemente que con una aplicación gráfica.
+específicas del sistema de archivos (mover, copiar, renombrar, eliminar
+archivos y directorios) mucho más rápido y eficientemente que con una
+aplicación gráfica.
 
 Por analogía, piensa en los atajos de teclado en su computadora:
 si desea cambiar de una aplicación a otra, es mucho más rápido presionar
-`Cmd-Tab` (en macOS; `Alt-Tab` en Linux y Windows) que usar un mouse para buscar
-la ventana de la otra aplicación.
+`Cmd-Tab` (en macOS; `Alt-Tab` en Linux y Windows) que usar un mouse para
+buscar la ventana de la otra aplicación.
 
 Los comandos tienden a ser concisos hasta el punto de ser crípticos, no tan
-diferentes de los mensajes de texto abreviados: en lugar de tkm (te quiero mucho)
-o tmb (también), es `cd` (cambiar de directorio) o `rm` (remover).
+diferentes de los mensajes de texto abreviados: en lugar de tkm (te quiero
+mucho) o tmb (también), es `cd` (cambiar de directorio) o `rm` (remover).
 Y se hace por la misma razón: la velocidad.
 
 Los comandos también se pueden agrupar en _scripts_ que se pueden ejecutar como
@@ -144,7 +146,8 @@ Este proceso se repite cada vez que ingresamos un comando.
 Information on a computer is stored in files and directories.
 The part of an operating system that handles this information is called the
 _filesystem_.
-Think of the filesystem as a tree with branches (directories) and leaves (files).
+Think of the filesystem as a tree with branches (directories) and leaves
+(files).
 
 Let's find out where we are in the filesystem when we start a terminal:
 
@@ -153,18 +156,20 @@ Let's find out where we are in the filesystem when we start a terminal:
 La información en una computadora se almacena en archivos y directorios.
 La parte del sistema operativo que maneja esta información se llama
 _sistema de archivos_ (filesystem).
-Piense en el sistema de archivos como un árbol con ramas (directorios) y hojas (archivos).
+Piense en el sistema de archivos como un árbol con ramas (directorios) y hojas
+(archivos).
 
-Averigüemos dónde estamos en el sistema de archivos cuando iniciamos una terminal:
+Averigüemos dónde estamos en el sistema de archivos cuando iniciamos una
+terminal:
 
 ```
 $ pwd
 /home/jupyter-mpiper
 ```
 
 The `pwd` command prints the current directory to the terminal.
-You can see that I'm in the directory `jupyter-mpiper` under the directory `home`.
-The forward slash `/` is used as a delimiter between directory names.
+You can see that I'm in the directory `jupyter-mpiper` under the directory
+`home`. The forward slash `/` is used as a delimiter between directory names.
 
 This directory, `/home/jupyter-mpiper`, is special--it's the _home directory_
 for the user `jupyter-mpiper`.
@@ -176,14 +181,15 @@ the home directory on a macOS or Windows machine will be slightly different.
 
 ---
 
-El comando `pwd` imprime en la terminal el directorio donde se encuentra actualmente.
-Puedes ver que estamos en el directorio `jupyter-mpiper` debajo del directorio `home`.
-La barra inclinada `/` se utiliza como delimitador entre los nombres de los directorios.
+El comando `pwd` imprime en la terminal el directorio donde se encuentra
+actualmente. Puedes ver que estamos en el directorio `jupyter-mpiper` debajo
+del directorio `home`. La barra inclinada `/` se utiliza como delimitador entre
+los nombres de los directorios.
 
 Este directorio `/home/jupyter-mpiper` es especial. Éste es la
 _carpeta de usuario_ para el usuario `jupyter-mpiper`.
-Cada usuario tiene una _carpeta de usuario_ propia, que es la ubicación predeterminada
-para crear y almacenar información.
+Cada usuario tiene una _carpeta de usuario_ propia, que es la ubicación
+predeterminada para crear y almacenar información.
 
 Tenga en cuenta que en este caso se ejecuta este comando en JupyterHub,
 que ejecuta Linux; la carpeta de usuario en una máquina macOS o Windows será
@@ -219,30 +225,36 @@ Por ejemplo, para ver el contenido del directorio **CoCoLessons**, escriba:
 
 ```
 $ ls CoCoLessons
-data                          coco_3_matplotlib.ipynb          CONTRIBUTING.md   README.md
-media                         coco_4_functions_and_more.ipynb  CREDITS.md
-coco_1_coding_environment.md  coco_5_pandas.ipynb              environment.yaml
-coco_2_python_basics.ipynb    CODE-OF-CONDUCT.md               LICENSE.md
+01_coding_environment.md       CONTRIBUTING.md
+02_shell.md                    CREDITS.md
+03_git_part_1.md               LICENSE
+04_intro_to_python_numpy.ipynb README.md
+05_matplotlib.ipynb            data
+06_loops_if_functions.ipynb    environment.yml
+07_pandas.ipynb                media
+CODE-OF-CONDUCT.md
 ```
 
-You can see the CoCo lesson files that have been added to the JupyterHub.
-We can drill further; for example, to see into the directory containing data files:
+You can see the CoCo lesson files that have been added to the JupyterHub. We
+can drill further; for example, to see into the directory containing data
+files:
 
 ---
 
 Puede ver los archivos de las lecciones de CoCo se agregaron a JupyterHub.
-Podemos indagar más; por ejemplo, para ver el contenido del directorio llamado `data`:
+Podemos indagar más; por ejemplo, para ver el contenido del directorio llamado
+`data`:
 
 ```
-$ ls CoCoLessons/data
-RPC_4_lithologies_Messy.csv  south-africa-topography.nc.xz  temperature-central-park.dat
-hawaii-profile.csv           temperature-berkeley.dat       winemag-data-130k-v2.csv
+$ ls CoCoLessons/data RPC_4_lithologies_Messy.csv
+south-africa-topography.nc.xz  temperature-central-park.dat hawaii-profile.csv
+temperature-berkeley.dat       winemag-data-130k-v2.csv
 ```
 
 ## Changing directories | Cambiando directorios
 
-Although we've peered into the directory of sample files, we remain in the home directory.
-To change directories, use the `cd` command:
+Although we've peered into the directory of sample files, we remain in the home
+directory. To change directories, use the `cd` command:
 
 ---
 
@@ -283,21 +295,22 @@ To switch to the previous directory, use a dash `-`:
 
 Sin argumentos, `cd` siempre regresa a su carpeta de usuario.
 
-El comando `cd` también puede tomar un conjunto de caracteres especiales como argumentos.
-Para cambiar al directorio anterior, use un guión `-`:
+El comando `cd` también puede tomar un conjunto de caracteres especiales como
+argumentos. Para cambiar al directorio anterior, use un guión `-`:
 
 ```
 $ cd -
 /home/jupyter-mpiper/CoCoLessons
 ```
 
-When working with directories, a dot `.` is a shortcut for the current directory,
-while two dots `..` are a shortcut for the parent directory:
+When working with directories, a dot `.` is a shortcut for the current
+directory, while two dots `..` are a shortcut for the parent directory:
 
 ---
 
 Cuando se trabaja con directorios, un punto `.` es un atajo para el directorio
-actual, mientras que dos puntos `..` son un atajo para el directorio-padre (_parent directory_):
+actual, mientras que dos puntos `..` son un atajo para el directorio-padre
+(_parent directory_):
 
 ```
 $ cd .
@@ -320,19 +333,46 @@ $ pwd
 /home/jupyter-mpiper
 ```
 
+### Formative assessment 1
+
+If your current directory is the **CoCoLessons** directory,
+how can you get a directory listing for the **data** subdirectory?
+
+1. `ls data`
+1. `ls ./data`
+1. `ls ../CoCoLessons/data`
+1. `ls ~/CoCoLessons/data`
+1. All of the above
+
+Can you explain your answer?
+
+---
+
+Si su directorio actual es el directorio **CoCoLessons**,
+¿Cómo puede obtener una lista de directorios para el subdirectorio **datos**?
+
+1. `ls datos`
+1. `ls./datos`
+1. `ls ../CoCoLessons/datos`
+1. `ls ~/CoCoLessons/datos`
+1. Todo lo anterior
+
+¿Puedes explicar tu respuesta?
+
 ## Making a directory | Crear un directorio
 
 From your home directory, use the `mkdir` command to make a new directory:
 
 ---
 
-Desde tu carpeta de usuario, usa el comando `mkdir` para crear un nuevo directorio:
+Desde tu carpeta de usuario, usa el comando `mkdir` para crear un nuevo
+directorio:
 
 ```
 $ mkdir new
 $ ls
-CoCoLessons  bin          bmi-topography  espin  projects  tmp
-README.md    bmi-geotiff  data            new    scratch
+CoCoLessons bin bmi-topography espin projects tmp
+README.md bmi-geotiff data new scratch
 ```
 
 Change to the new directory and get a listing:
@@ -373,8 +413,9 @@ Note that the copy and the original both exist, and are the same:
 ---
 
 Aquí, le indicamos al comando `cp` que subiera un directorio y fuera al
-directorio **CoCoLessons** para obtener un archivo y copiarlo en el directorio actual.
-Tenga en cuenta que la copia y el original existen y tiene el mismo contenido:
+directorio **CoCoLessons** para obtener un archivo y copiarlo en el directorio
+actual. Tenga en cuenta que la copia y el original existen y tiene el mismo
+contenido:
 
 ```
 $ $ diff -s README.md ../CoCoLessons/README.md
@@ -402,15 +443,15 @@ Let's move **readme.md** up to the home directory:
 
 ---
 
-El comando `mv` también se puede usar para mover un archivo de una ubicación a otra.
-Movamos **readme.md** hasta la carpeta de usuario:
+El comando `mv` también se puede usar para mover un archivo de una ubicación a
+otra. Movamos **readme.md** hasta la carpeta de usuario:
 
 ```
 $ mv readme.md ~
 $ ls
 $ ls ~
-CoCoLessons  bin          bmi-topography  espin  projects   scratch
-README.md    bmi-geotiff  data            new    readme.md  tmp
+CoCoLessons bin bmi-topography espin projects scratch
+README.md bmi-geotiff data new readme.md tmp
 ```
 
 Note that the **new** directory is now empty because **readme.md** has been
@@ -428,7 +469,8 @@ Ten en cuenta que el directorio **new** ahora está vacío porque **readme.md**
 se ha movido a la carpeta de usuario.
 ¡También ten en cuenta que **README.md** y **readme.md** en la carpeta de
 usuario son archivos diferentes!
-Los sistemas de archivos en Linux y macOS distinguen entre mayúsculas y minúsculas.
+Los sistemas de archivos en Linux y macOS distinguen entre mayúsculas y
+minúsculas.
 
 Los archivos se pueden eliminar con el comando `rm`.
 Elimina nuestro archivo **readme.md** con:
@@ -446,6 +488,18 @@ Once a file is removed, it's gone, irrevocably.
 No existe el concepto de "papelera" o "papelera de reciclaje" en el shell.
 Una vez que se elimina un archivo, desaparece irrevocablemente.
 
+### Formative assessment 2
+
+The **data** subdirectory of the **CoCoLessons** directory
+contains several files.
+Can you think of a way to copy all the files in a directory?
+
+---
+
+El subdirectorio **data** del directorio **CoCoLessons** contiene varios
+archivos. ¿Puedes pensar en una manera de copiar todos los archivos en un
+directorio?
+
 ## Removing a directory | Eliminar un directorio
 
 As a last step, let's delete the **new** directory:
@@ -457,8 +511,8 @@ Como último paso, eliminemos el directorio **new**:
 ```
 $ rmdir new
 $ ls
-CoCoLessons  bin          bmi-topography  espin     scratch
-README.md    bmi-geotiff  data            projects  tmp
+CoCoLessons bin bmi-topography espin scratch
+README.md bmi-geotiff data projects tmp
 ```
 
 As `rm` removes files, the `rmdir` command removes directories.
@@ -469,13 +523,28 @@ However, the directory must be empty before it can be removed.
 Como `rm` elimina archivos, el comando `rmdir` elimina directorios.
 Sin embargo, el directorio debe estar vacío antes de poder eliminarlo.
 
+### Formative assessment 3
+
+Given that directory must be empty before it can be removed,
+can you think of a way to remove all the files in a directory?
+Alternately, is there a way to remove a directory even if it contains files?
+
+---
+
+Dado que el directorio debe estar vacío antes de poder eliminarlo,
+¿Se te ocurre alguna forma de eliminar todos los archivos de un directorio?
+Alternativamente, ¿hay alguna forma de eliminar un directorio incluso si
+contiene archivos?
+
 ## Summary | Resumen
 
-The table below summarizes the commands and special characters described in this lesson.
+The table below summarizes the commands and special characters described in
+this lesson.
 
 ---
 
-La siguiente tabla resume los comandos y caracteres especiales descritos en esta lección.
+La siguiente tabla resume los comandos y caracteres especiales descritos en
+esta lección.
 
 | Command/Comando | Description / Descripción                                                 |
 | --------------- | ------------------------------------------------------------------------- |
@@ -533,3 +602,4 @@ Estas son herramientas que usaremos en todo CoCo,
 ¡así que el trabajo que haces ahora valdrá la pena más tarde!
 
 <!-- Links, by alpha -->
+```