diff --git a/content/education/guides.md b/content/education/guides.md index 7ae84dc4c987..d8ee2e435f97 100644 --- a/content/education/guides.md +++ b/content/education/guides.md @@ -23,6 +23,7 @@ Administer a classroom, assign and review work from your students, and teach the - [About {% data variables.product.prodname_global_campus %} for teachers](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/about-github-global-campus-for-teachers) - [Manage classrooms](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/manage-classrooms) +- [About assignments](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/about-assignments) - [Use the Git and {% data variables.product.company_short %} starter assignment](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/use-the-git-and-github-starter-assignment) - [Create an individual assignment](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-an-individual-assignment) - [Create a group assignment](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-a-group-assignment) diff --git a/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/about-github-classroom.md b/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/about-github-classroom.md index 3d36ba9349fd..e31a7eb5b876 100644 --- a/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/about-github-classroom.md +++ b/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/about-github-classroom.md @@ -30,11 +30,11 @@ Optionally, you can connect a learning management system (LMS) to {% data variab ### Feedback pull requests -With {% data variables.product.prodname_classroom %}, you can enable feedback pull requests. If you enable this feature for an assignment, {% data variables.product.prodname_classroom %} creates a special pull request titled **Feedback** in the assignment repository for each student or group. For more information, see "[AUTOTITLE](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/leave-feedback-with-pull-requests)." +{% data reusables.classroom.about-feedback-pull-requests %} ### Combination with an integrated development environment (IDE) -In {% data variables.product.prodname_classroom %}, you can integrate a classroom with an IDE. Students can make changes to their assignment repositories through the IDE, or by checking out and running code locally with the appropriate software. For more information, see "[AUTOTITLE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/integrate-github-classroom-with-an-ide)." +{% data reusables.classroom.about-ide-integration %} ## Further reading diff --git a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/about-assignments.md b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/about-assignments.md new file mode 100644 index 000000000000..006aa6c72ebe --- /dev/null +++ b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/about-assignments.md @@ -0,0 +1,56 @@ +--- +title: About assignments +intro: 'You can use individual or group assignments in {% data variables.product.prodname_classroom %} to teach students and grade their work.' +shortTitle: About assignments +type: overview +topics: + - Fundamentals +versions: + fpt: '*' +--- + +## About assignments in {% data variables.product.prodname_classroom %} + +Assignments are coursework created for students in {% data variables.product.prodname_classroom %}. You can use assignments to test and grade your students, or to help your students practice their learnings. + +With {% data variables.product.prodname_classroom %}, you can create individual assignments, to be completed by a single student, or group assignments, to be completed in teams. For more information, see "[Types of assignments](#types-of-assignments)." + +{% data reusables.classroom.about-assignments %} + +{% data reusables.classroom.about-feedback-pull-requests %} + +{% data reusables.classroom.about-ide-integration %} + +{% data reusables.classroom.reuse-assignment-link %} + +{% note %} + +**Note:** {% data reusables.classroom.assignments-classroom-prerequisite %} + +{% endnote %} + +## Types of assignments + +You can create both individual assignments and group assignments with {% data variables.product.prodname_classroom %}. + +### Individual assignments + +{% data reusables.classroom.assignments-individual-definition %} + +{% data reusables.classroom.classroom-creates-individual-repositories %} + +For more information, see "[AUTOTITLE](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-an-individual-assignment)." + +### Group assignments + +{% data reusables.classroom.assignments-group-definition %} Students can work together on a group assignment in a shared repository, like a team of professional developers. + +{% data reusables.classroom.about-teams-in-group-assignment %} + +For more information, see "[AUTOTITLE](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-a-group-assignment)." + +## Further reading + +- "[AUTOTITLE](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/use-the-git-and-github-starter-assignment)" +- "[AUTOTITLE](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-an-individual-assignment)" +- "[AUTOTITLE](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-a-group-assignment)" diff --git a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-a-group-assignment.md b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-a-group-assignment.md index 7d23f7de60a6..38fe026bd106 100644 --- a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-a-group-assignment.md +++ b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/create-a-group-assignment.md @@ -12,7 +12,7 @@ redirect_from: {% data reusables.classroom.assignments-group-definition %} Students can work together on a group assignment in a shared repository, like a team of professional developers. -When a student accepts a group assignment, the student can create a new team or join an existing team. {% data variables.product.prodname_classroom %} saves the teams for an assignment as a set. You can name the set of teams for a specific assignment when you create the assignment, and you can reuse that set of teams for a later assignment. +{% data reusables.classroom.about-teams-in-group-assignment %} {% data reusables.classroom.classroom-creates-group-repositories %} diff --git a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/index.md b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/index.md index dc596849a025..5ab188641288 100644 --- a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/index.md +++ b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/index.md @@ -8,6 +8,7 @@ redirect_from: - /education/manage-coursework-with-github-classroom/probot-settings children: - /manage-classrooms + - /about-assignments - /use-the-git-and-github-starter-assignment - /create-an-individual-assignment - /create-a-group-assignment diff --git a/data/reusables/classroom/about-feedback-pull-requests.md b/data/reusables/classroom/about-feedback-pull-requests.md new file mode 100644 index 000000000000..efff2ca273b4 --- /dev/null +++ b/data/reusables/classroom/about-feedback-pull-requests.md @@ -0,0 +1 @@ +Optionally, you can enable feedback pull requests on assignments. If you enable this feature for an assignment, {% data variables.product.prodname_classroom %} creates a special pull request titled **Feedback** in the assignment repository for each student or group. For more information, see "[AUTOTITLE](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/leave-feedback-with-pull-requests)." \ No newline at end of file diff --git a/data/reusables/classroom/about-ide-integration.md b/data/reusables/classroom/about-ide-integration.md new file mode 100644 index 000000000000..806a78553a14 --- /dev/null +++ b/data/reusables/classroom/about-ide-integration.md @@ -0,0 +1 @@ +You can integrate a classroom with an IDE. Students can make changes to their assignment repositories through the IDE, or by checking out and running code locally with the appropriate software. For more information, see "[AUTOTITLE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/integrate-github-classroom-with-an-ide)." \ No newline at end of file diff --git a/data/reusables/classroom/about-teams-in-group-assignment.md b/data/reusables/classroom/about-teams-in-group-assignment.md new file mode 100644 index 000000000000..cd912afaa534 --- /dev/null +++ b/data/reusables/classroom/about-teams-in-group-assignment.md @@ -0,0 +1 @@ +When a student accepts a group assignment, the student can create a new team or join an existing team. {% data variables.product.prodname_classroom %} saves the teams for an assignment as a set. You can name the set of teams for a specific assignment when you create the assignment, and you can reuse that set of teams for a later assignment. \ No newline at end of file