I do add a invocation comment to my shell functions. Because parsing what is happening why, is so much more effort the next time i touch it two years later. Despite the code being as clean as possible.