Curriculum for RailsBridge workshops
Ruby CSS JavaScript HTML
akanshmurthy and rachelmyers Testing curriculum fixes (#625)
* update curriculum based on event feedback

* Add example with receive and not times

* Make matchers description more conversational
Latest commit dca0930 Mar 16, 2018
Failed to load latest commit information.
assets Restore missing orange color on Ruby curriculum 'challenge' headers Feb 5, 2016
lib fix up JS snake game instructions Oct 14, 2017
locales Site index dropdown contains categories like on docs.step Jul 10, 2014
public add bootstrap grid tutorial Sep 7, 2015
sites Testing curriculum fixes (#625) Mar 16, 2018
spec Convert `assert_loosely_equal` helper into an RSpec matcher Feb 9, 2016
.gitattributes Add gitattributes file to force line endings as LF Jun 8, 2013
.gitignore Fix broken "To-Do List" link to point to "Volunteer Opportunities List" Feb 6, 2016
.ruby-version Run the docs on Ruby 2.3.3 now that there's a Railsinstaller version … Dec 31, 2016
.travis.yml Run the docs on Ruby 2.3.3 now that there's a Railsinstaller version … Dec 31, 2016 Updating to reflect GitHub's changes to a guide and a… Jul 23, 2016
Gemfile Run the docs on Ruby 2.3.3 now that there's a Railsinstaller version … Dec 31, 2016
Gemfile.lock bump gems Mar 14, 2017 added CC-BY and MIT license to README and LICENSE files Jan 10, 2014
Procfile Add a Procfile so heroku will stop warning about using Webrick Oct 6, 2014 Recommend `bundle exec rake` whenever `rake` is being invoked. Aug 14, 2015
Rakefile Fix typos and some minor syntax things found by RubyMine inspections Jun 18, 2014
app.rb Add frontend starter assets for frontend curriculum Mar 7, 2016 introduce locale (as sites subdir and optional param), and... Feb 8, 2014 Remove OSX Panther instructions Jan 18, 2015

The RailsBridge Documentation Project

Build Status


This is a Sinatra app, deployed at The RailsBridge documentation project is home to a few subprojects, including the RailsBridge installfest instructions, which leads students through the various complicated setup instructions for getting Ruby, Rails, Git, etc. installed on their computer (whatever combination of computer, OS, and version they happened to bring to the workshop!), as well as the RailsBridge workshop "Suggestotron" curriculum.

Each subproject (a "site") comprises files stored under the "sites" directory; for instance, the installfest instructions are located at ROOT/sites/en/installfest, while the intro rails curriculum can be found under ROOT/sites/en/intro-to-rails. (The "en" means "English" -- see "Locales" below.)

These files can be in any of these formats:

(If multiple files exist with the same base name, .step is preferred over .md, and .md over .mw.)


bundle install
bundle exec rake run

If the above fails (say, because rerun doesn't work on your system), try


Then open http://localhost:9292 in a web browser, and verify that you can navigate the installfest slides.


To serve sites from "sites/en", use bundle exec rake run or a vanilla deploy.

To server sites from another locale (say, "es" or Spanish)...

Run Localized Site Locally

$ SITE_LOCALE=es bundle exec rake run

The server listens on

Now you have to set up subdomain mappings for the site. If you have Pow, run:

$ echo 9292 > ~/.pow/railsbridge # works for any subdomain

If you don't have Pow, add the following line to /etc/hosts: # works for single subdomain

Now you can access for debugging.

Running on a Server

Just make sure the server responds to a locale subdomain:

Temporary Testing

Use a locale or l parameter:

Note that in this mode, links are not rewritten, so if they fail you will have to manually add the parameter again.


Check out to see how to join our list of contributors!


The documentation (including anything under the sites subdir as well as some hardcoded text elsewhere) is licensed under a Creative Commons license (CC-BY, specifically), which means you're welcome to share, remix, or use our content commercially. We just ask for attribution.

The code is licensed under an MIT license, like Ruby itself. Copyright (c) 2010-2014 by RailsBridge.

Other Resources