(te/upp-2023/w1) Finished presentation slides about GitHub classroom

13 files changed, 214 insertions, 9 deletions

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
--- /dev/null
+++ b/src/teaching/upp-2023/week1/img/accept-assignment.gif
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
--- /dev/null
+++ b/src/teaching/upp-2023/week1/img/feedback.gif
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
--- /dev/null
+++ b/src/teaching/upp-2023/week1/img/github-classroom-authorize.gif
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
--- /dev/null
+++ b/src/teaching/upp-2023/week1/img/github-index.gif
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
--- /dev/null
+++ b/src/teaching/upp-2023/week1/img/github-signup.gif
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
--- /dev/null
+++ b/src/teaching/upp-2023/week1/img/github-support-flagged.gif
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
--- /dev/null
+++ b/src/teaching/upp-2023/week1/img/join-the-classroom.gif
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
--- /dev/null
+++ b/src/teaching/upp-2023/week1/img/ready-to-go.gif
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
--- /dev/null
+++ b/src/teaching/upp-2023/week1/img/u4-mat-hard.gif
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
--- a/src/teaching/upp-2023/week1/img/u4-mat-hard.png
+++ /dev/null
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 &&centered
-
-# 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 &&centered
+
+# Конфигуриране на 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".
+В него ще ви връщам отзиви относно работата ви, и вие също можете да пишете неща и да ми отговаряте.
+
+Целта е да видя какво правите и да ви помогна, моля проверявайте какво съм ви писал, по подразбиране би трябвало да получавате известия на имейл-а.
+
+&&centered &&width80 ![](./img/feedback.gif) &&/width &&/centered
+
+&&/slide