update documentation to match interface change

resolves #1028