flesh out the docs a bit