add documentation to methods