update the documentation

 * point 1
 * point 2
 * point 3