Introduction to GitHub

Welcome!

This 3-hour workshop is a gentle introduction to using GitHub for managing and working with files. It is designed for doing participatory live-typing, where the teacher demonstrates the tasks on their computer connected to a projector while learners type along on their own computer. The workshop also includes reading tasks, discussion activities, and hands-on exercises.

This website contains all of the material for the workshop, including readings, exercises, presentations, live-typing material, and images. It is structured as a book, with “chapters” as sessions, in order of appearance. We make heavy use of the website throughout the workshop where “type-along” sessions almost identically follow the material on the website (with slight modifications for time or more detailed explanations).

Check out the overview section of the workshop, starting with the Syllabus.

If you plan on attending the workshop, please make sure to complete the Pre-workshop tasks to get set up and ready for the workshop. The pre-workshop tasks include a survey that you need to fill out before the workshop starts.

⭐ Do you find this workshop material useful? Please consider “starring” our GitHub repository to show your appreciation! Starring will save it to your list of saved repositories, so it’s easy to find again later. As a plus, it helps give our project more visibility! 🌟

Target audiences

This website and its content are targeted to three groups:

1. For the learners to use during the workshop, both to follow along and also to use as a reference after the workshop ends. A more detailed description of who the learner is can be found in Is this for you?
2. For the teachers to use as a guide for when they do the type-along sessions.
3. For those who are interested in teaching, who may not have much experience or may not know where to start, to use this website as a guide to running and teaching their own workshops.

Re-use and licensing

The workshop material is licensed under the Creative Commons Attribution 4.0 International License, so the material can be used, re-used, and modified, as long as there is attribution to this source. Check out the CONTRIBUTING guidelines and the For teachers section for more details and tips on using this material.

Contributing

Want to contribute to this workshop? The easiest way to contribute is by creating a GitHub issue to make comments and give feedback on the material. Make sure you check out the README file and the CONTRIBUTING guide for more details.

How the website is made

The workshop material is created using Quarto to write the material and create the book format, GitHub to host the Git repository of the material, and GitHub Actions with Netlify to build and host the website. The original source material for this workshop is found on the github-intro GitHub repository.