Add literate programming comments
move todos to github issues