refactor docs a little