Update loop doc

@tarekziade @Natim r?
This doc is for users of the API