flesh out the documentation