Updated the Developer's Guide to better reflect the current workflow.

Author: peterhellberg

developers-guide.md

@@ -9,7 +9,8 @@ _Please help out by updating this page_
 
 ### Operating System
 
-It works on Mac OSX. Probably works without any changes or issues on linux. A masochist could probably get it working on Windows.
+It works on Mac OSX. Probably works without any changes or issues on Linux.
+A masochist could probably get it working on Windows.
 
 ## Installation
 
@@ -19,54 +20,47 @@ It works on Mac OSX. Probably works without any changes or issues on linux. A ma
 git clone git://github.com/coffeescript-cookbook/coffeescript-cookbook.github.com.git
 {% endhighlight %}
 
-### Create a Ruby Gemset
+### Ruby environment
 
-Optional, but highly recommended.
+You probably want to have [RVM](http://rvm.io/) installed.
 
-{% highlight bash %}
-$ rvm gemset create jekyll
-$ echo 'rvm gemset use jekyll' >> .rvmrc
-{% endhighlight %}
-
-### Install Required Gems
+The project includes a `.ruby-version` file locked to
+*1.9.3* since that is what Github Pages are currently using.
 
-{% highlight bash %}
-gem install jekyll   # needed for testing building the site
-gem install RedCloth # needed for .md rendering
-gem install serve    # needed for resolving .html files w/o extension
-gem install thin     # optional; more efficient webserver than Webrick but not strictly necessary
-{% endhighlight %}
+There is also a `.ruby-gemset` that is set to *coffeescript-cookbook*
 
-### Install pygments
+### Required dependencies
 
-You'll need python installed for this. Macs and most linuces come with it preinstalled.
+We are using [Bundler](http://bundler.io/) to install the required Ruby dependencies.
 
 {% highlight bash %}
-easy_install pygments   # for syntax highlighting
+bundle install
 {% endhighlight %}
 
-## Building and Viewing the Website
-
-### Run jekyll
+#### Install pygments
 
-Open a terminal window, cd into the project folder and run jekyll from the project root.
+You'll need python installed for this.
+Macs and most Linuces come with it preinstalled.
 
 {% highlight bash %}
-jekyll --auto
+easy_install pygments # for syntax highlighting
 {% endhighlight %}
 
-Leave this window running while you work. Any time you change a file, jekyll will rerender it into the `_site` folder.
-
-### Run serve
+## Building and Viewing the Website
 
-Open another terminal window, cd into the project folder, then cd into the `_site` subfolder, and run
+Open a terminal window, cd into the project folder and run `foreman start` from the project root.
 
 {% highlight bash %}
-serve
+foreman start
 {% endhighlight %}
 
-This will start a webserver in the `_site` folder. Open a browser and visit `http://localhost:4000/` and you should see the site.
+Leave this window running while you work.
+Any time you change a file, jekyll will rerender it into the `_site` folder.
+
+Open a browser and visit <http://localhost:4000/> and you should see the site.
 
 ## Minutiae and Other Trivialities
 
-jekyll can take a second or two to catch up when you save a file. If you edit a file and don't see the changes in your browser, give it a second or two and try again. You may also see Maruku warnings, but as long as it prints `Successfully generated site` you should be alright.
+Jekyll can take a second or two to catch up when you save a file. 
+If you edit a file and don't see the changes in your browser, give it a second or two and try again.
+As long as it prints `Successfully generated site` you should be alright.