maj optimisation + documentation