Known issues and limitations documentation

[jayqi]

Known issues, gotchas, things to be careful of

• [ ] directory weirdness for cloud storage
• [ ] explain default client + credentials system
• [ ] explain that "pure" style operations are possible so existence / connection to cloud are not checked on instantiation
• [ ] explain caching limitations
• [ ] explain synchronous downloads