tidy up docs a bit