Skip to main content

Create an individual assignment

You can create an assignment for students in your course to complete individually.

Organization owners who are admins for a classroom can create and manage individual assignments for a classroom. Para obtener más información sobre los administradores de las aulas, consulta la sección "Acerca de la administración de aulas".

About individual assignments

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.

For a video demonstration of the creation of an individual assignment, see "Basics of setting up GitHub Classroom."

You can reuse an existing assignment in any other classroom you have admin access to, including classrooms in a different organization. Para obtener más información, consulta la sección "Reutilizar una tarea".

Prerequisites

Debes crear un aula antes de que puedas crear una tarea. Para obtener más información, consulta la sección "Administrar las aulas".

Creating an assignment

  1. Inicia sesión en GitHub Classroom.
  2. Navegar a un aula.
  3. Crea la tarea en la pestaña de Tareas.
    • Si esta es tu primer tarea, haz clic en Crear una tarea. Crear tu primera tarea
    • De lo contrario, haz clic en Tarea nueva. En el botón de 'Tarea nueva'

Setting up the basics for an assignment

Name your assignment, decide whether to assign a deadline, and choose the visibility of assignment repositories.

Naming an assignment

For an individual assignment, GitHub Classroom names repositories by the repository prefix and the student's GitHub username. By default, the repository prefix is the assignment title. For example, if you name an assignment "assignment-1" and the student's username on GitHub is @octocat, the name of the assignment repository for @octocat will be assignment-1-octocat.

Teclea un título para la tarea. Opcionalmente, da clic en para editar el prefijo.

Título y prefijo de la tarea

Assigning a deadline for an assignment

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.

Selector de fechas para la fecha límite de la tarea

Choosing an assignment type

Under "Individual or group assignment", select the drop-down menu, and click Individual assignment. You can't change the assignment type after you create the assignment. If you'd rather create a group assignment, see "Create a group assignment."

Choosing a visibility for assignment repositories

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, consulta las secciones "Acerca de los repositorios" y "Roles de los repositorios en una organización".

Selecciona una visibilidad debajo de "Visibilidad del repositorio". Opcionalmente, selecciona Otorgar a los alumnos acceso administrativo para el repositorio.

Opciones de visibilidad para los repositorios de tareas

Cuando termines, da clic en Continuar para configurar un código de inicio y un ambiente de desarrollo para la tarea.

Botón 'Continuar'

Adding starter code and configuring a development environment

Opcionalmente, decide si quieres proporcionar repositorios vacíos o con código inicial, y preconfigura el ambiente de desarrollo para tus alumnos.

Choosing a template repository

By default, a new assignment will create an empty repository for each student on the roster for the classroom. Opcionalmente, puedes elegir un repositorio de plantilla como un código de inicio para la tarea. Para obtener más información sobre los repositorios de plantilla, consulta la sección "Crear un repositorio de plantilla".

Nota: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 teclea 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.

Utilizar el menú desplegable de 'Seleccionar un repositorio' para encontrar un repositorio de plantilla para utilizar como código inicial para una tarea

Cuando termines, da clic en Continuar para configurar las calificaciones automáticas y la retroalimentación del proyecto.

Botón 'Continuar'

Choosing an integrated development environment (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. For more information, see "Integrate GitHub Classroom with an IDE."

You can choose to configure an assignment with Acerca de GitHub Codespaces to give students access to a browser-based Visual Studio Code environment with one-click setup. Para obtener más información, consulta "Usar Acerca 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.

Utilizar el menú desplegable de 'Seleccionar un IDE en línea' para dar clic en un IDE en línea para la tarea

Providing feedback for an assignment

Optionally, you can automatically grade assignments and create a space for discussing each submission with the student.

Testing assignments automatically

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 éstas se ejecutan automáticamente cada que un alumno las suba a 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 obtener más información, consulta la sección "Utilizar las calificaciones automáticas".

Debajo de "Agregar pruebas que se califiquen automáticamente", selecciona el menú desplegable de Agregar prueba, y luego da clic enel método para calificar que quieras utilizar. Para obtener más información, consulta la sección "Métodos para calificar".

Utilizar el menú desplegable de 'Agregar prueba' para dar clic en un método para calificar

Define los parámetros de tu caso de prueba, como el nombre, comandos, entradas, salidas, tiempo límite y puntos. Cuando termines, da clic en Guardar caso de prueba.

Botón de 'Guardar caso de prueba' para una prueba de calificación automática

Puedes agregar más pruebas con el menú desplegable de Agregar prueba, y puedes editar o borrar las pruebas existentes con o con .

Iconos de lápiz y de cesto de basura para editar o borrar una prueba de calificación automática

Creating a pull request for feedback

Puedes crear una solicitud de cambios automáticamente en donde puedas proporcionar retroalimentación y responder las preguntas del alumno sobre una tarea. Para obtener más información acerca de la revisión de cambios en una solicitud de cambios, consulta la sección "Revisar los cambios en las solicitudes de cambios".

Para crear solicitudes de cambio para el debate de retroalimentación, selecciona Habilitar las solicitudes de cambios de retroalimentación.

Casilla de verificación para 'Habilitar solicitudes de cambios de retroalimentación'

Para crear una tarea, da clic en Crear tarea.

Botón de 'crear tarea'

Inviting students to an assignment

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.

Advertencia: Ten cuidado de dónde compartes las 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 registro de alumnos.

You can see whether a student has joined the classroom and accepted or submitted an assignment in the Classroom roster tab for the assignment. You can also link students' GitHub aliases to their associated roster identifier and vice versa in this tab. 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.

Individual assignment

Monitoring students' progress

The assignment overview page provides an overview of your assignment acceptances and student progress. You may have different summary information based on the configurations of your assignments.

  • Rostered students: The number of students on the Classroom's roster.
  • Added students: The number of GitHub accounts that have accepted the assignment and are not associated with a roster identifier.
  • Accepted students: The number of accounts have accepted this assignment.
  • Assignment submissions: The number of students that have submitted the assignment. Submission is triggered at the assignment deadline.
  • Passing students: The number of students currently passing the autograding tests for this assignment.

Next steps

  • Once you create the assignment, students can start work on the assignment using Git and GitHub's features. Students can clone the repository, push commits, manage branches, create and review pull requests, address merge conflicts, and discuss changes with issues. Both you and student can review the commit history for the repository. For more information, see "Getting started with GitHub," "Repositories," and "Collaborating with issues and pull requests."

  • When a student finishes an assignment, you can review the files in the repository, or you can review the history and visualizations for the repository to better understand the student's work. For more information, see "Visualizing repository data with graphs."

  • You can provide feedback for an assignment by commenting on individual commits or lines in a pull request. For more information, see "Commenting on a pull request" and "Opening an issue from code." For more information about creating saved replies to provide feedback for common errors, see "About saved replies."

Further reading