add proposed functions and comments