Document RLMRealm lifetimes and related issues

Should cover all of the points of confusion related to RLMRealm lifetimes that people have run in to.