better commenting of functions