GitHub ClassRoom: Instrucciones

Que es GitHub Classroom

GitHub Classroom is a GitHub service for education allowing teachers to distribute assignments with starter code.

• Students work on assignments individually or in groups using public or private GitHub repositories.
• Students gain access to assignments using unique invitation URLs.
• Teachers and teaching assistants can browse submissions by assignment.

Instrucciones para el Estudiante para las tareas asignadas via GitHub ClassRoom

• Por supuesto todos los estudiantes deben tener una cuenta en GitHub
• Para cada práctica el profesor les dará un enlace a GitHub Classroom: Students gain access to assignments using unique invitation URLs
• Los alumnos que acceden y aceptan el enlace dado por el profesor pasan a ser miembros de la organización de la asignatura (cuyo nombre en nuestro caso suele ser ULL-ESIT-ACRONIMOTITULACION-ACRONIMODELAASIGNATURA, por ejemplo ULL-ESIT-GRADOII-PL)
• Las tareas pueden ser individuales o de equipo
• En Algunas Tareas de Equipo (en la primera tarea en equipo esto ocurre siempre) un estudiante debe crear el equipo:
  • El primer alumno que accede al enlace dado por el profesor crea el equipo y le pone un nombre
    • El nombre del equipo debe ser formado con los nombres en orden alfabético y en camelCase de los miembros del equipo separados por guiones seguido del nombre del grupo de laboratorio: ana-juanMiguel-pedro-31L2.
  • Los siguientes miembros del equipo cuando acceden al enlace se unen al equipo creado por el primer alumno
  • Para cada equipo se crea dentro de la organización un repo asignatura-curso/nombredelatarea-nombredelequipo que los alumnos del equipo deberán usar para entregar la práctica
  • Si deseas tener mas privilegios sobre el repo puedes
    • Solicitarselos al profesor
    • Hacer un fork del repo a una cuenta de uno de los miembros del equipo y dar permisos de administración al resto de colaboradores del equipo. En tal caso asegurate de mezclar los cambios en el de la organización cuando hayas terminado
• En cada tarea classroom el profesor puede decidir reutilizar los equipos existentes o crear un nuevo conjunto de equipos
• Los equipos así formados son equipos de la organización de la asignatura
• Si por alguna razón no deseada deja de ser miembro de la organización de la asignatura,
  • solicítele al profesor que le invite a unirse a la organización.
  • Deberá aceptar la invitación visitando la página de la organización.
  • Una vez dentro, el profesor volverá a incorporarle al/los equipo(s)
• Si es miembro de la Organización GitHub y por alguna razón GitHub Classroom no le permite crear el repo de la asignación, puede crearlo manualmente como se describe en este vídeo

Instrucciones para el profesor

• GitHub Classroom Guide for Teachers by Jacob Fiksel
• Véase Teachers, manage your courses with Classroom for GitHub
• A step-by-step guide on setting up your GitHub Organization for classroom use
• Request free private repositories for your classroom organization
• Preparing for Year 2 of GitHub Classroom
• El formato para el classroom es el mismo que el de la organización de la asignatura seguido del curso. Por ejemplo:ULL-ESIT-GRADOII-PL-15-16
• La cantidad de emails que genera esta actividad es grande (issues, etc.) quiza una solución puede ser una cuenta github y una cuenta gmail por curso

Videos

Getting Started

How to set up individual assignments

How to set up group assignments