Follow-up updates to previously changes by mnagy

Author: Timothy Poitras

using_images/s2i_images/ruby.adoc

@@ -23,10 +23,12 @@ endif::openshift-enterprise[]
 assembles your application source with any required dependencies to create a
 new image containing your Ruby application. This resulting image can be run either by {product-title} or by Docker.
 
+[[s2i-images-ruby-versions]]
 == Versions
 Currently, {product-title} provides version
 https://github.com/openshift/sti-ruby/tree/master/2.0[2.0] of Ruby.
 
+[[s2i-images-ruby-images]]
 == Images
 
 This image comes in two flavors, depending on your needs:
@@ -62,6 +64,7 @@ ImageStream. You can find
 https://github.com/openshift/origin/tree/master/examples/image-streams[example
 image stream definitions] for all the provided {product-title} images.
 
+[[s2i-images-ruby-config]]
 == Configuration
 The Ruby image supports a number of environment variables which can be set to
 control the configuration and behavior of the Ruby runtime.
@@ -99,10 +102,15 @@ environment. Therefore, you can use this variable when assets have already been
 compiled.
 
 |`*PUMA_MIN_THREADS*`, `*PUMA_MAX_THREADS*`
-|Indicates the minimum and maximum threads that will be available in https://github.com/puma/puma[Puma]'s thread pool.
+|This variable indicates the minimum and maximum number of threads that will be
+available in link:https://github.com/puma/puma[Puma]'s thread pool.
 
 |`*PUMA_WORKERS*`
-|Indicates the number of worker processes that will be launched. See documentation on Puma's https://github.com/puma/puma#clustered-mode[clustered mode]. If not explicitly set, the default behavior sets `*PUMA_WORKERS*` to an appropriate value for the memory available to the container and the number of cores on the host.
+|This variable indicates the number of worker processes to be launched in Puma's
+link:https://github.com/puma/puma#clustered-mode[clustered mode] (when Puma runs
+more than two processes). If not explicitly set, the default behavior sets
+`*PUMA_WORKERS*` to a value that is appropriate for the memory available to the
+container and the number of cores on the host.
 |===
 
 [[ruby-hot-deploy]]