updated documentation and added additional methods (unwritten)