add basic tests for package options
add pullr link to readme
add table of contents to readme

without this it is very hard to navigate the document