Skip to content
Opscode Chef Fundamentals training materials
CSS Ruby JavaScript
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


gem install bundler
bundle install
cd slides
showoff serve

Browse to localhost:9090

Installed Gems

The source materials in the slides directory are set up as a showoff project. As such, the showoff gem is required. In order to generate PDFs with showoff, the pdfkit gem is installed.

Also, the instructor lab setup will use Chef and the Knife EC2 plugin, so those gems are included as well.

Do not commit Gemfile.lock to the repository.

Slides Directory

Most of the action happens in the slides directory.


The slides/Rakefile has a task to set up the directory and an initial file for the specified section.

rake mksection SECTION=just-enough-ruby-for-chef
** Creating section just-enough-ruby-for-chef **
- populating

This does not add the section to showoff.json. When contributing a new section, do not add it to the showoff.json file, as that should be reviewed before modifying the base course for everyone.

Slide Style Guide

This is spartan and will be embellished.

  • Create sections as directories.
  • Use PNGs for images.
  • Directory names should be lower case words as a title, "getting-started"
  • Each directory should have a, multiple sections may be broken up later.

Guides Directory

See the guide in the guides directory for information on how to set up the lab environments for students to use in the hands on portion of the course.



See CONTRIBUTING for information on how you can contribute changes to these materials.

License and Authors

See LICENSE for licensing of these materials and how you may use them.


Joshua Timberman Aaron Peterson

Something went wrong with that request. Please try again.