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
github-pages
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 Gemfile
:
- 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 bundle install
, you
have the correct version of the github-pages
gem.