git for (collaborative) writing
DESCRIPTION
Git is an amazing source control version system for writing. It allows you keep track of the modification and collaborate with a large number of people. Platforms such as bitbucket or github make it straightforward to use.TRANSCRIPT
Git for (collaborative) writing
Arnaud Joly
Systems and modelingMontefiore instituteUniversity of Liège
November 25, 2013
1. Version control with automatic conflict management2. Collaborative writing3. Trying out new things is easy with branches
By the way,I free and open source.I free online backup with GitHub or Bitbucket
1. Version control with automatic conflict management2. Collaborative writing3. Trying out new things is easy with branches
By the way,I free and open source.I free online backup with GitHub or Bitbucket
A story told through version control
Unique identifier Modification descriptioncommit 0 Add first readmecommit 1 Add .gitignore: ignore generated file by latexcommit 2 Add Makefile: latex buildcommit 3 Presentation startcommit 4 Ignore build directory and generated pdfcommit 5 Set a first outlinecommit 6 Add where to get help sectioncommit 7 Refine outlinecommit 8 3 stories for version control + sketch first story
. . .
Demonstration on this online repository: click here
Menu:I Show the sourcesI Show the time lineI Show a file diff
Demonstration with a collaborative paper on a repository:click here
Menu:I Show the time lineI Show the issue ticket
Case study : writing a syllabus
We would like1. to label important versions.2. to switch between different
versions.3. to merge two different
versions.
Demonstration on a collaborative paper: click here
I Show a branch on bitbucket or Github: pull request systemsI Show the branch graph
Git for (collaborative) writing
Arnaud Joly
Systems and modelingMontefiore instituteUniversity of Liège
November 25, 2013
Where to start learning Git ?
I In a terminal, try "git help".I A fast and interactive tutorial is Try Git.I The git reference is Pro Git (see chapter 2, 3 and 5).I Scipy development workflow is nice for software development.
References
I Scipy lecture note http://git-lectures.github.io/I "Pro Git" by Scott Chacon Creative Commons 3.0I Euroscipy on Git http://git-lectures.github.io/I Software carpentry for slides on collaborative writing.