diff --git a/lib/fog/rackspace/docs/storage.md b/lib/fog/rackspace/docs/storage.md
index bb971ddf7..44059febb 100644
--- a/lib/fog/rackspace/docs/storage.md
+++ b/lib/fog/rackspace/docs/storage.md
@@ -269,6 +269,13 @@ To retrieve a specific directory:
 
 	service.directories.get "blue"
 
+**Note** As a general rule, only use `get` when you want to iterate over the contents of a `Directory`
+
+This call is similar to...
+
+    service.directories.new :key => "blue"
+
+... except the `get` method makes an HTTP call that returns metadata for up to the first 10,000 files. **This can be slow!**
 
 This returns a `Fog::Storage::Rackspace::Directory` instance:
 
@@ -279,8 +286,6 @@ This returns a `Fog::Storage::Rackspace::Directory` instance:
     cdn_cname=nil
     >
 
-**Note**: This will retrieve the metadata for up to the first 10,000 files in the directory. This can be slow!
-
 ## Create Directory
 
 To create a directory: