cleanup incongruities in docs