first pass at doc revision