Update loop doc

@tarekziade @Natim r?
what about headers?