Navigating a GitHub Repository - Part 1

Опубликовано: 30 Апрель 2014
на канале: Data School

71,972

246

This is video #3 in the Data School series, "Introduction to Git and GitHub." Relevant links and the full transcript are below. Playlist: • Version control with Git and GitHub

== LET'S CONNECT! ==

Blog: http://www.dataschool.io
Newsletter: http://www.dataschool.io/subscribe/
Twitter: / justmarkham
GitHub: https://github.com/justmarkham

== LINKS RELATED TO THIS VIDEO ==

GitHub repository for ggplot2: https://github.com/hadley/ggplot2
Markdown basics: http://daringfireball.net/projects/ma...

== TRANSCRIPT ==

In this video, we're going to navigate a GitHub repository, so that you can understand the GitHub interface.

Right now, we're looking at the repository for the "ggplot2" package, which is an R package that you'll be using later in the Data Science Specialization. It was created by Hadley Wickham, who is probably the most well-known creator of R packages.

Anyway, here are the files being tracked. You can see that it uses a folder structure just like Mac and Windows.

You can click on any folder, and see the folder contents. You can also click on any file, and see the contents of that file. If it's a code file, GitHub will render it with bold and color and italics so that it's easier to read.

You can click "Raw" to see the plain text file as it was uploaded, or you can click "History" to see the history of changes to that file.

Let's go back to the main screen for the repository. There is often a special file in the root directory of the repo called "README.md." It's special because that file is automatically rendered on the main page of the repo, which you can see right here. The convention on GitHub is to always include information about the repo in this file.

If you click on it, you'll see the exact same rendered file. Again, you can click "Raw" to see the plain text file. The ".md" extension means that it's a Markdown file, which you will learn about later in the Specialization.

You can compare the raw and rendered files to see how Markdown works. For example, using the pound (#) symbol creates a header, and using asterisks (*) creates bullets.

In the next video, we'll walk through the rest of the GitHub interface.