Update to attempt to alleviate confusion between Directory.new and get.

May want to have Directory metadata load only on #each instead of #get
Removing superfluous markup
Incorporated feedback from @mikhailov
Merge pull request #2715 from fog/rackspace_storage_docs

Update to attempt to alleviate confusion between Directory.new and get.