HEREDOCS CAN MAKE YOUR BASH SCRIPTS SELF-DOCUMENTING

Summary from the TLDR newsletter

Heredocs allows developers to add Markdown to bash scripts for inline documentation.