more work on the docs