Revise notes and comments, add readme