Logger: add doc

Here is the doc for the logger. We can wait on your first run with the logger before merging this.

unmarked as a Work In Progress

assigned to @matthieu

There was no problem with Alexei's run and the documentation is good enough, we can merge it :)

merged

mentioned in commit 71ff3bcd