documentation and contract changes