add comments and modify examples