Class: Intro to Version Control

Git is a distributed version control system, it can be used as a server out of the box. Dedicated Git server software adds access control, display the contents of a Git repository via the web, and help to manage multiple repositories.

GitHub is a Git repository hosting service, but it adds many of its own features. While Git is a command line tool, GitHub provides a Web-based graphical interface. It also provides access control and several collaboration features, such as wikis and basic task management tools for every project.

The workshop will be a mix of lecture and hands-on exercises.

Instructor

Sara Cope

• @saracope on Github
• @sarassassin on Twitter

Topics covered

• Command line basics
• What are Version Control systems?
• Git workflow
• Setting up repos
• Staging changes
• Committing changes
• Using & merging branches
• Using remote repos
• Contributing to a project on GitHub

Slides

Available on GitHub

Class connection

Join us on Slack, join the 'class--versioncontrol' channel

Social media

GDI Dayton on Twitter, Facebook, Instagram

Exercises

• Exercise 1
• Exercise 2

Resources

• For Windows users, download and install Git Bash
• Command line cheat sheet
• Command Line Power User video course by Wes Bos (free)
• Git cheat sheet
• Additional GitHub tutorial
• Command line customization with iTerm on Mac

Tech requirements

• Your laptop (Mac, PC, Linux) and charger
• A modern web browser (Chrome, Firefox, Safari)
• Recommend text editor: Visual Studio Code

Full setup (this project)

Some reveal.js features, like external Markdown and speaker notes, require that presentations run from a local web server. The following instructions will set up such a server as well as all of the development tasks needed to make edits to the reveal.js source code.

1. Install Node.js (4.0.0 or later)

2. Clone the repository

   $ git clone https://github.com/saracope/git-the-basics.git

3. Navigate to the folder

   $ cd git-the-basics

4. Install dependencies

   $ npm install

5. Serve the presentation and monitor source files for changes

   $ npm start

6. Open http://localhost:8000 to view the presentation

   You can change the port by using npm start -- --port=8001.

Folder Structure

• css/ Core styles without which the project does not function
• js/ Like above but for JavaScript
• plugin/ Components that have been developed as extensions to reveal.js
• lib/ All other third party assets (JavaScript, CSS, fonts)