Git Guide: Comprehensive Update

[nelsonic]

There is clearly a Gap in our Git/GitHub learning for beginners. 🔰 ⏳
We are seeing this (again) with @davcsj who is just starting his journey into coding ... 🧑‍💻

Last time we mentored a coding newbie they ended up getting stuck (a lot) on Git & GitHub:
https:/dwyl/apprenticeship/issues?q=is%3Aopen+is%3Aissue+git

As noted in: dwyl/apprenticeship#25 (comment) we have a section on Git + Github in the start-here/README.md#git

but that is clearly not enough to help beginners get over the initial hurdle. 😞

What we need is a clear checklist/roadmap of what beginners need to learn
so that they don't go down rabbit holes and off on tangents learning things they don't need.

So I'm thinking of repurposing this repo, which hasn't been updated in a while ...
https:/dwyl/github-reference

#discuss 💭

• Rename the repo from github-reference to git-guide for brevity? ✂️

• Update the tag line from:
  "GitHub reference for non-technical people following a project's progress"
  to:
  "Get good at git. Learn all you need to use GitHub effectively.

• Retain the "Non-technical" content; but ...

  • Update the screenshots to latest interface.

• Add a general section on registering for a GitHub Account.

• Computer setup! some of which is covered in https:/dwyl/dev-setup but it too is incomplete! 😞 (though I updated it a bit last year ...)

Todo ✅

• Revise the list of GitHub Features we use most often.
  • Search the org for a keyword 🔍
  • Comment on an existing issue. 💬
  • Open a new issue for the idea you have or problem you want to report. 🆕
  • Create a Pull Request to update a Repo on GitHub (without cloning to Computer)
• Prepare a short list of the useful git commands
• Clone a Repo to localhost both using ssh and https
• Create a new branch
• Create a change in the code/readme
• commit changes
• Push to GitHub.
• Create Pull Request based on the change.

Video? 📺

I feel like we should record a video (or a few) on this topic
and then capture the screens from the video for the written guide.

e.g: First video:
"Your first 10 minutes of GitHub and Git.
From registration, account setup, and basic interaction."

Second Video:
Your first contribution on GitHub Opening an Issue and making an update (pull request).

Third Video:
"Clone, Update, Commit, Push!"

Thoughts? 💭