Skip to content

Commit b29be2a

Browse files
authored
Merge pull request github#6781 from github/repo-sync
repo sync
2 parents ad1cdfc + 86eb89f commit b29be2a

File tree

17 files changed

+245843
-264064
lines changed

17 files changed

+245843
-264064
lines changed
105 KB
Loading
104 KB
Loading
53.4 KB
Loading
193 KB
Loading

content/education/guides.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,7 @@ Administer a classroom, assign and review work from your students, and teach the
2121

2222
- [Basics of setting up {% data variables.product.prodname_classroom %} ](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)
2323
- [Manage classrooms](/education/manage-coursework-with-github-classroom/manage-classrooms)
24+
- [Use the Git and {% data variables.product.company_short %} starter assignment](/education/manage-coursework-with-github-classroom/use-the-git-and-github-starter-assignment)
2425
- [Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)
2526
- [Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)
2627
- [Create an assignment from a template repository](/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository)

content/education/manage-coursework-with-github-classroom/index.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,4 +10,3 @@ children:
1010
- /integrate-github-classroom-with-an-ide
1111
- /learn-with-github-classroom
1212
---
13-

content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,11 @@ redirect_from:
88
- /education/manage-coursework-with-github-classroom/probot-settings
99
children:
1010
- /manage-classrooms
11+
- /use-the-git-and-github-starter-assignment
1112
- /create-an-individual-assignment
1213
- /create-a-group-assignment
1314
- /create-an-assignment-from-a-template-repository
1415
- /leave-feedback-with-pull-requests
1516
- /use-autograding
1617
- /connect-a-learning-management-system-to-github-classroom
1718
---
18-

content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/manage-classrooms.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,14 @@
11
---
22
title: Manage classrooms
3-
intro: 'You can create and manage a classroom for each course that you teach using {% data variables.product.prodname_classroom %}.'
3+
intro: You can create and manage a classroom for each course that you teach using {% data variables.product.prodname_classroom %}.
44
permissions: Organization owners can manage a classroom for an organization.
55
versions:
66
free-pro-team: '*'
77
redirect_from:
88
- /education/manage-coursework-with-github-classroom/archive-a-classroom
99
- /education/manage-coursework-with-github-classroom/manage-classrooms
1010
---
11+
1112
### About classrooms
1213

1314
{% data reusables.classroom.about-classrooms %}
@@ -45,7 +46,7 @@ You must authorize the OAuth app for {% data variables.product.prodname_classroo
4546
!["New classroom" button](/assets/images/help/classroom/click-new-classroom-button.png)
4647
{% data reusables.classroom.guide-create-new-classroom %}
4748

48-
After you create a classroom, you can begin creating assignments for students. For more information, see "[Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)" or "[Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)."
49+
After you create a classroom, you can begin creating assignments for students. For more information, see "[Use the Git and {% data variables.product.company_short %} starter assignment](/education/manage-coursework-with-github-classroom/use-the-git-and-github-starter-assignment)," "[Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)," or "[Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)."
4950

5051
### Creating a roster for your classroom
5152

@@ -58,10 +59,8 @@ If your course already has a roster, you can update the students on the roster o
5859
{% data reusables.classroom.click-students %}
5960
1. To connect {% data variables.product.prodname_classroom %} to your LMS and import a roster, click {% octicon "mortar-board" aria-label="The mortar board icon" %} **Import from a learning management system** and follow the instructions. For more information, see "[Connect a learning management system to {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)."
6061
!["Import from a learning management system" button](/assets/images/help/classroom/click-import-from-a-learning-management-system-button.png)
61-
1. Provide the student identifiers for your roster.
62-
- To import a roster by uploading a file containing student identifiers, click **Upload a CSV or text file**.
63-
- To create a roster manually, type your student identifiers.
64-
![Text field for typing student identifiers and "Upload a CSV or text file" button](/assets/images/help/classroom/type-or-upload-student-identifiers.png)
62+
1. To create a roster manually, type your student identifiers. Optionally, click **Upload a CSV or text file** to upload a file containing the identifiers.
63+
![Text field for typing student identifiers and "Upload a CSV or text file" button](/assets/images/help/classroom/type-or-upload-student-identifiers.png)
6564
1. Click **Create roster**.
6665
!["Create roster" button](/assets/images/help/classroom/click-create-roster-button.png)
6766

Lines changed: 101 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,101 @@
1+
---
2+
title: Use the Git and GitHub starter assignment
3+
intro: You can use the Git & {% data variables.product.company_short %} starter assignment to give students an overview of Git and {% data variables.product.company_short %} fundamentals.
4+
versions:
5+
free-pro-team: '*'
6+
redirect_from:
7+
- /education/manage-coursework-with-github-classroom/use-the-git-and-github-starter-assignment
8+
---
9+
10+
{% note %}
11+
12+
**Note:** The Git & {% data variables.product.company_short %} starter assignment is in beta and subject to change.
13+
14+
{% endnote %}
15+
16+
The Git & {% data variables.product.company_short %} starter assignment is a pre-made course that summarizes the basics of Git and {% data variables.product.company_short %} and links students to resources to learn more about specific topics.
17+
18+
### Prerequisites
19+
20+
{% data reusables.classroom.assignments-classroom-prerequisite %}
21+
22+
### Creating the starter assignment
23+
24+
#### If there are no existing assignments in the classroom
25+
26+
1. Sign into {% data variables.product.prodname_classroom_with_url %}.
27+
2. Navigate to a classroom.
28+
3. In the {% octicon "repo" aria-label="The repo icon" %} **Assignments** tab, click **Use starter assignment**.
29+
30+
<div class="procedural-image-wrapper">
31+
<img alt="Creating your first assignment" class="procedural-image-wrapper" src="/assets/images/help/classroom/assignments-create-first-assignment.png">
32+
</div>
33+
34+
#### If there already are existing assignments in the classroom
35+
36+
1. Sign into {% data variables.product.prodname_classroom_with_url %}.
37+
2. Navigate to a classroom.
38+
3. In the {% octicon "repo" aria-label="The repo icon" %} **Assignments** tab, click the link on the blue banner.
39+
40+
<div class="procedural-image-wrapper">
41+
<img alt="The 'New assignment' button" class="procedural-image-wrapper" src="/assets/images/help/classroom/assignments-click-new-starter-assignment-button.png">
42+
</div>
43+
44+
### Setting up the basics for an assignment
45+
46+
Import the starter course into your organization, name your assignment, decide whether to assign a deadline, and choose the visibility of assignment repositories.
47+
48+
- [Importing the assignment](#importing-the-assignment)
49+
- [Naming an assignment](#naming-an-assignment)
50+
- [Assigning a deadline for an assignment](#assigning-a-deadline-for-an-assignment)
51+
- [Choosing an assignment type](#choosing-an-assignment-type)
52+
- [Choosing a visibility for assignment repositories](#choosing-a-visibility-for-assignment-repositories)
53+
54+
#### Importing the assignment
55+
56+
You first need to import the Git & {% data variables.product.product_name %} starter assignment into your organization.
57+
58+
<div class="procedural-image-wrapper">
59+
<img alt="The `Import the assignment` button" class="procedural-image-wrapper" src="/assets/images/help/classroom/assignments-import-starter-assignment.png">
60+
</div>
61+
62+
#### Naming the assignment
63+
64+
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`.
65+
66+
{% data reusables.classroom.assignments-type-a-title %}
67+
68+
#### Assigning a deadline for an assignment
69+
70+
{% data reusables.classroom.assignments-guide-assign-a-deadline %}
71+
72+
#### Choosing a visibility for assignment repositories
73+
74+
The repositories for an assignment can be public or private. If you use private repositories, only the student can see the feedback you provide. Under "Repository visibility," select a visibility.
75+
76+
When you're done, click **Continue**. {% data variables.product.prodname_classroom %} will create the assignment and bring you to the assignment page.
77+
78+
<div class="procedural-image-wrapper">
79+
<img alt="'Continue' button" class="procedural-image-wrapper" src="/assets/images/help/classroom/assignments-click-continue-button.png">
80+
</div>
81+
82+
### Inviting students to an assignment
83+
84+
{% data reusables.classroom.assignments-guide-invite-students-to-assignment %}
85+
86+
You can see whether a student has joined the classroom and accepted or submitted an assignment in the **All students** tab for the assignment. {% data reusables.classroom.assignments-to-prevent-submission %}
87+
88+
<div class="procedural-image-wrapper">
89+
<img alt="Individual assignment" class="procedural-image-wrapper" src="/assets/images/help/classroom/assignment-individual-hero.png">
90+
</div>
91+
92+
The Git & {% data variables.product.company_short %} starter assignment is only available for individual students, not for groups. Once you create the assignment, students can start work on the assignment.
93+
94+
### Next steps
95+
96+
- Make additional assignments customized to your course. For more information, see "[Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)" and "[Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)."
97+
98+
### Further reading
99+
100+
- "[Use {% data variables.product.prodname_dotcom %} in your classroom and research](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-in-your-classroom-and-research)"
101+
- "[Connect a learning management system to {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)"

content/education/quickstart.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -85,6 +85,7 @@ You've created a classroom, and you're ready to enrich your course with {% data
8585

8686
- Watch some videos about {% data variables.product.prodname_classroom %}. For more information, see "[Basics of setting up {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)."
8787
- Manage your classrooms and classroom admins, and create a roster of students for your classroom. For more information, see "[Manage classrooms](/education/manage-coursework-with-github-classroom/manage-classrooms)."
88+
- Use the Git and {% data variables.product.company_short %} starter assignment to give students an overview of Git and {% data variables.product.product_name %} fundamentals. For more information, see "[Use the Git and {% data variables.product.company_short %} starter assignment](/education/manage-coursework-with-github-classroom/use-the-git-and-github-starter-assignment)."
8889
- Create an assignment for individual students or teams. {% data reusables.classroom.for-more-information-about-assignment-creation %}
8990
- Write and implement automated tests to provide immediate feedback to students directly in assignment repositories. For more information, see "[Use autograding](/education/manage-coursework-with-github-classroom/use-autograding)."
9091
- Participate in {% data variables.product.prodname_education_community_with_url %}.

0 commit comments

Comments
 (0)