update the documentation

 - point 1
 - point 2
 - point 3
Merge pull request #1 from thirtysixthspan/update_documentation

update the documentation