Document RLMRealm lifetimes and related issues

Should cover all of the points of confusion related to RLMRealm lifetimes that people have run in to.
I would just remove the inmemory blurb since we need to change this anyways. Better to remove it now than to forget later and have confusing docs again.