Burying the Lede
Most of us don’t write very readable shell scripts. There are plenty of things we could do better, but today I want to talk about one in particular — burying the lede. The term “burying the lede” comes from the field of journalism. Here’s the Wiktionary definition: To begin a story with details of secondary importance to the reader while postponing more essential points or facts. Like a good news article, code should tell a story. And the story should start with what’s most important. In the case of code, the most important information is the high-level functionality — a succinct summary of what the program does. In other words, write (and organize) the code top-down, as opposed to bottom-up. ...