diff options
feat(teaching/upp-2025/w1): Add slides and exercises
1 files changed, 174 insertions, 0 deletions
| -rw-r--r-- | src/teaching/upp-2025/week01/github_classroom.du | 174 |
diff --git a/src/teaching/upp-2025/week01/github_classroom.du b/src/teaching/upp-2025/week01/github_classroom.du new file mode 100644 index 0000000..216a09d --- /dev/null +++ b/src/teaching/upp-2025/week01/github_classroom.du @@ -0,0 +1,174 @@ +# GitHub Classroom упътване - УПП, Седмица 1, 02.10.2025 + +'define expected-reading 5 min +'define created 27 September 2025 +'define edited 27 September 2025 +[$pagenav] + +[$presentation-controller] + +:title_slide + +# GitHub акаунт + +.p Може да пропуснете тази секция ако вече имате GitHub акаунт + + +:slide + +## Сега всички (които нямат) трябва да си направят GitHub акаунти + +.p +Отивате на [url https://github.com/signup github.com/signup], въвеждате си данните една по една и се регистрирате + +.p [image ../../upp-2023/week1/img/github-signup.gif] + + +:middle_slide + +.p +След това, като влезете в акаунтите си (което става автоматично след регистрация), на заглавната страница ще имате нещо такова: + +.width75% [image ../../upp-2023/week1/img/github-index.gif] + +.p +В горния десен ъгъл, където е иконката с квадрати на бял фон, след натискане получавате sidebar. +От него, може да достъпите профила си, repository-та които имате, и так. нат. + + +:slide + +### Проверете дали сте маркирани! + +.p +Понякога при създаване на нов акаунт, GitHub го маркира (като "проблемен"). +В такава ситуация, няма да можете сами да го изтриете и няма да можете да го ползвате за GitHub classroom. + +.p +Най-простия начин, който намерих, е да отворите +[url https://support.github.com/contact/reinstatement support.github.com/contact/reinstatement]\n +Ако отгоре пише "Your account has been flagged", тогава имаме проблем. + +.p +[image ../../upp-2023/week1/img/github-support-flagged.gif] + + +:title_slide35 + +# Конфигуриране и ползване на GitHub Classroom + + +:slide + +## Как ще ползваме GitHub Classroom + +[$br3] + +.p +За всеки практикум ще има направя линк. +При приемане на заданието се генерира repository. + +.p +Трябва да сте качили работата си =[по време]= на упражнението (или малко след това) в това repository. +GitHub предоставя лесни начини да правите промени по файлове директно чрез браузъра, така че за незаинтересуваните, може да го ползвате като усложнен Google Drive. + +.p +След това аз ще направя отзиви върху вашата работа. +Те ще се намират в таба "Pull Requests" на конкретното repository. +Четете ги, отговаряйте, целта е да дискутираме какво сте направили. + + +:slide + +.p +За всяко упражнение ще има отделен линк.\n +Този за днеска е: [url https://classroom.github.com/a/-1l498jX] + +[$br1] + +:row +.p След като го отворите, ще видите съобщение за разрешение, авторизирайте го. + +.p [image ../../upp-2023/week1/img/github-classroom-authorize.gif] + + + +:middle_slide + +:row + +.width60% [image ../../upp-2023/week1/img/join-the-classroom.gif] + +:column + +.p При първо влизане ще получите страница с имената и факултетните имена на всички студенти от групата. + +.p Изберете своето. + +.p Това се прави само веднъж, и след това никога пак. + + + + +:slide + +.p След това, би трябвало да видите страницата за "Приемане на заданието". + +.width40% [image ../../upp-2023/week1/img/accept-assignment.gif] + +.p След като го приемете, на новата страница, изчакайте няколко секунди и презаредете. +Трябва да видите това: + +.width40% [image ../../upp-2023/week1/img/ready-to-go.gif] + + +:middle_slide + +.p Сега сте готови, кликнете върху синия линк и ще стигнете във вашето GitHub repository. + +.p Вътре в това конкретно repository очаквам да качвате работата ви през упражнението. +Повтарям, дори да е недовършено, дори да има някакви празни файлове и такива, трябва да го качите. + +.p Който иска спокойно може да прави няколко commit-и, да им прави съобщения и так. нат., ама към този етап, това не е нужно. + +.p В края на презентация показвам как точно е най-лесно да качите работата си. + + +:slide + +.p +В таба "Pull requests", още от началото, ще имате едно "Feedback". +В него ще ви връщам отзиви относно работата ви, и вие също можете да пишете неща и да ми отговаряте. + +.p +Целта е да видя какво правите и да ви помогна, моля проверявайте какво съм ви писал, по подразбиране би трябвало да получавате известия на имейл-а. + +.centered +.width80% [image ../../upp-2023/week1/img/feedback.gif] + + +:slide + +## Качване на решенията + +.p +След като сте решили една задача, имате два варианта за писане на следващата: или да създадете нов проект, или да презапишете кода. +Второто е най-лесно. + +.p +Във всеки случай, ще се наложи сегашния файл с код да го качите. +Най-елементарния начин: копирате всичко, след това отивате на вашето GitHub repository, кликвате "Add", после "Create new file". + +.p +Отгоре на "Name your file..." пишете някакво име, което =[моля да завърша на `[.cpp]`!]= +Това показва, че файла съдържа код на C++. +Също, когато решавате много задачи и създавате много такива файлове, =[напомням че имената на файловете трябва да са различни.]= + +.p +В "Enter file contents here" пействате копирания код. +Горе в дясно натискате "Commit changes...", в pop-up-a после пак натискате "Commit changes" (ако искате, променяйте "Commit message" и "Extended description", но не е нужно) и сте готови с този файл/задача. + + +:title_slide35 + +.p [url ./visual_studio.html?a Към "Visual Studio упътване"] |