8.0 KiB
title, intro, versions, permissions, redirect_from, shortTitle
| title | intro | versions | permissions | redirect_from | shortTitle | ||||
|---|---|---|---|---|---|---|---|---|---|
| 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. {% data reusables.classroom.classroom-admins-link %} |
|
Individual assignment |
About individual assignments
{% data reusables.classroom.assignments-individual-definition %}
{% data reusables.classroom.classroom-creates-individual-repositories %}
{% data reusables.classroom.about-assignments %}
For a video demonstration of the creation of an individual assignment, see "Basics of setting up {% data variables.product.prodname_classroom %}."
{% data reusables.classroom.reuse-assignment-link %}
Prerequisites
{% data reusables.classroom.assignments-classroom-prerequisite %}
Creating an assignment
{% data reusables.classroom.assignments-guide-create-the-assignment %}
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
- Assigning a deadline for an assignment
- Choosing an assignment type
- Choosing a visibility for assignment repositories
Naming an assignment
For an individual assignment, {% data variables.product.prodname_classroom %} names repositories by the repository prefix and the student's {% data variables.product.product_name %} 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 {% data variables.product.product_name %} is @octocat, the name of the assignment repository for @octocat will be assignment-1-octocat.
{% data reusables.classroom.assignments-type-a-title %}
Assigning a deadline for an assignment
{% data reusables.classroom.assignments-guide-assign-a-deadline %}
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
{% data reusables.classroom.assignments-guide-choose-visibility %}
{% data reusables.classroom.assignments-guide-click-continue-after-basics %}
Adding starter code and configuring a development environment
{% data reusables.classroom.assignments-guide-intro-for-environment %}
Choosing a template repository
By default, a new assignment will create an empty repository for each student on the roster for the classroom. {% data reusables.classroom.you-can-choose-a-template-repository %}
{% data reusables.classroom.assignments-guide-choose-template-repository %}
{% data reusables.classroom.assignments-guide-click-continue-after-starter-code-and-feedback %}
Choosing an integrated development environment (IDE)
{% data reusables.classroom.about-online-ides %} For more information, see "Integrate {% data variables.product.prodname_classroom %} with an IDE."
{% data reusables.classroom.classroom-codespaces-link %}
{% data reusables.classroom.assignments-guide-choose-an-online-ide %}
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
{% data reusables.classroom.assignments-guide-using-autograding %}
Creating a pull request for feedback
{% data reusables.classroom.you-can-create-a-pull-request-for-feedback %}
{% data reusables.classroom.assignments-guide-create-review-pull-request %}
{% data reusables.classroom.assignments-guide-click-create-assignment-button %}
Inviting students to an assignment
{% data reusables.classroom.assignments-guide-invite-students-to-assignment %}
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' {% data variables.product.prodname_dotcom %} aliases to their associated roster identifier and vice versa in this tab. {% data reusables.classroom.assignments-to-prevent-submission %}
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 {% data variables.product.prodname_dotcom %} 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 {% data variables.product.product_name %}'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 {% data variables.product.prodname_dotcom %}," "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."