Git Tutorial

Questions?  Go to the #infrastructure-deveops channel on Slack: Chat for E3SM

Teach Yourself git:

For those new to git, there is a wealth of information on the web.  

Here are a few of the E3SM Infrastructure team's favorite sites to start with:

Basic Git

• Official Git Documentation

• Git: the simple guide - includes pdf cheat sheet.

• Responsive cheat sheet

• Git for computer scientists - graphical intro to the Git data model

• Think Like a Git

• Visual Git Guide

• Git: Revision Control Perfected

Specific git features

• Interactive tutorial on branching

• Git Pretty what to do if you have a mess of development in your repo.

Here are a few sites that provide information on how to properly format commit messages. This step is very important because several git commands rely on this formatting.

• A note about commit messages

• Git commit messages (OpenStack)

• E3SM Commit and PR message template
  
  
  

E3SM-related Lessons

The Interactive tutorial on branching is an excellent resource.  We have created some exercises for workflow steps seen in E3SM

• Develop a new feature

• Integrate and graduate features

Hands-on Tutorials:

These are being organized on a volunteer basis by individuals at the labs.

LANL - @Doug Jacobsen (Unlicensed)

            Sildes: https://docs.google.com/presentation/d/1syVrLb-6F-DFcrlRKOVCfSm8-LfqEsF8e9gu-I8_6tE/edit?usp=sharing

LBNL - @Jeffrey Johnson (Unlicensed)  date/time/place

ANL - @Jed Brown (Unlicensed) Aug 6, 2014  / 3:30pm-5pm / Building 241, A323 (PDF slides)

The SE-team highly recommends using the hands-on tutorial material prepared by the Software Carpentry organization.

Miscellaneous Tips

Philip's Idiosyncratic Git Information Store (PIGIT) (including solution to X11 forwarding warnings)