From a5a8be97de6b0372c6e70b01d8a1a17f4e43974b Mon Sep 17 00:00:00 2001
From: Parker Moore <parkrmoore@gmail.com>
Date: Mon, 22 Sep 2014 22:52:23 -0700
Subject: [PATCH] Make it a little nicer.

---
 site/_docs/github-pages.md | 24 +++++++++++++-----------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/site/_docs/github-pages.md b/site/_docs/github-pages.md
index b448d510..c9305cd0 100644
--- a/site/_docs/github-pages.md
+++ b/site/_docs/github-pages.md
@@ -19,20 +19,22 @@ content, they’re also a great way to host your Jekyll-powered website for free
     Our friends at GitHub have provided the
     <a href="https://github.com/github/pages-gem">github-pages</a>
     gem which is used to manage Jekyll and its dependencies on
-    GitHub Pages. To use the currently-deployed version of the
-    gem in your project, add the following to your `Gemfile`:
-    
-    {% highlight ruby %}
-    source 'https://rubygems.org'
+    GitHub Pages. Using it in your projects means that when you deploy
+    your site to GitHub Pages, you will not be caught by unexpected
+    differences between various versions of the gems. To use the
+    currently-deployed version of the gem in your project, add the
+    following to your <code>Gemfile</code>:
 
-    require 'json'
-    require 'open-uri'
-    versions = JSON.parse(open('https://pages.github.com/versions.json').read)
+{% highlight ruby %}
+source 'https://rubygems.org'
 
+require 'json'
+require 'open-uri'
+versions = JSON.parse(open('https://pages.github.com/versions.json').read)
+
+gem 'github-pages', versions['github-pages']
+{% endhighlight %}
 
-    gem 'github-pages', versions['github-pages']
-    {% endhighlight %}
-    
     This will ensure that when you run <code>bundle install</code>, you
     have the correct version of the <code>github-pages</code> gem.
   </p>