add documentation to some methods