git for science

A workshop about how to use git for managing science tasks. Or 'how to spend less time hunting for the last working version; and keep track of collaborative works'

nb EGU timeslots are 1.5 hours but we can ask for as long as we need. How long should this course be? 3.5 hours?

workshop overview and goals [10min]

What is revision control? Why should we use it as scientists?

Learning expectations:

1. Have an understanding about how version control can help you
2. Create a repository
3. Push and pull content to the repository
4. Pull a specific version of content
5. A short practice at community collaboration

git overview [15 mins]

• what is revision control?
• What is git?
• installing git (make this a prerequisite?)
• ways to use git
  • command line (this workshop)
  • GUI (provide links)

case 1: your awesome science function [30 mins]

• working with code:
  • create a repo
  • push code
  • make local changes
  • commit revisions
  • tag working versions

case 2: your Nature Geoscience paper [30 mins]

• construct a paper in a revision friendly way (need help here: I can see how LaTEX would work here.. or markdown.. anything else?
• push your changes
• work with a collaborative team

discussion [20 mins]

For example, 'i like git but githubs corporate policy is awful.. how can I do revision control?' (eg gitlab instance, uni-hosted repos etc). In my day to day life I use locally hosted git instances, and you'd probably want to do that for your Nature Geoscience paper too...

ideas

• use this repo to work on examples
• existing materials - happy to use them if you're happy to share them!
• help from git ninjas appreciated - especially in branch merging (something we could demonstrate here... but that may be too much)

format?

• short course (2 hrs I think?) or splinter session