installation.md in beaker-3.13.0

- old
+ new

@@ -1,12 +1,12 @@
-#Beaker Installation
+# Beaker Installation
 
 In most cases, beaker is running on a system separate from the SUT; we will commonly refer to this system as the beaker coordinator. This page outlines how to install requirements for the beaker coordinator and options for the installation of beaker itself.
 
 ## Beaker Requirements
 
-* Ruby >= 2.2.5
+* Ruby >= 2.1.8 (but we [only test on >= 2.2.5](installation.md#ruby-version))
 * libxml2, libxslt (needed for the [Nokogiri](http://nokogiri.org/tutorials/installing_nokogiri.html) gem)
 * g++ (needed for the [unf_ext](http://rubydoc.info/gems/unf_ext/) gem)
 * curl (needed for some DSL functions to be able to execute successfully)
 
 On a Debian or Ubuntu system you can install these using the command
@@ -15,17 +15,17 @@
 
 On an EL or Fedora system use:
 
     sudo yum install make gcc gcc-c++ libxml2-devel libxslt-devel ruby-devel
 
-##Installing Beaker
-###From Gem (Preferred)
+## Installing Beaker
+### From Gem (Preferred)
 
     $ gem install beaker
     $ beaker --help
 
-###From Latest Git
+### From Latest Git
 
 If you need the latest and greatest (and mostly likely broken/untested/no warranty) beaker code.
 
 * Uses <a href = "http://bundler.io/">bundler</a>
 
@@ -33,21 +33,21 @@
     $ git clone https://github.com/puppetlabs/beaker
     $ cd beaker
     $ bundle install
     $ bundle exec beaker --help
 
-###From Latest Git, As Installed Gem
+### From Latest Git, As Installed Gem
 
 If you need the latest and greatest, but prefer to work from gem instead of through bundler.
 
     $ gem uninstall beaker
     $ git clone https://github.com/puppetlabs/beaker
     $ cd beaker
     $ gem build beaker.gemspec
     $ gem install ./beaker-*.gem
 
-###Special Case Installation
+### Special Case Installation
 
 The beaker gem can be built and installed in the context of the current test suite by adding the github repos as the source in the Gemspec file (see <a href = "http://bundler.io/git.html">bundler git documentation</a>).
 
     source 'https://rubygems.org'
     group :testing do
@@ -55,5 +55,20 @@
       gem 'site_prism'
       gem 'selenium-webdriver'
       gem 'chromedriver2-helper'
       gem 'beaker', :github => 'puppetlabs/beaker', :branch => 'master', :ref => 'fffe7'
     end
+
+## Ruby Version
+
+In moving to beaker 3.0, we added in a hard requirement that a
+beaker test writer be using Ruby 2.2.5 or higher. Since Puppet
+has versions that support earlier versions of Ruby, this made
+writing tests more difficult than it needed to be.
+
+In order to make this easier, in beaker 3.13.0 we've relaxed
+this requirement to Ruby 2.1.8. Note that the beaker team does
+not internally test Ruby versions below 2.2.5, and that if bugs
+are submitted that are found to be specific to versions below
+2.2.5, they will not be worked on by the beaker team. This
+doesn't mean we won't merge fixes to bugs that are specific to
+those versions that are submitted by the community, however.