зеркало из https://github.com/github/docs.git
[Ready to ship] GitHub Classroom - mention new starter assignment course (#18878)
This commit is contained in:
Родитель
3d435d61db
Коммит
86eb89f697
Двоичный файл не отображается.
До Ширина: | Высота: | Размер: 22 KiB После Ширина: | Высота: | Размер: 126 KiB |
Двоичные данные
assets/images/help/classroom/assignments-click-new-starter-assignment-button.png
Normal file
Двоичные данные
assets/images/help/classroom/assignments-click-new-starter-assignment-button.png
Normal file
Двоичный файл не отображается.
После Ширина: | Высота: | Размер: 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">
|
||||
|
|
Загрузка…
Ссылка в новой задаче