make the function comments a bit clearer and add some whitespace