Update loop doc

@tarekziade @Natim r?
As a developer I care to have a vision of what's going on.
This is a documentation for developer isn't it?