added some documentation to functions header, formatting