Skip to content

Latest commit

 

History

History
219 lines (170 loc) · 6.63 KB

github-foundations.md

File metadata and controls

219 lines (170 loc) · 6.63 KB
layout title description
workbook
GitHub Foundations Workbook
This student and teacher workbook will be your companion to the GitHub Foundations class taught by the GitHub Training Team and other educational groups. In this course, you'll learn basic collaboration skills towards a productive use of Git and GitHub in your open source work and daily job assignments.

Version control concepts

Summary

Details

Git is an open source distributed version control system invented by Linus Torvalds in 2005. It is used to version the Linux kernel and is shown to be, by some research, the most popular modern version control system.

Git is the open source, command line tool that forms a part of the workflows we'll cover in this course. It has been called the successor to CVS and Subversion by many users, and maintains some similarity in behavior to these historical open source version control tools.

Maintaining a current version of Git is important. While you'll accurately hear that Git is generously backwards-compatible, the latest versions offer error message enhancements, performance tunings, and usability features that make using Git ever more quick and pleasant.

Verifying that Git is installed and operational can be done by requesting Git to display its current version using this command:

$ git --version

git version 1.8.2

GitHub Installers

Details

The command line version of Git has a very light footprint. For most platforms, you can simply copy the binaries to a folder that is on the executable search $PATH. Git is primarily written in C, which means there is a unique installer for each operating system.

The GitHub platform

Details

GitHub accounts are free. Sign up for one at github.com/join.

GitHub is the repository hosting, collaboration, deployment, and distribution platform for both open source and private software projects. It facilitates discussing changes-in-progress through the concepts of Issues and Pull Requests and provides a web user interface to much of Git. The web flow made possible by GitHub brings a much wider range of contributors, including documentation specialists, designers, and ops engineers into the flow of contributing to your application's life cycle.

GitHub accounts are free for an unlimited quantity of public repositories. Only private repositories cost to host on the service. Private repositories are typically used for closed-source consulting client or corporate products, whereas public repositories are typically used for open source.

Sign up for a free GitHub account at https://github.com/join.

Git can be installed as a unified GitHub GUI and command line or merely as a stand-alone command line interface.

Interacting with repositories

Summary

Getting to know Git & GitHub

Summary

  • Repository initialization
    • New project and new repository
    • Repository based on existing content
    • Through web interface
    • Web interface and GUI client

Acquiring repos

Summary

  • Clone from web (Clone in Desktop button)
  • Clone via personal repo list in GitHub Desktop
  • Complete "copy" explanation

Version control basics

Summary

  • Commits
    • History marker for file(s), change(s)
    • Record of author, time, and message
  • Branches
    • Container for grouped commits
    • Simpler means to integrate change
    • Cleaner code review possibilities
  • GitHub, local repositories

GitHub repository interaction

Summary

  • Commits (GitHub.com)
    • Actionable steps (Create, Edit, Remove, Move)
    • Commit messages
    • Listing page on GitHub
  • Branches (GitHub.com)
    • Selection menu
    • Listing page
    • Comparison view

Local repository interaction

Summary

  • Changes (with text editor)

  • Comparison (diff via GHfD)

  • Commits

  • Branches

  • History

  • Syncing (GHfD)

  • Commits (GitHub for Desktop)

    • Managing file on system, reviewing results
    • Line-level tracking
    • Grouping files
    • Synchronizing local commits

  • Branches (GitHub for Desktop)

    • Create
    • Change
    • Publish

GitHub workflows

Summary

  • Forking
    • Guide to Forking
    • Reason for forks
    • What it encourages
    • How it insulates
    • Keeping up to date (too advanced?)
    • Original (base) and Fork (individual copy)
  • The GitHub Flow
    • Branch
    • Commit
    • Compare
    • Pull Request
    • Discuss
    • Animated GIF
    • Line by line code review conversation
    • Clone locally with GHfD (optional)

GitHub visualizations

Summary

  • Comparing/Diff-ing
    • Code
    • Prose
    • Images
    • Maps
    • Spreadsheets
    • 3D models
  • Branch view
  • Branch ahead/behind positions
  • Network graph
  • Activity graph

GitHub Wikis

Summary

  • Fast documentation authoring for repositories
  • Standalone repository
  • Easy access from repository navigation

GitHub Pages

Summary

  • Web page for your repository
  • Web page for your account
  • Author, edit, launch from GitHub

GitHub Features

Summary

  • Notifications
  • Watching repositories
  • Starring repositories
  • Gist
  • GitHub Flavored Markdown
    • Basics
    • Emoji
    • Checklists (Issues, Gists)

GitHub shortcuts

Summary

  • / command bar
  • ? help
  • t fuzzy file search

Project management basics

Summary

  • GitHub Issues
  • Milestones
  • Network
  • Pulse
  • Tags, Releases
  • Collaborators
  • Organizations
  • Teams

Special Repository Features of GitHub

  • Contributing.md
  • License.md
    • During repository creation
    • + a file with existing repository (special dropdown)
  • .gitignore
    • During repository creation
    • + a file with existing repository (special dropdown)
  • Readme.md
    • In root
    • In subfolders