adding more docs for latest patch

lib/couch-client.rb

@@ -2,14 +2,16 @@
 
 # The CouchClient module is the overall container of all CouchClient logic.
 module CouchClient
+  VERSION = "0.0.1"
+
   begin
     # Require HashWithIndifferentAccess gem if available.
     require 'active_support/hash_with_indifferent_access'
     class Hash < ActiveSupport::HashWithIndifferentAccess
       private
-
       # Patching `convert_value` method, else it will absorb all "Hashlike"
-      # objects and convert them into a HashWithIndifferentAccess object.
+      # objects and convert them into a HashWithIndifferentAccess.
+      # NOTE: As this is patching a private method, this is probably not a good idea.
       def convert_value(value)
         if value.instance_of?(::Hash) # specifying Ruby's Hash, not CouchClient's Hash
           self.class.new_from_hash_copying_default(value)
@@ -25,6 +27,8 @@ def convert_value(value)
     class Hash < ::Hash; end
   end
 
+  # requiring libraries inside of the CouchClient library so they can use
+  # HashWithIndifferentAccess instead of Hash if it is available.
   require 'couch-client/connection'
   require 'couch-client/connection_handler'
   require 'couch-client/hookup'
@@ -36,8 +40,6 @@ class Hash < ::Hash; end
   require 'couch-client/collection'
   require 'couch-client/row'
 
-  VERSION = "0.0.1"
-
   class Error < Exception; end
 
   # Start using CouchClient by constructing a new CouchClient::Connection object with a Hash:

lib/couch-client/connection_handler.rb

@@ -20,6 +20,7 @@ def initialize
       @port = 5984
     end
 
+    # Sets the database and ensures that it follows proper naming conventions.
     def database=(database)
       if database.match(/^[a-z0-9_$()+-\/]+$/)
         @database = database