Document RLMRealm lifetimes and related issues

Should cover all of the points of confusion related to RLMRealm lifetimes that people have run in to.
quote method names in ``- e.g. here `beginWriteTransaction`Same other places in the newly added text (e.g. refresh and beginWriteTransaction in line 200. Maybe also other places.