improved notes and comments for blog