documentation update (pass #3)