Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Let’s Git It

Let’s Git It is FOSS MEC’s beginner workshop on Git, GitHub and contributing to a real project. This library is the practice ground: every exercise uses the same repository that publishes this website.

What you will be able to do

By the end of the workshop you should be able to:

  • explain the difference between Git and GitHub;
  • fork a repository, create a branch and commit a change;
  • open a pull request and respond to review;
  • add a Markdown note or an external resource to this library;
  • find the site’s source file from the Suggest an edit link.

You do not need to install anything. Everything can be done in a browser.

Before you arrive

  1. Create a free GitHub account and verify your email.
  2. Bring a laptop or a phone with a browser. A laptop is easier for file uploads.
  3. Read the contribution paths for two minutes.
  4. Optionally install Git locally if you want to practise the command line.

Workshop route

StepTimeWhat happens
1. Concepts10 minRepositories, commits, branches, forks, pull requests
2. Tour10 minThe library structure and the browser-only GitHub editor
3. Quickstart15 minFork → edit → commit → pull request
4. Exercises25 minPick one task from the exercise list
5. Review10 minRead a partner’s PR and leave a kind, specific comment
6. Merge and deploy5 minA maintainer merges; GitHub Actions publishes the site

Start here

Ground rules

  • One small change per pull request. Small PRs are reviewed faster and teach more.
  • Do not edit src/SUMMARY.md unless you are adding a new chapter. Most fixes do not need it.
  • Only upload what you wrote or are allowed to share. State the licence in the PR.
  • Be kind in review. Critique the change, not the person.
  • Ask early. Open an issue or ask a maintainer if a step fails; do not guess around a permission error.

After the workshop

Continue with the Git Essentials guide and Collaborating on GitHub. Then pick a good first issue and keep contributing.