Примечание. В январе 2024 г. GitHub Classroom изменит способ создания репозиториев учащихся из начальных репозиториев кода. В настоящее время процесс требует, чтобы начальные репозитории кода были шаблонами, и GitHub Classroom создает новый репозиторий для каждого учащегося на основе этого шаблона. При предстоящем изменении репозитории учащихся будут созданы путем создания вилки начального репозитория кода.
Это изменение устраняет часто запрашиваемую функцию от преподавателей: возможность изменять начальный код после принятия задания учащимися.
Дополнительные сведения об этом изменении см. в блоге GitHub.
Эта функция находится в общедоступной бета-версии и подлежит изменению.
Сведения о групповых заданиях
Групповое задание — это совместная курсовая работа для групп учащихся в GitHub Classroom. Учащиеся могут совместно работать над групповым заданием в общем репозитории, как команда профессиональных разработчиков.
Для каждого группового задания GitHub Classroom автоматически создает один общий репозиторий для доступа команды. Можно использовать пустой репозиторий или создать репозиторий из репозитория шаблонов с начальным кодом, документацией, тестами и другими ресурсами. Репозиторий принадлежит вашей корпоративной учетной записи в GitHub, а GitHub Classroom предоставляет доступ командам, которые учащиеся создают и к которым присоединяются, принимая задание.
У каждого задания есть название и предлагаемый срок выполнения. Вы можете выбрать видимость репозиториев, создаваемых GitHub Classroom, и разрешения на доступ. Кроме того, вы можете выбрать автоматическую оценку заданий и создать отдельное пространство для обсуждения задания с учащимся.
Вы можете определять, сколько команд может быть ы одном задании, и сколько участников может быть в каждой команде. Каждая команда, созданная учащимся для задания, является командой в вашей организации в GitHub. Команда не отображается открыто. Команды, создаваемые в GitHub, не будут отображаться в GitHub Classroom. Дополнительные сведения см. в разделе Сведения о командах.
Можно повторно использовать существующие назначения в любом другом классе, к которому у вас есть доступ администратора, включая классы в другой организации. Дополнительные сведения см. в разделе Повторное использование назначения.
Необходимые компоненты
Перед созданием назначения необходимо создать аудиторию. Дополнительные сведения см. в разделе Управление аудиториями.
Создание задания
- Войдите в GitHub Classroom.
- Перейдите к аудитории.
- На вкладке "Назначения" "Назначения **" **создайте назначение.
- Если это первое задание, нажмите Создать назначение.
- В противном случае нажмите кнопку "Создать назначение " справа.
Настройка основных сведений о назначении
Укажите имя задания, решите, следует ли установить крайний срок выполнения, определите команды и выберите видимость репозиториев для задания.
- Указание имени задания
- Назначение крайнего срока выполнения для задания
- Выбор типа задания
- Определение команд для задания
- Выбор видимости для репозиториев задания
Указание имени задания
Для группового задания GitHub Classroom именует репозитории, используя префикс репозитория и имя команды. По умолчанию префикс репозитория используется в качестве заголовка задания. Например, если вы назвали задание как "assignment-1", а команда в GitHub имеет имя "student-team", репозиторий задания для участников команды будет иметь имя assignment-1-student-team.
В поле "Название назначения" введите заголовок для назначения. Если нужно, щелкните , чтобы изменить префикс.
Назначение крайнего срока выполнения для задания
Для назначения можно указать срок. В разделе "Крайний срок (необязательно)" щелкните текстовое поле и укажите крайний срок, используя средство выбора даты.
При необходимости, чтобы сделать крайний срок датой отсечения, выберите "Это дата отсечения". Если вы используете дату отсечения, учащиеся потеряют доступ на запись к репозиториям заданий после передачи даты отсечения, если они не получат расширение. Дополнительные сведения о продлении срока назначения см. в разделе "Продление срока назначения для отдельного человека или группы".
Выбор типа задания
В разделе "Индивидуальное или групповое задание" щелкните раскрывающееся меню и выберите Групповое задание. Вы не можете изменить тип задания после создания задания. Если вы хотите создать отдельное назначение, см. разделСоздание отдельного задания".
Определение команд для задания
Если вы уже создали групповое задание для аудитории, то можете повторно использовать набор команд для нового задания. Чтобы создать новый набор с командами, создаваемыми учащимися для задания, введите имя набора. При необходимости введите максимальное количество участников команд и максимальное количество команд.
Примечание.
-
Рекомендуется включить в имя набора команд сведения об этом наборе. Например, если вы хотите использовать набор команд для одного задания, присвойте ему имя после задания. Если вы хотите неоднократно использовать этот набор в течение семестра или курса, назовите набор после семестра или курса.
-
Если вы хотите назначить учащихся в определенную команду, присвойте учащимся имя этой команды и предоставьте список участников.
Выбор видимости для репозиториев задания
Репозитории для задания могут быть общедоступными или частными. Если вы используете частные репозитории, то ваш отзыв смогут увидеть только учащийся или команда.
Вы также можете решить, предоставлять ли учащимся разрешения администратора в отношении репозитория для задания. Предоставляйте разрешения администратора, если учащийся должен иметь возможность выполнять в репозитории задания административные задачи. Дополнительные сведения см. в разделе "[AUTOTITLE" и "Сведения о репозиториях](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization)".
В разделе "Видимость репозитория" выберите видимость. При необходимости установите флажок Предоставить учащимся административный доступ к их репозиторию.
Закончив, нажмите кнопку Продолжить, чтобы настроить начальный код и среду разработки для назначения.
Добавление начального кода и настройка среды разработки
При желании вы можете подготовить пустые репозитории или начальный код, а также предварительно настроить для учащихся среду разработки.
Выбор репозитория шаблонов
По умолчанию новое задание создаст пустой репозиторий для каждой команды, созданной учащимися. При необходимости можно выбрать репозиторий шаблонов как начальный код для назначения. Дополнительные сведения о репозиториях шаблонов см. в разделе "Создание репозитория шаблонов".
Примечание: Репозиторий шаблонов должен принадлежать вашей организации или быть общедоступным репозиторием для GitHub.
В разделе "Добавление репозитория шаблонов для предоставления учащимся начального кода" откройте раскрывающийся список Выбор репозитория и введите поисковый запрос. В списке результатов щелкните репозиторий шаблонов, который вы хотите использовать для начального кода.
Выбор интегрированной среды разработки (IDE)
Задание можно настроить на использование интегрированной среды разработки. IDE позволяют учащимся писать код, запускать программы и вместе работать над проектами, не устанавливая Git и не используя полную цепочку инструментов разработки на своем компьютере. Если вы выберете для задания интегрированную среду разработки, учащиеся смогут извлекать и запускать код локально на компьютере с необходимым программным обеспечением. Дополнительные сведения см. в разделе "Интеграция GitHub Classroom с интегрированной средой разработки".
Вы можете настроить задание с помощью GitHub Codespaces для предоставления учащимся доступа к среде на основе браузера Visual Studio Code с помощью настройки одного щелчка мыши. Дополнительные сведения см. в разделе Использование GitHub Codespaces с GitHub Classroom.
Чтобы выбрать интегрированную среду разработки для назначения, откройте раскрывающееся меню "Добавить редактор" и выберите интегрированную среду разработки, которую должны использовать ваши учащиеся.
Закончив, нажмите Продолжить, чтобы настроить автоматическую оценку и отзывы для проекта.
Отправка отзывов и предложений
При необходимости можно автоматически оценивать задания и создать пространство для обсуждения с командой каждого отправленного задания.
Автоматическое тестирование заданий
Вы можете использовать автоматическую классификацию для автоматической проверки работы учащегося по заданию в GitHub Classroom. Вы настраиваете тесты для задания, а тесты выполняются немедленно каждый раз, когда учащийся отправляется в репозиторий заданий на GitHub.com. Учащийся может просматривать результаты теста, вносить изменения и отправлять новые результаты. Дополнительные сведения см. в разделе "Использование автоматической проверки".
В разделе "Добавить тесты с автоматической оценкой" выберите раскрывающееся меню Добавить тест, а затем метод оценки, который хотите использовать. Дополнительные сведения см. в разделе "Использование автоматической проверки".
Определите параметры тестового случая, такие как имя, команды, входные данные, выходные данные, время ожидания и точки. Закончив, нажмите Сохранить тестовый случай.
Вы можете добавить дополнительные тесты с помощью раскрывающегося меню Добавить тест, а также изменить или удалить существующие тесты, используя или .
Создание запроса на вытягивание для отзыва
Можно создать запрос на вытягивание, позволяющий отправить отзыв и ответить на вопросы учащегося о задании, автоматически. Дополнительные сведения о проверке изменений в запросе на вытягивание см. в разделе "Проверка изменений в запросах на включение изменений". Дополнительные сведения о выходе отзывов в запросе на вытягивание см. в разделе "Передача обратной связи с помощью запросов на вытягивание".
Чтобы создать запросы на вытягивание для обсуждения отзывов, выберите Включить запросы на вытягивание отзывов.
Чтобы создать назначение, нажмите Создать назначение.
Приглашение учащихся в назначение
По умолчанию GitHub Classroom включает URL-адрес приглашения для каждого создаваемого задания. Учащиеся могут принимать и отправлять задание, пока включен URL-адрес приглашения. Вы можете делиться URL-адресом с учащимися в LMS, на домашней странице курса и на любой странице, где вы публикуете задания. Учащийся также может перейти к заданию в GitHub Classroom, если он уже принял задание для аудитории.
Предупреждение. Будьте осторожны, передавая URL-адреса приглашений. Любой пользователь с URL-адресом приглашения в задание может принять приглашение и связать учетную запись пользователя в GitHub с идентификатором в списке.
Вы можете просматривать команды, которые работают над заданием или отправили его, на вкладке Команды для задания. Чтобы запретить учащимся принимать или отправлять то или иное задание, измените "Состояние задания" в представлении "Изменить задание". Если задание активно, учащиеся смогут принять его по ссылке-приглашению. Если оно неактивно, ссылка работать не будет.
Отслеживание хода работы учащихся
На странице обзора заданий представлены общие сведения о принятии заданий и ходе работы учащихся. Дополнительные сведения о просмотре и использовании страницы обзора назначения см. в разделе "Мониторинг хода выполнения учащихся с помощью страницы обзора заданий".
Следующие шаги
-
После того как вы создадите задание, и ваши учащиеся сформируют команды, члены команд могут начать работу над заданием с использованием Git и возможностей GitHub. Учащиеся могут клонировать репозиторий, отправлять фиксации, управлять ветвями, создавать и просматривать запросы на вытягивание, устранять конфликты слияния и обсуждать изменения с помощью проблем. Журнал фиксаций для репозитория может просматриваться как вами, так и командой. Дополнительные сведения см. в разделе[ "AUTOTITLE", "Начало работы с документацией по GitHub", "AUTOTITLE](/repositories)" и "[AUTOTITLE", а](/pull-requests/collaborating-with-pull-requests) также бесплатный курс по разрешению конфликт слияния из GitHub Skills.
-
Когда команда завершит задание, вы можете просмотреть файлы в репозитории или журнал и визуализации для репозитория, чтобы лучше понять совместную работу команды. Дополнительные сведения см. в разделе Просмотр действий и данных для репозитория.
-
Чтобы предоставить отзыв о задании, можно оставить комментарий к отдельным фиксациям или строкам в запросе на вытягивание. Дополнительные сведения см. в разделе "[AUTOTITLE" и "Комментирование в запросе на вытягивание](/issues/tracking-your-work-with-issues/creating-an-issue)". Дополнительные сведения о создании сохраненных ответов для предоставления отзывов о распространенных ошибках см. в разделе "Сведения о сохраненных ответах".