[Ready to ship] GitHub Classroom - mention new starter assignment course (#18878)

This commit is contained in:
mc 2021-05-26 04:00:13 +01:00 коммит произвёл GitHub
Родитель 3d435d61db
Коммит 86eb89f697
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
11 изменённых файлов: 128 добавлений и 9 удалений

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 22 KiB

После

Ширина:  |  Высота:  |  Размер: 126 KiB

Двоичный файл не отображается.

После

Ширина:  |  Высота:  |  Размер: 104 KiB

Двоичный файл не отображается.

После

Ширина:  |  Высота:  |  Размер: 53 KiB

Двоичный файл не отображается.

После

Ширина:  |  Высота:  |  Размер: 193 KiB

Просмотреть файл

@ -21,6 +21,7 @@ Administer a classroom, assign and review work from your students, and teach the
- [Basics of setting up {% data variables.product.prodname_classroom %} ](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)
- [Manage classrooms](/education/manage-coursework-with-github-classroom/manage-classrooms)
- [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)
- [Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)
- [Create an assignment from a template repository](/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository)

Просмотреть файл

@ -10,4 +10,3 @@ children:
- /integrate-github-classroom-with-an-ide
- /learn-with-github-classroom
---

Просмотреть файл

@ -8,6 +8,7 @@ redirect_from:
- /education/manage-coursework-with-github-classroom/probot-settings
children:
- /manage-classrooms
- /use-the-git-and-github-starter-assignment
- /create-an-individual-assignment
- /create-a-group-assignment
- /create-an-assignment-from-a-template-repository
@ -15,4 +16,3 @@ children:
- /use-autograding
- /connect-a-learning-management-system-to-github-classroom
---

Просмотреть файл

@ -1,6 +1,6 @@
---
title: Manage classrooms
intro: 'You can create and manage a classroom for each course that you teach using {% data variables.product.prodname_classroom %}.'
intro: You can create and manage a classroom for each course that you teach using {% data variables.product.prodname_classroom %}.
permissions: Organization owners can manage a classroom for an organization.
versions:
free-pro-team: '*'
@ -8,6 +8,7 @@ redirect_from:
- /education/manage-coursework-with-github-classroom/archive-a-classroom
- /education/manage-coursework-with-github-classroom/manage-classrooms
---
### About classrooms
{% data reusables.classroom.about-classrooms %}
@ -45,7 +46,7 @@ You must authorize the OAuth app for {% data variables.product.prodname_classroo
!["New classroom" button](/assets/images/help/classroom/click-new-classroom-button.png)
{% data reusables.classroom.guide-create-new-classroom %}
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)."
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)."
### Creating a roster for your classroom
@ -58,10 +59,8 @@ If your course already has a roster, you can update the students on the roster o
{% data reusables.classroom.click-students %}
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)."
!["Import from a learning management system" button](/assets/images/help/classroom/click-import-from-a-learning-management-system-button.png)
1. Provide the student identifiers for your roster.
- To import a roster by uploading a file containing student identifiers, click **Upload a CSV or text file**.
- To create a roster manually, type your student identifiers.
![Text field for typing student identifiers and "Upload a CSV or text file" button](/assets/images/help/classroom/type-or-upload-student-identifiers.png)
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.
![Text field for typing student identifiers and "Upload a CSV or text file" button](/assets/images/help/classroom/type-or-upload-student-identifiers.png)
1. Click **Create roster**.
!["Create roster" button](/assets/images/help/classroom/click-create-roster-button.png)

Просмотреть файл

@ -0,0 +1,101 @@
---
title: Use the Git and GitHub starter assignment
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.
versions:
free-pro-team: '*'
redirect_from:
- /education/manage-coursework-with-github-classroom/use-the-git-and-github-starter-assignment
---
{% note %}
**Note:** The Git & {% data variables.product.company_short %} starter assignment is in beta and subject to change.
{% endnote %}
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.
### Prerequisites
{% data reusables.classroom.assignments-classroom-prerequisite %}
### Creating the starter assignment
#### If there are no existing assignments in the classroom
1. Sign into {% data variables.product.prodname_classroom_with_url %}.
2. Navigate to a classroom.
3. In the {% octicon "repo" aria-label="The repo icon" %} **Assignments** tab, click **Use starter assignment**.
<div class="procedural-image-wrapper">
<img alt="Creating your first assignment" class="procedural-image-wrapper" src="/assets/images/help/classroom/assignments-create-first-assignment.png">
</div>
#### If there already are existing assignments in the classroom
1. Sign into {% data variables.product.prodname_classroom_with_url %}.
2. Navigate to a classroom.
3. In the {% octicon "repo" aria-label="The repo icon" %} **Assignments** tab, click the link on the blue banner.
<div class="procedural-image-wrapper">
<img alt="The 'New assignment' button" class="procedural-image-wrapper" src="/assets/images/help/classroom/assignments-click-new-starter-assignment-button.png">
</div>
### Setting up the basics for an assignment
Import the starter course into your organization, name your assignment, decide whether to assign a deadline, and choose the visibility of assignment repositories.
- [Importing the assignment](#importing-the-assignment)
- [Naming an assignment](#naming-an-assignment)
- [Assigning a deadline for an assignment](#assigning-a-deadline-for-an-assignment)
- [Choosing an assignment type](#choosing-an-assignment-type)
- [Choosing a visibility for assignment repositories](#choosing-a-visibility-for-assignment-repositories)
#### Importing the assignment
You first need to import the Git & {% data variables.product.product_name %} starter assignment into your organization.
<div class="procedural-image-wrapper">
<img alt="The `Import the assignment` button" class="procedural-image-wrapper" src="/assets/images/help/classroom/assignments-import-starter-assignment.png">
</div>
#### Naming the 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 a visibility for assignment repositories
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.
When you're done, click **Continue**. {% data variables.product.prodname_classroom %} will create the assignment and bring you to the assignment page.
<div class="procedural-image-wrapper">
<img alt="'Continue' button" class="procedural-image-wrapper" src="/assets/images/help/classroom/assignments-click-continue-button.png">
</div>
### 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 **All students** tab for the assignment. {% data reusables.classroom.assignments-to-prevent-submission %}
<div class="procedural-image-wrapper">
<img alt="Individual assignment" class="procedural-image-wrapper" src="/assets/images/help/classroom/assignment-individual-hero.png">
</div>
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.
### Next steps
- 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)."
### Further reading
- "[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)"
- "[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)"

Просмотреть файл

@ -85,6 +85,7 @@ You've created a classroom, and you're ready to enrich your course with {% data
- 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)."
- 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)."
- 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)."
- Create an assignment for individual students or teams. {% data reusables.classroom.for-more-information-about-assignment-creation %}
- 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)."
- Participate in {% data variables.product.prodname_education_community_with_url %}.

Просмотреть файл

@ -1,4 +1,22 @@
To create an assignment, sign into {% data variables.product.prodname_classroom_with_url %} and navigate to a classroom. In the {% octicon "repo" aria-label="The repo icon" %} **Assignments** tab, click **New assignment**.
#### If there are no existing assignments in the classroom
To create your first assignment:
1. Sign into {% data variables.product.prodname_classroom_with_url %}.
1. Navigate to a classroom.
1. In the {% octicon "repo" aria-label="The repo icon" %} **Assignments** tab, click **Create an assignment**.
<div class="procedural-image-wrapper">
<img alt="Creating your first assignment" class="procedural-image-wrapper" src="/assets/images/help/classroom/assignments-create-first-assignment.png">
</div>
#### If there already are existing assignments in the classroom
To create an assignment:
1. Sign into {% data variables.product.prodname_classroom_with_url %}.
1. Navigate to a classroom.
1. In the {% octicon "repo" aria-label="The repo icon" %} **Assignments** tab, click **New assignment**.
<div class="procedural-image-wrapper">
<img alt="The 'New assignment' button" class="procedural-image-wrapper" src="/assets/images/help/classroom/assignments-click-new-assignment-button.png">