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