documenter le code

@FredoHorn a commencé, il faut continuer et le faire en continue (je m'inclue dans la cible du conseil car j'avoue ne pas le faire très souvent, et c'est mal !)

Documentation, documentation, documentation...
