Setup

In this tutorial, you will learn Git by contributing recipes to a collaborative cookbook. The final result will be a shared recipe book featuring contributions from all participants. To do that, we are going to use a repository named Gitcook, with which you will interact exclusively through the GitHub web interface.

Recipes are something everyone is familiar with and the idea behind this was to create something that does not require any coding knowledge. Your contribution to this repository is essentially going to be just text. We are using .mdx files, which are Markdown files with some extended syntax for front-end components, but the required syntax is straightforward and easy to learn.

All participants will be invited to join the empa-scientific-it GitHub organization. We are then going to add you to a specific group of contributors with limited access rights. For security and quality assurance, all pull requests will require approval from maintainers before merging.

No code knowledge required

Based on experience, when starting to learn Git, it is easier to start without coding examples. For this reason, in our tutorial we will use only text files, since code is ultimately just text.