improve docs a bit