clean up the yaml docs a little