Document RLMRealm lifetimes and related issues

Should cover all of the points of confusion related to RLMRealm
lifetimes that people have run in to.
Merge pull request #844 from realm/tg-rlmrealm-docs

Document RLMRealm lifetimes and related issues