> so that the help documentation doesn't overwhelm the initial viewing of the actual code.
That is a very strange argument to me. You find that more cumbersome than jumping around to random functions?
That is a very strange argument to me. You find that more cumbersome than jumping around to random functions?
By having the help documentation in a function in the middle or towards the end of the file, I don't have to page down through the help documentation to get to the code that is actually doing things. If I'm really interested in the help documentation, then I'd prefer to look at the nicely formatted version output by the script (<script> --help or whatever) rather than looking in the actual script code anyway.
Admittedly, this may be more of a subjective personal preference item.