README.md in expand-1.0.5 vs README.md in expand-1.0.6

@@ -61,9 +61,21 @@
     # define methods here
   end
 end
 ```
 
+## Gotchas
+
+Unfortunately, due to the scoping of the blocks passed to the main `namespace` or `expand` methods, you are unable to directly reference classes nested in your namespace.
+
+You can, however, pass an argument to the block to use as a reference:
+
+```ruby
+namespace SomeGem::Thing do |klass|
+  puts klass #=> yields "SomeGem::Thing"
+end
+```
+
 ## Installation
 
 Add this line to your application's Gemfile:
 
 ```ruby