Updated API docs for Storage/ classes.
Merge pull request #1314 from raistlinthewiz/storage-api-docs

Updated API docs for Storage/ classes.
Fixed icon markup.
A few more tweaks to the readme.