Improved documentation for `Rack::Builder`.

1 files changed, 4 insertions, 3 deletions

diff --git a/lib/rack/builder.rb b/lib/rack/builder.rb
index 05444f2c..fa5e876f 100644
--- a/lib/rack/builder.rb
+++ b/lib/rack/builder.rb
@@ -3,8 +3,10 @@
 require_relative 'urlmap'
 
 module Rack
-  # Rack::Builder implements a small DSL to interactively construct Rack
-  # applications.
+  # Rack::Builder provides a domain-specific language (DSL) to construct Rack
+  # applications. It is primarily used to parse +config.ru+ files which
+  # instantiate several middleware and a final application which are hosted
+  # by a Rack-compatible web server.
   #
   # Example:
   #
@@ -31,7 +33,6 @@ module Rack
   #
   # +use+ adds middleware to the stack, +run+ dispatches to an application.
   # You can use +map+ to construct a Rack::URLMap in a convenient way.
-
   class Builder
 
     # https://stackoverflow.com/questions/2223882/whats-the-difference-between-utf-8-and-utf-8-without-bom