bringing docs up to date