adapted doc for last changes