Update loop doc

@tarekziade @Natim r?
ditto.