![gnugen logo](assets/gnugen_white_trans.svg) # just do *git* *Introduction*
## Slides Available at: [gnugen.ch/en/guides/](https://gnugen.ch/en/guides/)
## Please help us improve! There will be a short survey at the end of the presentation
## Table of contents * [About gnugen](#about-gnugen) * [Git Overview](#overview) * [How (g)it works](#how-git-works) * [Basic commands](#basic-commands) * [Basic workflow](#basic-workflow) * [Command Summary and Reference](#commands) * [Some practice](#some-practice)
# About gnugen

Who are we?

Promote free/libre software on the EPFL campus

free/libre software

Four fundamental freedoms

  • freedom to use: freely run parts of a program or not
  • freedom to study the source code
  • freedom to share the program
  • freedom to improve the program

free/libre software

But why?

  • Respect for the user
  • Accessible, inclusive
  • Privacy
  • Many more...

what does that mean for me?

  • Events (Just do Git)
  • Want to talk about free software?
    • We have Matrix / Telegram chats rooms
  • Need help installing Linux?
  • Need help with linux or other free software?

contact us! gnugen.ch/en/contact

# Git Overview
## What is git? ![git logo](assets/git-logo.png)

What is git?

Git is a distributed version control system.

  • distributed
  • version control
## Why use git?

What is GitHub / GitLab?

provide functionality around git mostly for collaboration

  • git repository
  • issues
  • pull requests

What is GitHub / GitLab?

Stay tuned to get some practice!

# How (g)it works

Commit

  • are like snapshots
  • contain changes since commit before
  • go back in time: you can see how your project looked like at every commit
![git commit illustration](assets/commit.svg)

Branches

  • are like pointers to only one commit at a time
  • switch between branches to work on different things without interferance
  • especially useful when some incomplete changes make a project broken/not build/etc
  • also especially useful when collaborating
![git commit illustration](assets/branches.svg)

Merge

  • combines two branches
  • by integrating the features of one branch into the other branch
  • can be done in the form of a merge/pull request on GitHub/GitLab
![git commit illustration](assets/merges.svg)
# Basic commands
List files inside of a folder : ``` jonatan@gnugen:~ $ ls 'cool text.txt' Desktop Documents Downloads ``` ![Folders and files inside of a folder](assets/folder.png)
Print the current folder's path : ``` jonatan@gnugen:~ $ pwd /home/jonatan ``` ![Print the current working directory](assets/pwd.png)
Go into a folder : ``` jonatan@gnugen:~ $ cd Documents jonatan@gnugen:Documents $ pwd /home/jonatan/Documents/ ```
# basic workflow

Start working on a new project

New local project: ```bash $ cd your/project/directory $ git init ```
Existing repository on GitLab/GitHub: ``` $ cd directory/to/put/the/project/in $ git clone <your projects repository url> ```

prepare changes of a file for the next commit

`git add` selects which files and changes you add to your next commit: ```bash $ git add myfile.txt ```
check what is "staged" for the next commit: ```bash $ git status On branch main Changes to be committed: (use "git restore --staged <file>..." to unstage) modified: myfile.txt ```
## create a commit (i.e. snapshot) ```bash $ git commit -m "added some lines to myfile.txt" ``` the commit message (`-m`): a place to write what you've changed
## push your changes to GitHub/GitLab ```bash $ git push ```

Representation of these steps

But why is the image cut?

# collaborative workflow

This is why!

by https://github.com/pushpankq/Git-Commands-
# collaborative workflow ## coming soon... come to our upcoming events about git to learn more about git, how to use it to collaborate efficiently and handle common mistakes [gnugen.ch](https://gnugen.ch)
# Command Summary and Reference

Summary of basic commands

  • git add, git commit: create a commit
  • git status, git log, git diff, git show: show status and changes

Handling branches

  • checkout
  • merge

Using git with other people

  • pull
  • push

Handling small mistakes

  • commit --amend
  • reset HEAD^
# Some practice

Your choice!

  • a game to practice
  • setup of git and gitlab/github on your computer
## Some practice with ## Oh My Git! - open [ohmygit.org](https://ohmygit.org/) - click on the button labelled "Download the game!" below "Play the game!" - and follow the instructions for your OS
## Setup of git and gitlab/github - GitLab tutorial is on [gnugen.ch/en/guides](https://gnugen.ch/en/guides/) - linux with your favorite package manager - macos with [brew](https://brew.sh/) or Xcode - windows with [git bash](https://gitforwindows.org/)

But first

Thank you!

just do git



Survey: