brush up docs a bit more