better docs
add files to toctree
Merge branch 'docs' into unstable