optimisations et documentation