bring docs up to date with latest changes