Skip to content
This repository

Git In the Trenches

branch: master
Octocat-spinner-32 html Added links for downloads September 08, 2011
Octocat-spinner-32 images Minor changes to cover and section9 January 09, 2012
Octocat-spinner-32 scripts Added Week tags March 25, 2014
Octocat-spinner-32 .gitignore Some cleanup on make files etc August 29, 2011
Octocat-spinner-32 Makefile Mobi alteration July 03, 2012
Octocat-spinner-32 README.mkd README: ttf-linux-libertine needs to get installed as well August 20, 2011
Octocat-spinner-32 TODO TODO fixing August 28, 2011
Octocat-spinner-32 ack.tex Added Week tags March 25, 2014
Octocat-spinner-32 afterhours1.tex Removed blank lines affecting html conversion August 21, 2011
Octocat-spinner-32 afterhours2.tex Removed spurious right-brace February 18, 2012
Octocat-spinner-32 afterhours3.tex Removed blank lines affecting html conversion August 21, 2011
Octocat-spinner-32 afterhours4.tex Fix minor wording/typos January 07, 2012
Octocat-spinner-32 afterhours5.tex Use capital rather than capitol January 07, 2012
Octocat-spinner-32 afterhours6.tex More changes from the book proof (physical) September 16, 2011
Octocat-spinner-32 afterhours7.tex Fix wording/typos January 07, 2012
Octocat-spinner-32 afterhours8.tex Added a TODO item and finished AF8 August 02, 2011
Octocat-spinner-32 builder.sh Added builder - do not use unless you are me February 22, 2012
Octocat-spinner-32 chap1.tex Added Week tags March 25, 2014
Octocat-spinner-32 chap2.tex Added Week tags March 25, 2014
Octocat-spinner-32 chap3.tex Added Week tags March 25, 2014
Octocat-spinner-32 chap4.tex Added Week tags March 25, 2014
Octocat-spinner-32 chap5.tex Added Week tags March 25, 2014
Octocat-spinner-32 chap6.tex Added Week tags March 25, 2014
Octocat-spinner-32 chap7.tex Added Week tags March 25, 2014
Octocat-spinner-32 chap8.tex Added Week tags March 25, 2014
Octocat-spinner-32 chap9.tex Minor changes to cover and section9 January 09, 2012
Octocat-spinner-32 gitt.cls * Fixed symmetric bug with print edition. September 01, 2011
Octocat-spinner-32 gitt.tex Work on script to autodetect layout August 18, 2011
Octocat-spinner-32 index.tex Index always starts on rhs page. August 12, 2011
Octocat-spinner-32 intro.tex Small wording fix to final paragraph of intro January 07, 2012
Octocat-spinner-32 setup.tex Define Git version in setup.tex July 31, 2011
README.mkd

Git In The Trenches

Git In The Trenches, or GITT is designed to be a book that focusses on teaching people to use Git by associating with scenarios that are experienced by a fictional company called Tamagoyaki Inc. Through reading about their day to day lives, the reader will learn not only how to use Git, but why version control systems are important and how to implement them within an organisation.

Book Contents

The summary below shows a list of already complete chapters and items which are pending. GITT now covers all 21 of the most commonly used Git commands.

  1. Analysing VCS requirements
  2. Initialising a repo, adding files, removing files, committing, resetting
  3. Logging, diffing, tagging, viewing historical data
  4. Branching, merging, deleting branch, recovering branch, dealing with conflicts
  5. GUI usage
  6. Stashing, Cloning
  7. Networking, Rebasing
  8. Patching, Bisecting, Filterbranching, subtree, modules

After Hours

  1. History of version control, svn, cvs, git
  2. Simple Git internals, how commits are stored
  3. Indepth look at diff and how tags are stored
  4. Merging algorithms
  5. Splitting up commits, line by line, hunk committing
  6. Push and pull settings, reference discussion
  7. Instaweb
  8. Hooks

Building the Book

GITT is written using the LaTeX language to be able to generate the PDFs easily and without artifacts. If you wish to read GITT whilst it is in development phase, you have 3 options.

  1. Read the LaTeX source, which really isn't as bad as it sounds
  2. Use make pdf to use latex to build the pdf, you will need to have pdflatex installed for this
    • For ubuntu users, run sudo apt-get install texlive-latex-base texlive-latex-extra texlive-fonts-recommended texlive-xetex ttf-linux-libertine to get xelatex and the other files required to build
  3. An older PDF version of the book can be found here

Publishing

It is the intention of the author to make the book available freely online, and eventually offer a printed version via a self publishing site online. If someone out there thinks the book would do well to be published by a proper print publisher and can help make this happen, please get in contact. However the book will remain free online no matter what.

Contributing

The GITT project would love for people to branch off and make alterations to the text, or even start to create translations. Currently the book is written in LaTeX, but it isn't hard to learn. You can see the source files in plain text and edit them quite easily. Also, we are looking for situations in which you may have found yourself whilst using Git, whether you managed to resolve them or not. GITT is rather scenario based sometimes, so we need situations in which to place the employees at Tamagoyaki Inc. Spelling fixes are always welcome, as are general comments on the text itself.

Anyone who contributes will be added to the Acknowledgement section if they wish it. If I miss you out, please do not be offended, just nudge me gently :)

Something went wrong with that request. Please try again.