updated raw comments with examples