Materials and links for hands-on portion of Git/Github/Bitbucket Tutorial on August 14 at EPA R/DDES workshop.
- Install Git
- Get a Github account
- Get off the beach!
Git has myriad features which -- though extremely powerful -- can be very confusing (especially for those of us who last used a command line in the 1980s). The goal here is to give you just enough experience to start using Git day-to-day. Then you can explore more advanced corners of Git as you need them. We also tried to include enough here that if you have the basics down you may still find something to challenge yourself.
Keeping the pieces straight, and how EPA uses them, can be confusing. Git is software that needs to be installed on your computer. Github and Bitbucket are remote locations that are used for collaboration. EPA has both a Github account and a Bitbucket server that you can use to collaborate on code. The general roles are:
- Github: public repos and collaboration outside EPA
- Bitbucket: private repos and collaboration inside EPA
The instructions here are focused on using Github, but there are supplementary materials focused on EPA Bitbucket here
Please take some time prior to the workshop to get some pre-requisites in place. It will be much more challenging to participate in the workshop if you don't have the necessary software. In particular, you need:
- Install Git (this may already have been pushed to your machine)
- A Github account
- Know where to find your command line
Head on over to the setup file to get the details.
One of the biggest reasons to use Git is to access, re-use, and contribute to open source code. True to this goal, these materials seek to re-use material out there from our favorite existing tutorials. We either link out or adapt with minor additional EPA-specific or windows-specific commentary.
We are particularly indebted to Jenny Bryan's Happy-Git-with-R book and materials
For more advanced tasks the Pro Git book, by Scott Chacon and Ben Straub is a good source.
Another great resource is the video series Learn Git with GitKraken on Youtube.
- Pre-Workshop Setup and Installation
- Practice: pull, edit, commit, push (and repeat)
- Collaboration workflows
- Exporing repo history
- Git automation
In the ideal world, all the pre-workshop setup can be accomplished prior to the session. Then during the hands-on part of the workshop people can choose where to spend their time. I imagine those new to Git might just work on #2, while more advanced users might find something of interest in the other sections. We wanted to make sure no one would be bored.
The United States Environmental Protection Agency (EPA) GitHub project code is provided on an "as is" basis and the user assumes responsibility for its use. EPA has relinquished control of the information and no longer has responsibility to protect the integrity , confidentiality, or availability of the information. Any reference to specific commercial products, processes, or services by service mark, trademark, manufacturer, or otherwise, does not constitute or imply their endorsement, recommendation or favoring by EPA. The EPA seal and logo shall not be used in any manner to imply endorsement of any commercial product or activity by EPA or the United States Government.