adding documentation to methods