Git intro lesson de-design discussion

# Git intro lesson de-design discussion :::info This note: https://hackmd.io/@coderefinery/git-lesson-redesign These are notes from https://hackmd.io/@coderefinery/in-person-retreat-2024 ::: - Notes: - We want people to be able to start to collaborate in a project in Git(Hub), sync stuff in/out GitHub, and do branches - Stephan: - Metaphors should be so generic that they can apply to literally everyone e.g. inheritance in OOP can be explained using a family tree. - Some potential metaphors - Time Machine - Photo album - A detailed diary that documents your project (you can go back to any page to see what you did there) - We need to be able to explain git in a short introduction so that people not familiar with git at all. - Tie in with a metaphor (as previously mentioned) then create a visual (ideally a video, but could also be an image) to explain that metaphor. - Ask in icebreaker for the git section what the students are expecting to learn about git. - SR - Define the audience - Rather than one course for all, there should be at least two intros - For whom GIT would be usefull - Day 1 and 2 should be modularized so that they could be swaped without effort. +1 - How others are doing this - watch some youtube videos with lot of views - Oversimplificaiton should be done with care, this should be a balanced aproched. - For teacher it is aloso importent to undestand the full landscape when making such decisions - https://explorer.globe.engineer/?q=workshop+on+Git - https://explorer.globe.engineer/?q=Git+interafces+ - Git instaltion on Windows11 - https://www.simplilearn.com/tutorials/git-tutorial/git-installation-on-windows#git_installation_on_windows - Better metaphors, less programming centric. - YL: might come to problems about initializatio of `git bash` from window users - classify lesson materails into different levels: introductory, intermediate, advanced. - mermaid graph chart for lessons: https://hackmd.io/@yonglei/mermaid-enccs-lesson - markmap graph chart for lessons: https://hackmd.io/@yonglei/markmap-enccs-lesson - MJ: Maybe revise what's in GitHub get-started instructions ie. get the account and check your email - If we do the change, then "archive" current lesson on a branch and web-serve it - Day3: could have branch design lesson especially if there's too much time - Target audiences and their needs - coders, future git power users - Need: Git masterclass with all scenarios, can do cmdline - general ppl who are interested in version control: - concepts, empowering, visuals - for some inspiration illustartion https://allisonhorst.com/git-github - We have [GitHub without commandline ](https://github.com/coderefinery/github-without-command-line/tree/master) - RB follow-up: define learner personas and modularize. - - Session executive summary: - we think the suggested changes would be an improvement but they would need to be worked out in more detail - we are concerned about doability in terms of preparation time and in doubt post-pone to future - try to modularize to make it possible to re-shuffle and choose - we need to think and elaborate a bit more before we commit to implement this change