HTML JavaScript CSS Ruby Shell
Latest commit 3ce4e99 Oct 23, 2017 @hectorsector hectorsector Merge pull request #606 from github/titles-es
Translate site and learning path title to Spanish
Permalink
Failed to load latest commit information.
.github replace {{site.baseurl}} with /on-demand when it was embedded in full… Aug 17, 2017
_data change Spanish learning path to _Itinerario de aprendizaje_ Oct 23, 2017
_includes Correct typos and name inconsistencies Sep 28, 2017
_javascript Update curriculum.js Sep 23, 2017
_layouts remove help banner from courses without repos Sep 29, 2017
_pages update to ghd beta Oct 28, 2016
advanced remove include-slides Sep 28, 2016
assets revert clustering img location Sep 13, 2017
downloads change title to div Aug 22, 2017
foundations change deprecation notice to be in layout instead of all index files Jan 26, 2016
glossary Create ja.yml Jun 13, 2014
images add new vs gif Sep 26, 2017
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
node_modules Add Primer, package.json Aug 21, 2017
paths add help link to spanish desktop course Oct 6, 2017
resources change Spanish learning path to _Itinerario de aprendizaje_ Oct 23, 2017
script remove existing _site folder as a part of script/server Sep 20, 2017
vendor/cache revert dependencies and configs Sep 13, 2017
.gitignore add easter egg for counting Sep 25, 2017
.gitmodules remove hydeslide dependencies from .gitmodules Oct 11, 2016
.travis.yml update ruby version for travis Aug 15, 2017
CODE_OF_CONDUCT.md make email address clickable Aug 24, 2017
CONTRIBUTING.md Add note for using/learning Primer in CONTRIBUTING Aug 23, 2017
Gemfile remove version of github-pages, needs to be most updated Apr 29, 2016
Gemfile.lock revert dependencies and configs Sep 13, 2017
LICENSE adding license to training-kit ported from on-demand Nov 18, 2016
README.md Merge branch 'master' into remove-baseurl Sep 1, 2017
Rakefile Readd Rakefile Aug 21, 2017
_config.yml add default page language Sep 21, 2017
community.md Merge branch 'master' into hollenberry/contributing-md Aug 25, 2017
index.html remove merge conflict Sep 28, 2017
index_es.html add spanish site title Oct 14, 2017
package.json Add Primer, package.json Aug 21, 2017
us-holidays.md update based on Hubber holidays Dec 7, 2016

README.md

servicesbanner

Build Status

GitHub Training Kit

Home of GitHub's On-Demand training

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 ❤️ Contributors Like You!

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 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.

🗺 Finding Your Way

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.

Our Content Philosophy

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.

Projects Used in Training-Kit

Building and Packaging

Building and Testing Locally

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 the scripts to rule them all!

To perform a build of the materials perform the following:

  1. Run script/setup
  2. Run script/server.
    • When successful, the script will initiate a local server at http://127.0.0.1:4000/on-demand/.
  3. Simply paste that into your favorite web-browser and you will be ready to test.
  4. You'll also need to run the following script to compile the SCSS (you can remove the watch flag if desired):
sass --watch assets/_scss/main.scss:assets/css/main.css

Packaging for Viewing Behind Your Firewall

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.

  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 advanced than others and can handle redirects, smart recognition of .html files, etc

Licenses

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.