some work on the docs