add empty _static directory to not get a warning from sphinx
small docstring changes to remove warnings + convert example to doctest
somewhat nicer TOC