add documentation to several methods