(This should be done at the end of the first iteration) - add/update comments where necessary - add function descriptors
