[RLMRealm docs] Added doc overview to RLMRealm (fixes #1198)

@alazier @tgoyne anything else that should be added in there?