Crear una tarea de grupo

Acerca de las tareas de grupo

Una tarea grupal es un trabajo de curso colaborativo para los grupos de alumnos en GitHub Classroom. Los alumnos pueden trabajar en conjunto en las tareas de grupo dentro de un repositorio compartido, como un equipo de desarrolladores profesionales.

Cuando un alumno acepta una tarea grupal, los alumnos pueden crear un equipo nuevo o unirse a uno existente. GitHub Classroom guarda los equipos para una tarea como un conjunto. Puedes nombrar el conjunto de equipos para una tarea específica cuando creas dicha tarea y puedes reutilizar ese conjunto de equipos para una tarea más grande.

Para cada tarea grupal, GitHub Classroom creará automáticamente un repositorio único compartido para que ingrese el equipo. El repositorio puede estar vacío, o puedes crearlo desde un repositorio de plantilla con código inicial, documentación, pruebas y otros recursos. El repositorio pertenece a tu cuenta de organización en GitHub, y GitHub Classroom le otorga acceso a los equipos que los alumnos crean o a los cuales se unen cuando aceptan la tarea.

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 decidir cuántos equipos puede tener una tarea y cuántos miembros puede tener cada equipo. Cada equipo que crea un alumno para una tarea constituye un equipo dentro de tu organización en GitHub. La visibilidad del equipo es secreta. Los equipos que crees en GitHub no aparecerán en GitHub Classroom. Para obtener más información, vea «Acerca de los equipos».

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

1. Inicia sesión en GitHub Classroom.
2. Navegar a un aula.
3. 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 quires asignarle una fecha límite, definir equipos o elegir 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
• Definición de equipos para una asignación
• Elección de un tipo de visibilidad para los repositorios de asignación

Nombrar una tarea

En las tareas grupales, GitHub Classroom nombra a los repositorios de acuerdo con el prefijo de los mismos y el nombre del equipo. 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 del equipo en GitHub es "student-team", el nombre del repositorio de la asignación para los miembros del equipo será assignment-1-student-team.

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" (Asignación individual o de grupo), seleccione el menú desplegable y haga clic en Group assignment (Asignación de grupo). No puedes cambiar el tipo de tarea después de crearla. Si prefieres crear una asignación individual, consulta "Crear una tarea individual".

Definir los equipos para una tarea

Si ya creaste una tarea grupal para el aula, puedes reutilizar un conjunto de equipos para la tarea nueva. Para crear un conjunto nuevo con los equipos que crean tus alumnos para la tarea, teclea el nombre de dicho conjunto. Opcionalmente, teclea la cantidad máxima de miembros de los equipos y el total de los equipos.

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.

• Elección de un repositorio de plantilla
• Elección de un entorno de desarrollo integrado (IDE)

Elegir un repositorio de plantilla

Predeterminadamente, una tarea nueva creará un repositorio en blanco para cada equipo que cree el alumno. 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».

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.

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.

Cuando termine, haga clic en Continuar para configurar las calificaciones automáticas y los comentarios del proyecto.

Comentarios

Opcionalmente, puedes calificar tareas automáticamente y crear un espacio para debatir cada entrega con el equipo.

• 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 con foo, *foo coincide con todos los archivos que terminan con foo y *foo* coincide con todos los archivos cuyos nombres contienen foo (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 de set (incluidos los conjuntos como a-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.

Puede ver los equipos que han enviado una asignación o que están trabajando en ella en la pestaña Teams (Equipos) de dicha asignación. 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 una tarea y de que tus alumnos forme equipos, los miembros de dichos equipos pueden comenzar a trabajar en la tarea utilizando las características de Git y de 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 equipo 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," "Utilizar GitHub" y "Colaborar con con las solicitudes de cambios", y el curso gratuito sobre resolución de conflictos de combinación en GitHub Skills.

• Cuando un equipo termina una tarea, puedes revisar los archivos en el repositorio, o puedes revisar el historial y visualizaciones del mismo para entender mejor cómo colaboró el equipo. 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".

Información adicional

• «GitHub Education para profesores»
• "Conexión de un curso de un sistema de administración del aprendizaje a una clase"
• "Uso de GitHub Classroom con GitHub CLI"