add docstrings to methods
refs #788