more documentation
edits
added example section
misc