From de221a4422dd97af6ef43558a6193289debd6c0a Mon Sep 17 00:00:00 2001 From: Syndamia Date: Tue, 3 Oct 2023 21:10:37 +0300 Subject: (te/upp-2023/w1) Finished presentation slides about GitHub classroom --- src/teaching/upp-2023/index.md | 2 +- .../upp-2023/week1/img/accept-assignment.gif | Bin 0 -> 13975 bytes src/teaching/upp-2023/week1/img/feedback.gif | Bin 0 -> 62778 bytes .../week1/img/github-classroom-authorize.gif | Bin 0 -> 24602 bytes src/teaching/upp-2023/week1/img/github-index.gif | Bin 0 -> 85982 bytes src/teaching/upp-2023/week1/img/github-signup.gif | Bin 0 -> 12136 bytes .../upp-2023/week1/img/github-support-flagged.gif | Bin 0 -> 21556 bytes .../upp-2023/week1/img/join-the-classroom.gif | Bin 0 -> 39800 bytes src/teaching/upp-2023/week1/img/ready-to-go.gif | Bin 0 -> 14080 bytes src/teaching/upp-2023/week1/img/u4-mat-hard.gif | Bin 0 -> 64279 bytes src/teaching/upp-2023/week1/img/u4-mat-hard.png | Bin 119504 -> 0 bytes src/teaching/upp-2023/week1/index.md | 8 - src/teaching/upp-2023/week1/setup.md | 213 +++++++++++++++++++++ 13 files changed, 214 insertions(+), 9 deletions(-) create mode 100644 src/teaching/upp-2023/week1/img/accept-assignment.gif create mode 100644 src/teaching/upp-2023/week1/img/feedback.gif create mode 100644 src/teaching/upp-2023/week1/img/github-classroom-authorize.gif create mode 100644 src/teaching/upp-2023/week1/img/github-index.gif create mode 100644 src/teaching/upp-2023/week1/img/github-signup.gif create mode 100644 src/teaching/upp-2023/week1/img/github-support-flagged.gif create mode 100644 src/teaching/upp-2023/week1/img/join-the-classroom.gif create mode 100644 src/teaching/upp-2023/week1/img/ready-to-go.gif create mode 100644 src/teaching/upp-2023/week1/img/u4-mat-hard.gif delete mode 100644 src/teaching/upp-2023/week1/img/u4-mat-hard.png delete mode 100644 src/teaching/upp-2023/week1/index.md create mode 100644 src/teaching/upp-2023/week1/setup.md (limited to 'src') diff --git a/src/teaching/upp-2023/index.md b/src/teaching/upp-2023/index.md index 5e1a64d..5334c61 100644 --- a/src/teaching/upp-2023/index.md +++ b/src/teaching/upp-2023/index.md @@ -13,4 +13,4 @@ |№|Дата|Материали| |-------|----|---------| -|1 |06.10.2023|[Добре дошли](/teaching/upp-2023/week1/welcome.html) \|\| [GitHub, Visual Studio и първата програма (задачи)](/teaching/upp-2023/week1/?a)| +|1 |06.10.2023|[Добре дошли](/teaching/upp-2023/week1/welcome.html) \|\| [Конфигуриране на GitHub classroom и Visual Studio](/teaching/upp-2023/week1/setup.html?a) \|\| [Задачи](/teaching/upp-2023/week1/?a)| diff --git a/src/teaching/upp-2023/week1/img/accept-assignment.gif b/src/teaching/upp-2023/week1/img/accept-assignment.gif new file mode 100644 index 0000000..9d95fd8 Binary files /dev/null and b/src/teaching/upp-2023/week1/img/accept-assignment.gif differ diff --git a/src/teaching/upp-2023/week1/img/feedback.gif b/src/teaching/upp-2023/week1/img/feedback.gif new file mode 100644 index 0000000..85e00b3 Binary files /dev/null and b/src/teaching/upp-2023/week1/img/feedback.gif differ diff --git a/src/teaching/upp-2023/week1/img/github-classroom-authorize.gif b/src/teaching/upp-2023/week1/img/github-classroom-authorize.gif new file mode 100644 index 0000000..ff4812e Binary files /dev/null and b/src/teaching/upp-2023/week1/img/github-classroom-authorize.gif differ diff --git a/src/teaching/upp-2023/week1/img/github-index.gif b/src/teaching/upp-2023/week1/img/github-index.gif new file mode 100644 index 0000000..e80b5df Binary files /dev/null and b/src/teaching/upp-2023/week1/img/github-index.gif differ diff --git a/src/teaching/upp-2023/week1/img/github-signup.gif b/src/teaching/upp-2023/week1/img/github-signup.gif new file mode 100644 index 0000000..dfab978 Binary files /dev/null and b/src/teaching/upp-2023/week1/img/github-signup.gif differ diff --git a/src/teaching/upp-2023/week1/img/github-support-flagged.gif b/src/teaching/upp-2023/week1/img/github-support-flagged.gif new file mode 100644 index 0000000..58681c0 Binary files /dev/null and b/src/teaching/upp-2023/week1/img/github-support-flagged.gif differ diff --git a/src/teaching/upp-2023/week1/img/join-the-classroom.gif b/src/teaching/upp-2023/week1/img/join-the-classroom.gif new file mode 100644 index 0000000..f6da266 Binary files /dev/null and b/src/teaching/upp-2023/week1/img/join-the-classroom.gif differ diff --git a/src/teaching/upp-2023/week1/img/ready-to-go.gif b/src/teaching/upp-2023/week1/img/ready-to-go.gif new file mode 100644 index 0000000..2aca10b Binary files /dev/null and b/src/teaching/upp-2023/week1/img/ready-to-go.gif differ diff --git a/src/teaching/upp-2023/week1/img/u4-mat-hard.gif b/src/teaching/upp-2023/week1/img/u4-mat-hard.gif new file mode 100644 index 0000000..4d76b3f Binary files /dev/null and b/src/teaching/upp-2023/week1/img/u4-mat-hard.gif differ diff --git a/src/teaching/upp-2023/week1/img/u4-mat-hard.png b/src/teaching/upp-2023/week1/img/u4-mat-hard.png deleted file mode 100644 index d6dc77a..0000000 Binary files a/src/teaching/upp-2023/week1/img/u4-mat-hard.png and /dev/null differ diff --git a/src/teaching/upp-2023/week1/index.md b/src/teaching/upp-2023/week1/index.md deleted file mode 100644 index c60feb8..0000000 --- a/src/teaching/upp-2023/week1/index.md +++ /dev/null @@ -1,8 +0,0 @@ -# GitHub, Visual Studio и първата програма - УПП, Седмица 1, 06.10.2023 - -&&presentation -&&clide &¢ered - -# GitHub, Visual Studio и първата програма - -&&/centered &&/clide diff --git a/src/teaching/upp-2023/week1/setup.md b/src/teaching/upp-2023/week1/setup.md new file mode 100644 index 0000000..2e127de --- /dev/null +++ b/src/teaching/upp-2023/week1/setup.md @@ -0,0 +1,213 @@ +# Конфигуриране на GitHub classroom и Visual Studio - УПП, Седмица 1, 06.10.2023 + +&&presentation +&&clide &¢ered + +# Конфигуриране на GitHub classroom и Visual Studiо + +&&/centered &&/clide + + + +&&slide + +## Теория относно GitHub classroom + +Ще използваме активно GitHub classroom за упражненията. +Едва ли знаете какво е, затова ще трябва да поясня някои неща. + +### Проблемът със синхронизиране на работа + +- Системи като Dropbox, Google Drive, etc. ти позволяват да качиш файл в сървър и след това да го споделиш + +- Върху една програма ще работят много хора, затова се налага всички разработчици да споделят своят код + +- Различни хора могат да правят различни промени в едно и също място + +- Обединението на труда на всички, особено в огромни екипи, става супер трудно + +&&/slide + + + +&&slide + +### Git + +&&lineb1 + +git е програма (система) за [контрол на версиите](https://en.wikipedia.org/wiki/Distributed_version_control). +В един проект, git пази **списък от всички commit-и**. +Един commit в себе си съдържа информация какви са точно промените, кой ги е направил, кога са направени, защо са направени и так. нат. +Този списък, заедно с още неща за които не е нужно да мислите, се нарича **repository**. + +Обаче, **commit-ове не се правят автоматично**, не е като историята с промени в един Word файл. +**Commit се прави от разработчика**, и то за предпочитане на всеки няколко (свързани) промени. + +Така, когато смесваме кода от многото разработчици, ще можем да засечем **какви точно са различията** между работата на двама човека. +Често промените не си "противоречат" и могат да бъдат смесени директно, понякога се налага ръчно да решим какво точно да се случи с тези парчета код. + +&&/slide + + + +&&slide + +### GitHub + +&&lineb5 + +Всички списъци от commit-и трябва да се пазят някъде и да може лесно да се споделят и гледат. +Има много сайтове за тази цел, най-популярния се нарича [GitHub](https://github.com). + +Напомням, че git и GitHub са напълно отделни неща, направени от различни хора с различни функционалности. +Свързаността с имената е както свързаността между думите "чар" и "чаршаф". + +&&/slide + + + +&&slide + +### GitHub classroom + +&&lineb3 + +За всеки практикум ще ви направя линк, чрез който след малко кликане ще се създаде ново лично repository за всеки от вас. + +До 12:20 трябва да сте качили работата си **по време** на упражнението в това repository. +GitHub предоставя лесни начини да правите промени по файлове директно чрез браузъра, така че за незаинтересуваните, може да го ползвате като усложнен Google Drive. + +След това аз ще направя отзиви върху вашата работа. +Те ще се намират в таба "Pull Requests" на конкретното repository. +Четете ги, отговаряйте, целта е да дискутираме какво сте направили. + +&&/slide + + + +&&slide + +## Сега всички трябва да си направят GitHub акаунти + +Отивате на [github.com/signup](https://github.com/signup), въвеждате си данните една по една и се регистрирате + +![](./img/github-signup.gif) + +&&/slide + + + +&&clide + +След това, като влезете в акаунтите си (което става автоматично след регистрация), на заглавната страница ще имате нещо такова: + +&&width75 ![](./img/github-index.gif) &&/width + +В горния десен ъгъл, където е иконката с квадрати на бял фон, след натискане получавате sidebar. +От него, може да достъпите профила си, repository-та които имате, и так. нат. + +&&/clide + + + +&&slide + +### Проверете дали сте маркирани! + +Понякога при създаване на нов акаунт, GitHub го маркира (като "проблемен"). +В такава ситуация, няма да можете сами да го изтриете и няма да можете да го ползвате за GitHub classroom. + +Най-простия начин, който намерих, е да отворите +[support.github.com/contact/reinstatement](https://support.github.com/contact/reinstatement) +Ако отгоре пише "Your account has been flagged", тогава имаме проблем. + +![](./img/github-support-flagged.gif) + +&&/slide + + + +&&slide + +## Как ползваме GitHub classroom + +За всяко упражнение ще има отделен линк. +Този за днеска е: TODO + +&&lineb1 + +&&table + +След като го отворите, ще видите съобщение за разрешение, авторизирайте го. + +![](./img/github-classroom-authorize.gif) + +&&/table + +&&/slide + + + +&&clide + +&&table + +&&width60 ![](./img/join-the-classroom.gif) &&/width + +&&cont + +При първо влизане ще получите страница с имената и факултетните имена на всички студенти от групата. + +Изберете своето. + +Това се прави само веднъж, и след това никога пак. + +&&/cont + +&&/table + +&&/clide + + + +&&slide + +След това, би трябвало да видите страницата за "Приемане на заданието". + +&&width40 ![](./img/accept-assignment.gif) &&/width + +След като го приемете, на новата страница, изчакайте няколко секунди и презаредете. +Трябва да видите това: + +&&width40 ![](./img/ready-to-go.gif) &&/width + +&&/slide + + + +&&clide + +Сега сте готови, кликнете върху синия линк и ще стигнете във вашето GitHub repository. + +Вътре в това конкретно repository очаквам да качвате работата ви през упражнението. +Повтарям, дори да е недовършено, дори да има някакви празни файлове и такива, трябва да го качите. + +От тук най-лесния начин е да отидете на "Add file", "Upload files", да ги плъзнете върху страницата, и накрая да изберете "Commit changes". + +Който иска спокойно може да прави няколко commit-и, да им прави съобщения и так. нат., ама към този етап, това не е нужно. + +&&/clide + + + +&&slide + +В таба "Pull requests", още от началото, ще имате едно "Feedback". +В него ще ви връщам отзиви относно работата ви, и вие също можете да пишете неща и да ми отговаряте. + +Целта е да видя какво правите и да ви помогна, моля проверявайте какво съм ви писал, по подразбиране би трябвало да получавате известия на имейл-а. + +&¢ered &&width80 ![](./img/feedback.gif) &&/width &&/centered + +&&/slide -- cgit v1.3.1-26-gb76a