added documentation to methods