add documentation for new methods