flesh out docs a bit more