Clarify documentation, following merge of realtime_update2 branch