Added more clarity to RLMArray remove methods

Alex mentioned something like this should be added to the RLMArray docs @jpsim @alazier @tgoyne