[LOG-52] improve the documentation, on builders in particular
[LOG-52] improve the documentation