***********************************
Version control with git and GitHub
***********************************


Intro and Objectives
====================

Learning the basics of version control with git and GitHub are pretty essential skills in the data science world. Once you learn to use version control, you'll wonder how you ever did without it. It provides tremendous peace of mind.

After doing the activities in this section, you will be able to:

* understand the basic concepts of version control and the use of git
* create git repos and use git to stage and commit changes
* review the history of changes and revert to old versions
* create remote repos in GitHub and push and pull between local and remote repos

   
Readings
========

* `What is git? How to use it. Why to use it <https://levelup.gitconnected.com/what-is-git-how-to-use-it-why-to-use-it-explained-in-depth-76a5066abaaa>`_

Downloads and other resources
=============================

You'll need this file for the screencast below.

* `downloads_git_intro.zip <https://drive.google.com/file/d/19fzuyU9TkFwb2E_ud5cadC5XFb-KNeky/view?usp=sharing>`_ 

Some other resources:

* `git cheat sheet <https://education.github.com/git-cheat-sheet-education.pdf>`_ (from GitHub)
* `git and GitHub videos for beginners <https://www.dataschool.io/git-and-github-videos-for-beginners/>`_ - Kevin Markham (Data School)



Activities
================================


* I've created an intro to git and GitHub that uses a simple Python project for the example. 

    - `SCREENCAST: Intro to git and GitHub <https://youtu.be/yoOEbYKo5yM>`_ (41:25)
    
If you have little or no experience with git, I also highly recommend that you:

* Read through the `Version Control with Git lesson <https://swcarpentry.github.io/git-novice/>`_ at Software Carpentry (up through using GitHub).



Explore (OPTIONAL)
==================

* `Version control for transparency and collaboration (from the RTWDS book) <https://ubc-dsci.github.io/reproducible-and-trustworthy-workflows-for-data-science/materials/lectures/02-version-control-1.html>`_
* `git - Getting Started <https://git-scm.com/book/en/v1/Getting-Started>`_- the git book
* `git - The simple guide <http://rogerdudler.github.io/git-guide/>`_
* `Step by step guide to contributing on GitHub <https://www.dataschool.io/how-to-contribute-on-github/>`_- Kevin Markham (Data School)
* `A successful git branching model <https://nvie.com/posts/a-successful-git-branching-model/>`_