Acerca de las tareas individuales
Una tarea individual es parte del trabajo del curso para cada alumno que participe en uno de ellos dentro de GitHub Classroom. Se pretende que el alumno complete una tarea individual sin ayuda de otros alumnos.
Cuando un alumno acepta una tarea, GitHub Classroom crea automáticamente un repositorio nuevo para un alumno. Los repositorios pueden estar vacíos, o puedes crearlos desde un repositorio de plantilla con código, documentación y pruebas iniciales, así como con otros recursos. Cada repositorio de tarea pertenece a tu cuenta de organización en GitHub.
Cada tarea tiene un título y una fecha límite ocpional. Puedes escoger la visibilidad de los repositorios que GitHub Classroom crea, y elegir los permisos de acceso. También puedes calificar automáticamente las tareas y crear un espacio dedicado para debatirlas con el alumno.
Puedes reutilizar asignaciones existentes en cualquier otra aula a la que tengas acceso de administrador, incluidas las aulas de otra organización. Para obtener más información, vea «Reutilizar una asignación».
Requisitos previos
Debes crear un aula antes de que puedas crear una tarea. Para obtener más información, vea «Administrar aulas».
Crear una tarea
- Inicia sesión en GitHub Classroom.
- Navegar a un aula.
- En la pestaña Tareas, crea la tarea.
- Si esta es la primera asignación, haga clic en Crear una asignación.
- De lo contrario, haga clic en Nueva asignación en el lado derecho.
Configurar lo básico para una tarea
Nombra tu tarea, decide si quieres asignar una fecha límite y elige la visibilidad de los repositorios de la misma.
- Denominación de una asignación
- Asignación de una fecha límite para una asignación
- Elección de un tipo de asignación
- Elección de un tipo de visibilidad para los repositorios de asignación
Nombrar una tarea
Para una tarea individual, GitHub Classroom nombra los repositorios de acuerdo con su prefijo y con el nombre de usuario de GitHub del alumno. Predeterminadamente, el prefijo del repositorio es el título de la tarea. Por ejemplo, si asigna el nombre "assingment-1" a una asignación y el nombre de usuario del alumno en GitHub es @octocat, el nombre del repositorio de la asignación para @octocat será assignment-1-octocat
.
En "Título de la asignación", escriba un título para la asignación. Opcionalmente, da clic en para editar el prefijo.
Asignar una fecha límita para una tarea
Opcionalmente, puedes asignar una fecha límite para la tarea. Debajo de "Fecha límite (opcional)", da clic en el campo de texto y luego utiliza el selector de fechas para asignar una fecha límite.
Opcionalmente, para que la fecha de corte sea una fecha límite, seleccione Esta es una fecha de corte. Si usa una fecha de corte, los alumnos perderán el acceso de escritura a sus repositorios de asignaciones una vez superada a menos que reciban una extensión. Para obtener más información sobre cómo extender las fechas límite de asignación, consulte "Extensión de la fecha límite de una asignación para un individuo o grupo".
Elegir un tipo de tarea
En "Individual or group assignment", seleccione el menú desplegable y haga clic en Individual assignment. No puedes cambiar el tipo de tarea después de crearla. Si prefieres crear una asignación de grupo, consulta "Crear una tarea de grupo".
Elegir un tipo de visibilidad para los repositorios de la tarea
Los repositorios de una tarea pueden ser públicos o privados. Si utilizas repositorios privados, solo el alumno o equipo puede ver la retroalimentación que proporciones.
También puedes decidir si quieres otorgar a los alumnos permisos administrativos en el repositorio para una tarea. Otorga permisos administrativos si es que el alumno debe realizar tareas administrativas en el repositorio de tareas. Para obtener más información, vea «Acerca de los repositorios» y «Roles de repositorio para una organización».
Selecciona una visibilidad debajo de "Visibilidad del repositorio". Opcionalmente, seleccione Conceder a los alumnos acceso administrativo a su repositorio.
Cuando termine, haga clic en Continuar para configurar un código de inicio y un entorno de desarrollo para la tarea.
Agergar un código de inicio y configurar un ambiente de desarrollo
Opcionalmente, decide si quieres proporcionar repositorios vacíos o con código inicial, y preconfigura el ambiente de desarrollo para tus alumnos.
Elegir un repositorio de plantilla
Predeterminadamente, una tarea nueva creará un repositorio en blanco para cada alumno del registro de alumnos del aula. Opcionalmente, puedes elegir un repositorio de plantilla como un código de inicio para la tarea. Para obtener más información, vea «Crear una tarea desde un repositorio de plantilla».
Note
El repositorio de plantilla debe pertenecer a tu organización o ser un repositorio público en GitHub.
Debajo de "Agregar un repositorio de plantilla para dar a los alumnos un código inicial", selecciona el menú desplegable Seleccionar un repositorio y luego escribe la consulta de búsqueda. En la lista de resultados, da clic en el repositorio de plantilla que quieras utilizar para el código inicial.
Cuando termine, haga clic en Continuar para configurar las calificaciones automáticas y los comentarios del proyecto.
Elegir un ambiente de desarrollo integrado (IDE)
Opcionalmente, puedes configurar una tarea para utilizar un ambiente de desarrollo integrado (IDE). Los IDE permiten a los alumnos escribir código, ejecutar programas y colaborar sin instalar Git y contar con una cadena de herramientas de desarrollo integral en la computadora del alumno. Si eliges un IDE para una tarea, los alumnos aún pueden verificar y ejecutar el código localmente en una computadora con el software necesario. Para más información, consulta "Integrar a GitHub Classroom con un IDE".
Puedes optar por configurar una tarea con GitHub Codespaces para dar a los alumnos acceso a un entorno de Visual Studio Code basado en explorador con una configuración con un solo clic. Para obtener más información, vea «Uso de GitHub Codespaces con GitHub Classroom».
Para elegir un IDE para la tarea, selecciona el menú desplegable de "Agregar un editor" y haz clic en el IDE que te gustaría que utilizaran tus alumnos.
Proporcionar retroalimentación para una tarea
Opcionalmente, puedes calificar tareas automáticamente y crear un espacio para debatir cada entrega con el alumno.
- Prueba automática de las tareas
- Creación de una solicitud de incorporación de cambios para comentarios
Probar las tareas automáticamente
Puedes utilizar las calificaciones automáticas para verificar el trabajo de un alumno automáticamente para una tarea en GitHub Classroom. Configuras las pruebas para una tarea y estas se ejecutan automáticamente cada vez que un alumno realiza una inserción en un repositorio de tareas en GitHub.com. El alumno puede ver los resultados de la prueba, hacer cmabios y subir información para ver resultados nuevos. Para más información, consulta "Utiliza las calificaciones automáticas".
En "Agregar pruebas de calificación automática", seleccione el menú desplegable Agregar prueba y, después, haga clic en el método de calificación que quiera usar. Para más información, consulta "Utiliza las calificaciones automáticas".
Define los parámetros de tu caso de prueba, como el nombre, comandos, entradas, salidas, tiempo límite y puntos. Cuando haya terminado, haga clic en Guardar caso de prueba.
Puede agregar más pruebas con el menú desplegable Agregar prueba y puede editar o borrar las pruebas existentes con o .
Diseño de rutas de acceso de archivo protegidas
Si la asignación tiene archivos o directorios que se usan en el proceso de calificación o, de lo contrario, los alumnos no deben editarlos, puede designarlos como rutas de acceso de archivo protegidas. Si un alumno edita un archivo protegido, se aplicará una etiqueta a su envío en la página de información general de la asignación para que lo investigue. Para obtener más información, vea «Supervisar el progreso de los alumnos con la página de información general de las asignaciones».
Los patrones de las rutas de acceso protegidas siguen reglas similares a los globs de nombre de archivo de shell. Puede contener los siguientes metadatos:
*
: coincide con cualquier archivo. Por ejemplo,*
coincide con todos los archivos normales,foo*
coincide con todos los archivos que comienzan confoo
,*foo
coincide con todos los archivos que terminan confoo
y*foo*
coincide con todos los archivos cuyos nombres contienenfoo
(incluidos al principio o al final)**
: coincide con directorios recursivamente o archivos expansivamente. Por ejemplo,.github/**/*
coincidirá con todos los archivos de.github
y cualquiera de sus subdirectorios?
: coincide con cualquier carácter[set]
: coincide con cualquier carácter deset
(incluidos los conjuntos comoa-z
)\
: escapa al siguiente meta-carácter
Crear una solicitud de cambios para retroalimentación
Puedes crear una solicitud de cambios automáticamente en donde puedas proporcionar retroalimentación y responder las preguntas del alumno sobre una tarea. Para más información sobre la revisión de los cambios de una solicitud de incorporación de cambios, consulta "Revisión de cambios en las solicitudes de incorporación de cambios". Para más información sobre cómo dejar comentarios en una solicitud de incorporación de cambios, consulta "Deja retroalimentación con solicitudes de cambios".
A fin de crear solicitudes de incorporación de cambios para la explicación de los comentarios, seleccione Habilitar solicitudes de incorporación de cambios de comentarios.
Para crear la asignación, haga clic en Crear asignación.
Invitar a los alumnos a una tarea
Predeterminadamente, GitHub Classroom habilita una URL de invitación para cada tarea que crees. Los alumnos pueden aceptar y emitir la tarea mientras que se habilita la URL de invitación. Puedes compartir la URL con tus alumnos en tu LMS, página principal del curso, o donde sea que publiques las tareas. Los alumnos también pueden navegar a la tarea en GitHub Classroom si ya la aceptaron en el aula.
Warning
Ten cuidado de dónde compartes las direcciones URL de invitación. Cualquiera con una URL de invitación para una tarea puede aceptar dicha invitación y asociar una cuenta personal en GitHub con un identificador en tu lista de participantes.
Puede ver si un alumno se ha unido a la clase y ha aceptado o enviado una asignación en la pestaña Classroom roster para la asignación. También puede vincular los alias de GitHub de los alumnos a sus listas de identificadores asociadas y viceversa en esta pestaña. Para prevenir que los alumnos acepten o envíen una tarea, puedes cambiar el "Estado de la tarea" dentro de la vista de "Editar tarea". Cuando una tarea se encuentra activa, los alumnos podrán aceptarla utilizando el enlace de invitación. Cuando está inactiva, este enlace ya no será válido.
Monitorear el progreso de los alumnos
La página de vista general de la tarea te proporciona una vista general de las aceptaciones de tu tarea y del progreso de los alumnos. Para obtener más información sobre cómo ver y usar la página de información general de las asignaciones, consulta "Supervisar el progreso de los alumnos con la página de información general de las asignaciones".
Pasos siguientes
-
Después de que creas la tarea, los alumnos pueden comenzar a trabajar en ella utilizando las características de Git y GitHub. Los alumnos pueden clonar el repositorio, subir confirmaciones, administrar ramas, crear y revisar solicitudes de cambio, tratar los confluctos de fusión y debatir los cambios con propuestas. Tanto tú como el alumno pueden revisar el historial de confirmaciones del repositorio. Para más información, consulta "Documentación sobre la introducción a GitHub," "Documentación de repositorios" y "Colaborar con con las solicitudes de cambios".
-
Cuando un alumno termina una tarea, puedes revisar los archivos en el repositorio, o puedes revisar el historial y las visualizaciones del repositorio para entender mejor su trabajo. Para obtener más información, vea «Ver la actividad y los datos de tu repositorio».
-
Puedes proporcionar retroalimentación para una tarea si comentas en confirmaciones o líneas individuales dentro de una solicitud de cambios. Para obtener más información, vea «Comentar en una solicitud de extracción» y «Crear una propuesta». Para más información sobre cómo crear respuestas guardadas para proporcionar comentarios sobre errores comunes, consulta "Acerca de las respuestas guardadas".