7.6 KiB
За преподаватели
Добре дошли да използвате тази учебна програма във вашата класна стая. Тя работи безпроблемно с GitHub Classroom и водещи платформи за управление на обучението (LMS), а също така може да се използва като самостоятелно хранилище със студентите ви.
Използване с GitHub Classroom
За управление на уроци и задачи за всяка група, създайте отделно хранилище за всеки урок, така че GitHub Classroom да може да свърже всяка задача независимо.
- Направете fork на това хранилище към вашата организация.
- Създайте отделно хранилище за всеки урок, като извлечете папката на урока в отделно хранилище.
- Вариант А: Създайте празни хранилища (по едно за всеки урок) и копирайте съдържанието на папката на урока във всяко.
- Вариант Б: Използвайте подход, който запазва историята на Git (например, разделяне на папка в ново хранилище), ако ви е необходима проследимост.
- В GitHub Classroom създайте задача за всеки урок и я насочете към съответното хранилище на урока.
- Препоръчителни настройки:
- Видимост на хранилището: частна за работата на студентите.
- Използвайте начален код от основния клон на хранилището на урока.
- Добавете шаблони за проблеми и pull request-и за тестове и предавания.
- По желание конфигурирайте автоматично оценяване и тестове, ако уроците ви ги включват.
- Полезни конвенции:
- Имена на хранилища като lesson-01-intro, lesson-02-html и т.н.
- Етикети: quiz, assignment, needs-review, late, resubmission.
- Тагове/релийзи за всяка група (например, v2025-term1).
Съвет: Избягвайте съхраняването на хранилища в синхронизирани папки (например, OneDrive/Google Drive), за да предотвратите конфликти в Git на Windows.
Използване с Moodle, Canvas или Blackboard
Тази учебна програма включва пакети за импортиране, съвместими с често използвани LMS платформи.
- Moodle: Използвайте файла за качване в Moodle Moodle upload file, за да заредите целия курс.
- Common Cartridge: Използвайте файла Common Cartridge Common Cartridge file за по-широка съвместимост с LMS.
- Бележки:
- Moodle Cloud има ограничена поддръжка за Common Cartridge. Предпочитайте файла за Moodle по-горе, който може да бъде качен и в Canvas.
- След импортиране прегледайте модулите, крайните срокове и настройките на тестовете, за да съответстват на графика на вашия семестър.
Учебната програма в класна стая на Moodle
Учебната програма в Canvas
Използване на хранилището директно (без Classroom)
Ако предпочитате да не използвате GitHub Classroom, можете да проведете курса директно от това хранилище.
- Синхронни/онлайн формати (Zoom/Teams):
- Провеждайте кратки въведения, водени от ментори; използвайте breakout стаи за тестове.
- Обявете времеви прозорец за тестовете; студентите подават отговори като GitHub Issues.
- За съвместни задачи студентите работят в публични хранилища на уроци и отварят pull request-и.
- Частни/асинхронни формати:
- Студентите правят fork на всеки урок в свои частни хранилища и ви добавят като сътрудник.
- Те подават чрез Issues (тестове) и Pull Requests (задачи) в хранилището на вашата класна стая или в техните частни fork-ове.
Най-добри практики
- Осигурете ориентационен урок за основите на Git/GitHub, Issues и PRs.
- Използвайте списъци със задачи в Issues за многостъпкови тестове/задачи.
- Добавете CONTRIBUTING.md и CODE_OF_CONDUCT.md, за да зададете норми за класната стая.
- Добавете бележки за достъпност (alt текст, надписи) и предложете печатни PDF файлове.
- Версирайте съдържанието си за всеки семестър и замразявайте хранилищата на уроците след публикуване.
Обратна връзка и поддръжка
Искаме тази учебна програма да работи за вас и вашите студенти. Моля, отворете нов Issue в това хранилище за грешки, заявки или подобрения, или започнете дискусия в Teacher Corner.
Отказ от отговорност:
Този документ е преведен с помощта на AI услуга за превод Co-op Translator. Въпреки че се стремим към точност, моля, имайте предвид, че автоматизираните преводи може да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за недоразумения или погрешни интерпретации, произтичащи от използването на този превод.