Создание отдельного задания

Вы можете создать задание для учащихся в своем курсе для индивидуального выполнения.

Кто может использовать эту функцию?

Organization owners who are admins for a classroom can create and manage individual assignments for a classroom. Дополнительные сведения об администраторах аудитории см. в разделе "Управление аудиториями".

В этой статье

Сведения об отдельных заданиях

Индивидуальное задание — это курсовая работа для каждого учащегося, который участвует в курсе по GitHub Classroom. Учащийся должен выполнить индивидуальное задание без помощи других студентов.

Когда учащийся принимает задание, GitHub Classroom автоматически создает новый репозиторий для учащегося. Репозитории могут быть пустыми или создавать репозитории из репозитория шаблонов с начальным кодом, документацией, тестами и другими ресурсами. Каждый репозиторий заданий принадлежит вашей учетной записи организации в GitHub.

У каждого задания есть название и предлагаемый срок выполнения. Вы можете выбрать видимость репозиториев, создаваемых GitHub Classroom, и разрешения на доступ. Кроме того, вы можете выбрать автоматическую оценку заданий и создать отдельное пространство для обсуждения задания с учащимся.

Можно повторно использовать существующие назначения в любом другом классе, к которому у вас есть доступ администратора, включая классы в другой организации. Дополнительные сведения см. в разделе Повторное использование назначения.

Необходимые компоненты

Перед созданием назначения необходимо создать аудиторию. Дополнительные сведения см. в разделе Управление аудиториями.

Создание задания

  1. Войдите в GitHub Classroom.
  2. Перейдите к аудитории.
  3. На вкладке "Назначения" "Назначения " создайте назначение.
    • Если это первое задание, нажмите Создать назначение.
    • В противном случае нажмите кнопку "Создать назначение " справа.

Настройка основных сведений о назначении

Укажите имя задания, определите, следует ли задать крайний срок выполнения для задания, и выберите видимость репозиториев для задания.

Указание имени задания

Для отдельного задания GitHub Classroom устанавливает имена репозиториев, состоящие из префикса репозитория и имени пользователя учащегося GitHub. По умолчанию префикс репозитория используется в качестве заголовка задания. Например, если имя задания — "assignment-1", а имя пользователя учащегося в GitHub — @octocat, репозиторий задания для @octocat получит имя assignment-1-octocat.

В поле "Название назначения" введите заголовок для назначения. Если нужно, щелкните , чтобы изменить префикс.

Назначение крайнего срока выполнения для задания

Для назначения можно указать срок. В разделе "Крайний срок (необязательно)" щелкните текстовое поле и укажите крайний срок, используя средство выбора даты.

При необходимости, чтобы сделать крайний срок датой отсечения, выберите "Это дата отсечения". Если вы используете дату отсечения, учащиеся потеряют доступ на запись к репозиториям заданий после передачи даты отсечения, если они не получат расширение. Дополнительные сведения о продлении срока назначения см. в разделе "Продление срока назначения для отдельного человека или группы".

Выбор типа задания

В разделе "Отдельное или групповое задание" щелкните раскрывающееся меню и выберите Отдельное задание. Вы не можете изменить тип задания после создания задания. Если вы хотите создать назначение группы, см. разделСоздание группового задания".

Выбор видимости для репозиториев задания

Репозитории для задания могут быть общедоступными или частными. Если вы используете частные репозитории, то ваш отзыв смогут увидеть только учащийся или команда.

Вы также можете решить, предоставлять ли учащимся разрешения администратора в отношении репозитория для задания. Предоставляйте разрешения администратора, если учащийся должен иметь возможность выполнять в репозитории задания административные задачи. Дополнительные сведения см. в разделе "[AUTOTITLE" и "Сведения о репозиториях](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization)".

В разделе "Видимость репозитория" выберите видимость. При необходимости установите флажок Предоставить учащимся административный доступ к их репозиторию.

Закончив, нажмите кнопку Продолжить, чтобы настроить начальный код и среду разработки для назначения.

Добавление начального кода и настройка среды разработки

При желании вы можете подготовить пустые репозитории или начальный код, а также предварительно настроить для учащихся среду разработки.

Выбор репозитория шаблонов

По умолчанию для нового задания будет создан пустой репозиторий для каждого учащегося в списке аудитории. При необходимости можно выбрать репозиторий шаблонов как начальный код для назначения. Дополнительные сведения см. в разделе Создание назначения на основе репозитория шаблонов.

Note

Репозиторий шаблонов должен принадлежать вашей организации или быть общедоступный репозиторий на GitHub.

В разделе "Добавление репозитория шаблонов для предоставления учащимся начального кода" откройте раскрывающийся список Выбор репозитория и введите поисковый запрос. В списке результатов щелкните репозиторий шаблонов, который вы хотите использовать для начального кода.

Закончив, нажмите Продолжить, чтобы настроить автоматическую оценку и отзывы для проекта.

Выбор интегрированной среды разработки (IDE)

Задание можно настроить на использование интегрированной среды разработки. IDE позволяют учащимся писать код, запускать программы и вместе работать над проектами, не устанавливая Git и не используя полную цепочку инструментов разработки на своем компьютере. Если вы выберете для задания интегрированную среду разработки, учащиеся смогут извлекать и запускать код локально на компьютере с необходимым программным обеспечением. Дополнительные сведения см. в разделе "Интеграция GitHub Classroom с интегрированной средой разработки".

Вы можете настроить задание с помощью GitHub Codespaces для предоставления учащимся доступа к среде на основе браузера Visual Studio Code с помощью настройки одного щелчка мыши. Дополнительные сведения см. в разделе Использование GitHub Codespaces с GitHub Classroom.

Чтобы выбрать интегрированную среду разработки для назначения, откройте раскрывающееся меню "Добавить редактор" и выберите интегрированную среду разработки, которую должны использовать ваши учащиеся.

Предоставление отзыва о задании

При необходимости можно автоматически оценить задания и создать пространство для обсуждения каждого отправленного задания с учащимся.

Автоматическое тестирование заданий

Вы можете использовать автоматическую классификацию для автоматической проверки работы учащегося по заданию в GitHub Classroom. Вы настраиваете тесты для задания, а тесты выполняются немедленно каждый раз, когда учащийся отправляется в репозиторий заданий на GitHub.com. Учащийся может просматривать результаты теста, вносить изменения и отправлять новые результаты. Дополнительные сведения см. в разделе "Использование автоматической проверки".

В разделе "Добавить тесты с автоматической оценкой" выберите раскрывающееся меню Добавить тест, а затем метод оценки, который хотите использовать. Дополнительные сведения см. в разделе "Использование автоматической проверки".

Определите параметры тестового случая, такие как имя, команды, входные данные, выходные данные, время ожидания и точки. Закончив, нажмите Сохранить тестовый случай.

Вы можете добавить дополнительные тесты с помощью раскрывающегося меню Добавить тест, а также изменить или удалить существующие тесты, используя или .

Назначение защищенных путей к файлам

Если задание содержит файлы или каталоги, используемые в процессе оценки или не должны изменяться учащимися, их можно назначить как защищенные пути к файлам. Если учащийся редактирует защищенный файл, метка будет применена к их отправке на странице обзора назначения для изучения. Дополнительные сведения см. в разделе Мониторинг хода выполнения учащихся с помощью страницы обзора заданий.

Шаблоны защищенных путей соответствуют правилам, аналогичным globs имени файла оболочки. Он может содержать следующие мета-символы:

  • *: соответствует любому файлу. Например, * соответствует всем обычным файлам, соответствует всем файлам, foo* начиная с foo, *foo совпадает со всеми файлами, заканчивающимися fooи *foo* совпадает со всеми файлами, имена которых содержатся foo (в том числе в начале или конце).
  • **: сопоставляет каталоги рекурсивно или файлы. Например, .github/**/* будет соответствовать всем файлам и .github любым из его подкаталогов.
  • ?: соответствует любому одному символу
  • [set]: соответствует любому одному символу ( setвключая наборы, например a-z)
  • \: экранирует следующий мета-символ

Создание запроса на вытягивание для отзыва

Можно создать запрос на вытягивание, позволяющий отправить отзыв и ответить на вопросы учащегося о задании, автоматически. Дополнительные сведения о проверке изменений в запросе на вытягивание см. в разделе "Проверка изменений в запросах на включение изменений". Дополнительные сведения о выходе отзывов в запросе на вытягивание см. в разделе "Передача обратной связи с помощью запросов на вытягивание".

Чтобы создать запросы на вытягивание для обсуждения отзывов, выберите Включить запросы на вытягивание отзывов.

Чтобы создать назначение, нажмите Создать назначение.

Приглашение учащихся в назначение

По умолчанию GitHub Classroom включает URL-адрес приглашения для каждого создаваемого задания. Учащиеся могут принимать и отправлять задание, пока включен URL-адрес приглашения. Вы можете делиться URL-адресом с учащимися в LMS, на домашней странице курса и на любой странице, где вы публикуете задания. Учащийся также может перейти к заданию в GitHub Classroom, если он уже принял задание для аудитории.

Warning

Будьте осторожны, где вы делитесь URL-адресами приглашений. Любой пользователь с URL-адресом приглашения в задание может принять приглашение и связать учетную запись пользователя в GitHub с идентификатором в списке.

На вкладке Список аудитории для задания можно узнать, присоединился ли учащийся к аудитории, принял ли он задание и отправил ли он его. На этой вкладке также можно связать псевдонимы учащихся GitHub с их идентификаторами в списке и наоборот. Чтобы запретить учащимся принимать или отправлять то или иное задание, измените "Состояние задания" в представлении "Изменить задание". Если задание активно, учащиеся смогут принять его по ссылке-приглашению. Если оно неактивно, ссылка работать не будет.

Отслеживание хода работы учащихся

На странице обзора заданий представлены общие сведения о принятии заданий и ходе работы учащихся. Дополнительные сведения о просмотре и использовании страницы обзора назначения см. в разделе "Мониторинг хода выполнения учащихся с помощью страницы обзора заданий".

Следующие шаги

  • После создания задания учащиеся могут начать работу над заданием с использованием Git и возможностей GitHub. Учащиеся могут клонировать репозиторий, отправлять фиксации, управлять ветвями, создавать и просматривать запросы на вытягивание, устранять конфликты слияния и обсуждать изменения с помощью проблем. Журнал фиксаций для репозитория доступен для просмотра как вам, так и учащимся. Дополнительные сведения см. в разделе[ "AUTOTITLE", "Начало работы с документацией по GitHub" и "Совместная работа с запросами на вытягивание](/repositories)".

  • Когда учащийся завершит задание, вы можете просмотреть файлы в репозитории или журнал и визуализации репозитория, чтобы лучше понять работу учащегося. Дополнительные сведения см. в разделе Просмотр действий и данных для репозитория.

  • Чтобы предоставить отзыв о задании, можно оставить комментарий к отдельным фиксациям или строкам в запросе на вытягивание. Дополнительные сведения см. в разделе "[AUTOTITLE" и "Комментирование в запросе на вытягивание](/issues/tracking-your-work-with-issues/creating-an-issue)". Дополнительные сведения о создании сохраненных ответов для предоставления отзывов о распространенных ошибках см. в разделе "Сведения о сохраненных ответах".

Дополнительные материалы