update documentation on new methods