5 Git interactive hands-on workshop
5.1 Session Introduction
In this session, we will build on the previous ‘Introduction to Git
’ session. You will get hands-on experience using Git
, applying some of the tools presented in the context of a hypothetical project. You’ll find the setup instructions, materials and slides for this session below.
5.2 ICPE 2024 Slides
5.3 Workshop Materials
The following section provides details on the necessary setup steps for participating in this workshop.
5.3.1 Software Installation
You will need to install Git
(and optionally GitHub Desktop, if you do not plan to follow along using the command line):
Main
Git
website to download (with guides for Mac, Windows and Linux) and learn more aboutGit:
https://git-scm.comGitHub Desktop App: https://desktop.github.com/
5.3.2 Git Configuration
On first-time use, name and email address are required to configure Git
. This differs by whether you are using command line or GitHub Desktop
GitHub Desktop: You will be prompted to configure
Git
when first opening the application.Command Line: You will need to type the followiing into the console (updating to your login details):
git config --global user.name "<username>"
git config --global user.email xxx@example.com
5.3.3 GitHub Account
To participate in the workshop you will require a GitHub account. If you have an existing GitHub account, you can use this.
Otherwise, please create one following the steps below.
- Visit GitHub.
- Click the “Sign up” button.
- Provide an email address and password.
Note: More generally, we recommend that you setup two-factor authentication to secure your account. (This is not essential for the workshop).
5.3.4 Files
- Please download the following two files:
5.3.5 Questions
During the session, you are welcome to post questions in this Google Document (which the tutors will monitor).
5.4 Additional Resources
Weberpals, J. & Wang, S. V. The FAIRification of research in real-world evidence: A practical introduction to reproducible analytic workflows using Git and R. Pharmacoepidemiol. Drug Saf. (2024)
Morton, C. et al. Software development skills for health data researchers. BMJ Health Care Inform. 29, e100488 (2022).
Bryan, J. Excuse Me, Do You Have a Moment to Talk about Version Control? PeerJ Preprints (2017)
Webpages:
- Comprehensive Documentation for Github Desktop
- Cheatsheet with common
Git
commands: - Git manual by Atlassian (provider of the
Bitbucket
platform) - Coursera courses:
- Introduction to Git and GitHub (Google)
- Version Control with Git (Atlassian)
- Getting Started with Git and GitHub (IBM)