On Sun, May 31, 2020 at 11:57:03PM -0400, John Passaro wrote: > I think the underlying question here is not exactly "how do I gather this > from the docs" as much as it is "how was I supposed to know about this and > act on it before I had to debug it?"
I don't believe the bash documentation is the appropriate place to put tutorials on how (not) to write bash scripts. For that, I would consult other sources, such as: https://shellcheck.net/ https://mywiki.wooledge.org/BashPitfalls I'm sure there are other excellent places to find instructions, but these are the two that immediately come to mind.
