README.md in netsuite-0.0.39 vs README.md in netsuite-0.0.40

@@ -83,9 +83,19 @@
     )                 # => #<NetSuite::Response:0x1041f64b5>
     response.success? # => true
     response.body     # => { :internal_id => '979', :type => 'customer' }
     ```
 
+## Gotchas
+
+  * The Initialize Action duck-punches the .initialize method on any class that includes it.
+    This has not proven to be a issue yet, but should be taken into account when analyzing any
+    strange issues with the gem.
+  * Some records define a 'class' field. Defining a 'class' field on a record overrides the
+    #class and #class= methods for this class. This is very obviously a problem.  You can,
+    instead, define a 'klass' field that will be turned into 'class' before being submitted
+    to the API. The Invoice record has an example of this.
+
 ## Contributing
 
 1. Fork it
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Added some feature'`)