add documentation to simple functions