edit some code samples and comments