Add inline code comments

Do not merge until I'll ask to do so, but please start reviewing comments and give feedback if anything is wrong / misleading.