Document RLMRealm lifetimes and related issues

Should cover all of the points of confusion related to RLMRealm lifetimes that people have run in to.
The logic behind putting the lifetime information there is that it's something that anyone calling that method needs to know, so putting the information directly in the docs for it maximizes the chance of them seeing it.