Bash in my first impression is an ancient and complex piece of software.  It's subtle and tricky.  If we do not take time to do proper annotation and documentation now, we are making it hard for future reviewers and potential maintainers, essentially wasting their time.