contract method and documentation upgrade