This repository contains the completely open source on-demand training hosted at https://services.github.com/on-demand/. These materials are provided under a Creative Commons License license.
We’re eager to work with you, our user community to improve these materials and develop new ones. Here's how you can help:
- You spotted a mistake: please feel free to fork the repository and submit a change via a Pull Request (not sure how to do that? We have a course for you).
- You have an idea to make it better: we ❤️ new ideas! We invite you to open a new Issue if you want to talk about it, or you can fork this repository and submit your idea via a Pull Request.
- You just want to help: check out the open issues for projects you can tackle, review an open pull request, or check out the project ROADMAP.
For more information on contributing to this repository, check out our CONTRIBUTING guide.
This repository contains three primary resources:
- Our current on-demand courses can be found in the paths directory
- The translations of our popular Git Cheat Sheets can be found in the downloads directory. We're always looking for more. P.S. Right now the PDF generation is a manual process so please mention @github/services-training for assistance in getting your translation moved to the PDF.
- The recommended Training Path can be found here.
We are eager to create materials that are easy to use and follow! To that end, here are a few guidelines we ask you to keep in mind:
- We focus on providing clear, step-by-step instructions for completing an activity, giving the learner the opportunity to study the concept in greater detail with the Tell Me Why feature.
- We focus on minimalism.
- We use Jekyll and Markdown.
- The theme for the on-demand training is Minimal Mistakes and has some amazing documentation.
- The corner badge of an Octocat is from tholman.com
When you are ready to test your changes, you will want to build the repository locally. This is fully automated through a series of shell scripts based on the scripts to rule them all!
To perform a build of the materials perform the following:
- Run
script/setup - Run
script/server.- When successful, the script will initiate a local server at
http://127.0.0.1:4000/on-demand/.
- When successful, the script will initiate a local server at
- Simply paste that into your favorite web-browser and you will be ready to test.
- You'll also need to run the following script to compile the SCSS (you can remove the
watchflag if desired):
sass --watch assets/_scss/main.scss:assets/css/main.css
If you'd like to have a copy of the files to be served from a web server inside of your firewall, start by running script/package.
- Run
script/packageto create a release tarball. This will be in the formatrelease-XXXXXXX.tgzfor you to take wherever you want. - To test this looks okay, create some folders
mkdir -p test_site/kit. - Untar the release,
tar -xzf release-XXXXXXX.tgz -C test_site/kit. - Switch into the test_site directory,
cd test_site. - View the site with
python -m SimpleHTTPServer. Note: Some servers are obviously more advanced than others and can handle redirects, smart recognition of.htmlfiles, etc
Site content is licensed under CC-BY-4.0. CC-BY-4.0 gives you permission to use content for almost any purpose but does not grant you any trademark permissions, so long as you note the license and give credit, such as follows:
Content based on services.github.com/on-demand/ used under the CC-BY-4.0 license.
Code used to build and test the site as well as code samples on the site, if any, are licensed under CC0-1.0. CC0 waives all copyright restrictions but does not grant you any trademark permissions.
This means you can use the content and code in this repository except for GitHub trademarks in your own projects.
When you contribute to this repository you are doing so under the above licenses.