Documentation updates for new concurrency models

1 files changed, 4 insertions, 2 deletions

diff --git a/lib/rainbows/fiber_pool.rb b/lib/rainbows/fiber_pool.rb
index 8c408b9..ff693fa 100644
--- a/lib/rainbows/fiber_pool.rb
+++ b/lib/rainbows/fiber_pool.rb
@@ -7,9 +7,11 @@ module Rainbows
   # A Fiber-based concurrency model for Ruby 1.9.  This uses a pool of
   # Fibers to handle client IO to run the application and the root Fiber
   # for scheduling and connection acceptance.  The pool size is equal to
-  # the number of +worker_connections+.  This model supports a streaming
+  # the number of +worker_connections+.  Compared to the ThreadPool
+  # model, Fibers are very cheap in terms of memory usage so you can
+  # have more active connections.  This model supports a streaming
   # "rack.input" with lightweight concurrency.  Applications are
-  # strongly advised to wrap slow all IO objects (sockets, pipes) using
+  # strongly advised to wrap all slow IO objects (sockets, pipes) using
   # the Rainbows::Fiber::IO class whenever possible.
 
   module FiberPool