From 0fe1d1ee3d31a7c117b50633ca2e80a7f7be2fd1 Mon Sep 17 00:00:00 2001
From: Chris Rebert <code@chrisrebert.com>
Date: Thu, 17 Dec 2015 13:29:58 -0800
Subject: [PATCH] Add RubyGems section to "Download" docs

Closes #17291 by finishing the last remaining task.
Also reorders the sections in the "Download" docs.

[skip sauce]
---
 docs/getting-started/download.md | 34 +++++++++++++++++++++++++-------
 1 file changed, 27 insertions(+), 7 deletions(-)

diff --git a/docs/getting-started/download.md b/docs/getting-started/download.md
index 806eb7b3ab..1fa524eb55 100644
--- a/docs/getting-started/download.md
+++ b/docs/getting-started/download.md
@@ -36,17 +36,13 @@ Pull in Bootstrap's **source files** into nearly any project with some of the mo
 **Heads up!** Not all package managers have the v4 alpha published yet, but we should have them up shortly!
 {% endcallout %}
 
-### Bower
-
-Install and manage Bootstrap's Sass and JavaScript using [Bower](http://bower.io).
-
-{% highlight bash %}$ bower install bootstrap#v{{ site.current_version }}{% endhighlight %}
-
 ### npm
 
 Install Bootstrap in your Node powered apps with [the npm package](https://www.npmjs.org/package/bootstrap):
 
-{% highlight bash %}$ npm install bootstrap@{{ site.current_version }}{% endhighlight %}
+{% highlight bash %}
+$ npm install bootstrap@{{ site.current_version }}
+{% endhighlight %}
 
 `require('bootstrap')` will load all of Bootstrap's jQuery plugins onto the jQuery object. The `bootstrap` module itself does not export anything. You can manually load Bootstrap's jQuery plugins individually by loading the `/js/*.js` files under the package's top-level directory.
 
@@ -55,6 +51,22 @@ Bootstrap's `package.json` contains some additional metadata under the following
 - `sass` - path to Bootstrap's main [Sass](http://sass-lang.com/) source file
 - `style` - path to Bootstrap's non-minified CSS that's been precompiled using the default settings (no customization)
 
+### RubyGems
+
+Install Bootstrap in your Ruby apps using [Bundler](http://bundler.io/) (**recommended**) and [RubyGems](https://rubygems.org/) by adding the following line to your [`Gemfile`](http://bundler.io/gemfile.html):
+
+{% highlight ruby %}
+gem 'bootstrap', '~> 4.0.0.alpha3'
+{% endhighlight %}
+
+Alternatively, if you're not using Bundler, you can install the gem by running this command:
+
+{% highlight bash %}
+$ gem install bootstrap -v 4.0.0.alpha3
+{% endhighlight %}
+
+[See the gem's README](https://github.com/twbs/bootstrap-rubygem/blob/master/README.md) for further details.
+
 ### Meteor
 
 {% highlight bash %}
@@ -69,6 +81,14 @@ You can also install and manage Bootstrap's Sass and JavaScript using [Composer]
 $ composer require twbs/bootstrap
 {% endhighlight %}
 
+### Bower
+
+Install and manage Bootstrap's Sass and JavaScript using [Bower](http://bower.io).
+
+{% highlight bash %}
+$ bower install bootstrap#v{{ site.current_version }}
+{% endhighlight %}
+
 ### NuGet
 
 If you develop in .NET, you can also install and manage Bootstrap's [CSS](https://www.nuget.org/packages/bootstrap/) or [Sass](https://www.nuget.org/packages/bootstrap.sass/) and JavaScript using [NuGet](https://www.nuget.org):