add function comments and dictionary descriptions