General workflow:

• github.com :: make an account
• download git software (Windows; Macs usually have it already)
• fork a repository
• clone
• work
• add
• commit
• push / pull
• send pull request

Some command line commands

• pwd
  • shows you where you are on a drive (gives you path)
• ls / dir [on Windows]
  • shows everything in the your current location/folder
• cd <name of the folder>
  • takes you to that folder
• cd ..
  • takes you one level up in the tree structure of your computer

GitHub: Main Commands

• git clone <link>
  • clones/downloads a repository on you machine
• git status
  • shows the current status of the repository (new, changed, deleted)
• git add .
  • adds all new files and modified files to the repository
• `git commit -m “message”
  • saves all files in their current state into the repository, and created a milestone
• git push origin master
  • uploads changes to github.com
  • NB: sometimes you may get an error, which in most cases means that you need to pull first
• git pull origin master
  • downloads changes from github.com
• git log
  • shows the history of commits; here you can choose where you want to roll back, in case of troubles

Goals:

Learning about version control systems and how they help in the development of DH project, which are often a lengthy and complex, and require organic collaboration.

Software:

• create your github account @ https://github.com/

• Github

  • [Win] install from here: https://git-scm.com/downloads
  • [Mac] github is already on your machine
  • [Win] also install the desktop interface https://desktop.github.com/)

Tutorials:

• Complete Codecademy’s Learn Git https://www.codecademy.com/learn/learn-git;
  • if you’d like more practice, there is another one: https://try.github.io
• Also, add a page with this confirmation to the shared (forked site) and send me pull request