Summary and Schedule

What We Will Try to Do

Begin to understand and use Git and Codeberg. You will not be an expert by the end of the class. You will probably not even feel very comfortable using Git. This is okay. We want to make a start but, as with any skill, using Git takes practice. In this lesson we use Git from the Unix Shell. Some previous experience with the shell is expected, but is not mandatory.

Be Excellent to Each Other

• If you spot someone in the class who is struggling with something and you think you know how to help, please give them a hand. Try not to do the task for them: instead explain the steps they need to take and what these steps will achieve.

Be Patient With The Instructor and Yourself

• This is a big group, with different levels of knowledge, different computer systems.
• This isn’t your instructor’s full-time job (though if someone wants to pay them to play with computers all day they’d probably accept). They will do their best to make this session useful.
• This is your session. If you feel we are going too fast, then please put up a pink sticky. We can decide as a group what to cover.

Prerequisite

Prerequisites

1. Set up a Codeberg account (see Setup)
2. Install Git on your own computer

	Setup Instructions	Download files required for the lesson
Duration: 00h 00m	1. What is Git/Codeberg?	What is Git? What is Codeberg?
Duration: 00h 10m	2. Getting started with Git	What are repositories and how are they created? What do add and commit mean? How do I check the status of my repository?
Duration: 00h 35m	3. Sharing your work	How can I use Git and Codeberg to share my work? How do I link a local Git repository to Codeberg? How do I move changes between a local Git repository and a Codeberg repository? How can I see the differences between my current file and my most recent commit?
Duration: 01h 50m	4. Review	How can I cement my understanding of Git’s functions?
Duration: 02h 15m	5. Codeberg Pages	What is Codeberg Pages? How can I use Codeberg Pages to collaborate and share my work?
Duration: 02h 55m	Finish

The actual schedule may vary slightly depending on the topics and exercises chosen by the instructor.

Installing Git

---

Since several Carpentries lessons rely on Git, please see this section of the workshop template for instructions on installing Git for various operating systems.

• Git installation on Windows
• Git installation on MacOS
• Git installation on Linux

Creating a Codeberg Account

---

You will need an account for Codeberg to follow this lesson.

1. Go to https://codeberg.org and follow the “Register” link at the top-right of the window.
2. Follow the instructions to create an account. Your username will be part of the addresses of your repositories and websites (for example https://yourname.codeberg.page/), so choose it with care.
3. Verify your email address with Codeberg.
4. We recommend to configure two-factor authentication (see below).

Codeberg is a non-profit platform for free and open content. Please have a look at its Terms of Use before using it for your own projects.

Two-factor Authentication

Codeberg does not require two-factor authentication (2FA), but it is a good idea to enable it for extra security. You can use an authenticator app on your smartphone, like FreeOTP or Aegis, or a hardware security key like a Yubikey. The Codeberg documentation explains how to set it up.