More comments and improved readability

Signed-off-by: Balthazar Rouberol <brouberol@imap.cc>