Overview

Teaching: 20 min
Exercises: 0 min

Questions

• Where are we heading?

Objectives

• See an existing repository in action.

• Browse the history.

• See the big picture first before we dive into details.

In-browser session

• We will explore and visualize an existing Git repository on BitBucket
• The goal of this episode is not to teach BitBucket, but rather to get a glimpse of the wider picture before going into the details.

Why

• Often our first contact with Git is an existing repository
• It’s good to see the social aspect to know what our end goal is.

Don’t Panic

• If you are new to version control, don’t worry about the details of the steps. Focus on what we can learn about the repository

Bitbucket demo

We’ll start with a very simple existing repository that contains a brief history from a couple of different people

• History
  • Explore the repository.
  • Explore the history and commits.
  • Note that there are branches.
• Reproducibility
  • Explore the ‘blame’ feature.
• Collaboration
  • You can refer to code portions (so much simpler to send a link rather than describe which file to open and where to scroll to).
  • Note the contributors.
• As a file source
  • We can create a local copy of all files in a repository through a clone
  • git clone https://bitbucket.csiro.au/scm/dat/programmatic-data-example.git

These features are all based on the core underlying Git system, that works independently of Bitbucket and is shared by other sites such as GitHub and GitLab.

GitHub demo

These lessons are themselves tracked through Git, but stored on GitHub (making use of the automatic webpage generation feature GitHub Pages).
Note that GitHub looks very different to BitBucket, but all of the same information and features may be found, with a click around.

We can see that this version of Git Intro lessons is a modified “fork” of an older version, which was itself a “fork” of other older versions. A fork is a full copy of a repository into a new repository, which retains full history but allows it to branch in its own separate direction, under separate control. We’ll discuss forks further later.

The bulk of these lessons are thanks to the Code Refinery and Software Carpentry Git lessons, also in their own Git repositories.

Key Points

• Bitbucket is a service that uses git and provides functionality to collaborate with other people

• We can browse the history of the contents of repositories and see who made which changes

• Other platforms like Github look different by employ the same fundamentals