This is probably one of the best use cases for "what" comments... however in my opinion a much better way to go about this is to have example-based tests (and m

This is probably one of the best use cases for "what" comments... however in my opinion a much better way to go about this is to have example-based tests (and maybe a decent function name) serve as your documentation.