update with docs for new methods