fixes times for growth and time changes

+ adds documentation to both classes of functions