update documentation somewhat