improve `.auto` docs