Write a programmer documentation

[Etiennef]

Goal is to make it maintainable by someone else
probably add a markdown with explanation of how it works