Create an individual assignment

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

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."

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."

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 de usuario 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 All students tab for the assignment. Para prevenir que los alumnos acepten o emitan una tarea, deselecciona Habilitar la URL de invitación a las tareas. Para editar la tarea, da clic en Editar tarea.

Individual 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

¿Te ayudó este documento?

Política de privacidad

¡Ayúdanos a hacer geniales estos documentos!

Todos los documentos de GitHub son de código abierto. ¿Notas algo que esté mal o que no sea claro? Emite una solicitud de cambios.

Haz una contribución

O, aprende cómo contribuir.