/training-kit

Open source slides, workbook, and cheat sheet courseware for teaching Git and GitHub classes
  1. CSS 63.2%
  2. HTML 23.0%
  3. JavaScript 7.2%
  4. Ruby 5.3%
  5. Shell 1.3%
CSS HTML JavaScript Ruby Shell
Find file
Latest commit 974966e Aug 11, 2016 @hectorsector hectorsector committed on GitHub Merge pull request #387 from github/update-nav 
Update nav on the HTML cheat sheets
Failed to load latest commit information.
_courses Remove local repo from first segment in Everyone Oct 27, 2015
_includes update nav with new paths Aug 10, 2016
_javascript Removed hypens from data mapping Mar 11, 2016
_layouts Revise URL to services.github.com/kit/ Jun 3, 2016
_modules Removed usage of "either" in list of file states. Oct 18, 2015
_stylesheets change deprecation notice to be in layout instead of all index files Jan 26, 2016
advanced remove slide captures from advanced Jun 6, 2016
assets Merge pull request #284 from github/diagram-fix Dec 16, 2014
downloads Fix broken link to GitHub Importer in Subversion to Git Migration che… Aug 10, 2016
foundations change deprecation notice to be in layout instead of all index files Jan 26, 2016
glossary Create ja.yml Jun 13, 2014
images Import curriculum files Jul 2, 2015
intermediate change deprecation notice to be in layout instead of all index files Jan 26, 2016
js Add jQuery in original Training web site location Sep 10, 2014
script Merge branch 'master' into switch-to-travis-ci-for-testing Jun 6, 2016
slides Convert all hard tabs to soft tabs (double space) Jan 5, 2015
vendor/cache update gems for github-pages being latest Apr 29, 2016
workbooks Fix a typo Jan 24, 2016
.bowerrc Add Bower Dec 5, 2014
.gitignore Script to create a release bundle Jan 9, 2014
.gitmodules Remove Bootstra-sass submodule in favor of Bower Dec 5, 2014
.travis.yml run script/cibuild instead for posterity and remove rbenv variable fr… Jun 6, 2016
CONTRIBUTING.md teach.github is dead, long live training-kit Jul 25, 2014
Gemfile remove version of github-pages, needs to be most updated Apr 29, 2016
Gemfile.lock update gems for github-pages being latest Apr 29, 2016
LICENSE.md Update from CC 3.0 license to CC 4.0 May 27, 2014
README.md Fix typo in "GitHub for Everyone" link Jun 12, 2016
Rakefile html-proofer isn't even used here Jun 7, 2016
_config.yml add a variable to store services parent site Aug 10, 2016
bower.json Add Bower Dec 5, 2014
index.html add link to ar cheat sheet Aug 11, 2016
license.html Add leading path hack due to solo and subproject deployments Sep 10, 2014

README.md

GitHub Training Kit

This is the official courseware for the GitHub Training Team. This repository provides open source materials and slides for teaching GitHub Classes under the CC BY 4.0 license.

We know that part of effectively sharing GitHub and Git with the world goes beyond our team's course offerings. We are pleased to provide you with this training kit that you can use to teach these same concepts at your company, for a user group, or at a conference.

Download

We know that many of the users of this repository are just focused on getting the materials and teaching from them. We've made that easy.

  1. You can view and teach from the kit, hosted on GitHub, at https://services.github.com/kit/.
  2. You can download the source files here.

Packaging for Viewing Behind Your Firewall

Sometimes you can't download the repository at work because of firewall rules, but you'd like to have a copy of the files that would be able to be served from a web server inside of these firewall rules. To do so, we need to use script/package.

  1. Run script/package to create a release tarball. This will be in the format release-XXXXXXX.tgz for you to take wherever you want.
  2. To test this looks okay, create some folders mkdir -p test_site/kit.
  3. Untar the release, tar -xzf release-XXXXXXX.tgz -C test_site/kit.
  4. Switch into the test_site directory, cd test_site.
  5. View the site with python -m SimpleHTTPServer. Note: Some servers are obviously more advance than others and can handle redirects, smart recognition of .html files, etc

Contribute

We’re eager to have your help in improving this kit. If you have an idea for a change, start by opening a new Issue so we can discuss and help guide your contribution to the right location. If you have corrections or kit contributions, we'd be glad to receive them via a Pull Request. For kit contributions, we ask you to share in our mindset of minimalism.

Class Material

GitHub for Developers and GitHub for Everyone are the two class types taught by the GitHub Training team. Their content is composed of several modules listed in the _modules/ subdirectory.

Cheat Sheets

The Git and GitHub Cheat Sheets are located within the downloads/ directory. There are some translations available and we're always looking for more. If you are looking to get a .pdf generated for the html version of a cheatsheet, please start an issue and @mention @brntbeer or @crichid and they will see to the request.

Legacy Class Material

This repository also contains our legacy course content. You can find these in the top-level directories:

File Format

The class materials are written in Markdown, a lightweight markup language supported in the GitHub web application user interface. There is a syntax guide to the original Markdown format and also GitHub Flavored Markdown.

The class material content possess two specialized uses of Markdown for slide-like rendering and formatting:

  • Full-screen slides are preceded with a --- and followed by ---

  • Step-by-step lab sections are wrapped with {% capture lab %} and {% endcapture %}{% include lab %}

    This repository is based on Hydeslides. That project offers additional information on the file and directory structure.

Build

The build of this repository is fully automated through several shell scripts. To perform a build of the materials identical to that of our continuous integration server, from the top directory of this project, run script/cibuild and then inspect the output in the _site directory.