more descriptions
remove unused file
fix the path
note caveats
more usage examples