It helps. Even more so if documented with the function signature so documentation (in your editor or ide) can communicate it. But one better than documenting c

It helps. Even more so if documented with the function signature so documentation (in your editor or ide) can communicate it. But one better than documenting comments is no documenting comments. Selfdocumenting code is certainly not always feasible. But in this case it's both possible and easy.