initial text for gh-pages
no longer crashes if passed empty options
fixed bugs and added documentation to github pages branch