add comments for new methods