flesh out the docs