Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

69 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Git Talk Slides

Project Description

A presentation for introducing scientists and engineers to git. This talk is designed to be given with a short quiz and a short practicum and meant to be done all in under an hour.

There are images, a slide template, and a markdown file for turning the main content into a powerpoint slide deck. The practicum and quiz can also be rendered as a powerpoint slide deck. Additionally there are html renderings of the content so that the talk can be given from a browser if desired.

An abstract is provided to be used when scheduling or otherwise describing the talk. Likewise a handout is provided, for getting email addresses of attendees and to print the repo URL to be cut into little strips that can be handed out.

HTML Rendering of slide decks

Abstract

What do I git out of it? This introductory talk provides scientists and engineers with a practical overview of Git and modern version control concepts, focusing on how Git supports reproducibility, collaboration, traceability, and safe experimentation in technical and research environments. Rather than treating Git as a tool only for software developers, the presentation demonstrates how version control can improve workflows for simulations, data analysis, documentation, manuscripts, configuration files, and long-running engineering or scientific projects. Attendees will learn the core ideas behind repositories, commits, staging, branching, merging, and synchronization, along with the most important commands needed to begin using Git effectively. The talk also introduces common collaboration workflows, discusses limitations such as handling binary files, and highlights best practices for organizing changes into meaningful, reproducible project history.

Quick Start

To convert the content into a slide deck, you must first have a powerpoint template and an installation of pandoc available. This repository includes a sample template.

pandoc is available via conda-forge

$ conda create --name pandoc-env python=3.14 # Create a new environment (optional)
$ conda activate pandoc-env # Activate your environment
$ conda install -c conda-forge pandoc

The conversion command is as follows

$ pandoc git_out_of_it.md -t pptx --reference-doc=template.pptx -o git_out_of_it.pptx -f markdown+hard_line_breaks

For the other markdown files, the commands are essentially the same

$ pandoc quiz.md -t pptx --reference-doc=template.pptx -o quiz.pptx -f markdown+hard_line_breaks
$ pandoc practicum.md -t pptx --reference-doc=template.pptx -o practicum.pptx -f markdown+hard_line_breaks

To convert the handout to a pdf for printing

$ pdflatex handout.tex

More Information

To learn git more thoroughly, please visit Software Carpentry's git novice lesson.

For a visual learning tool see Learn Git Branching.

If you'd like to learn by playing a game, visit Oh My Git.

Author Info

About

A presentation for introducing scientists and engineers to git. This talk is designed to be given with a short practicum and meant to be done all in under an hour.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages