On: Ask HN: Best books under 200 pages for developers?

[WalterBright]

"The Elements of Style", by Strunk & White. 92 pages.

For example, page 19: "Put statements in positive form."

Code is improved if booleans are put in positive form, such as replace:

    if (!featureIsDisabled()) ...

with:

    if (hasFeature()) ...

You might laugh, but I see the first form all the time. Sometimes I go on a refactoring mission to remove as many negations, nots, and bangs from the code as possible.

[xtiansimon → WalterBright]

?? You mean this book-- "The Elements of Style is an American English writing style guide in numerous editions. The original was composed by William Strunk Jr. in 1918, and published by Harcourt in 1920..." [1]

Cool! 1920s book on English writing style inspiring your coding style.

My first reaction to the 'positive form' was to recall a conversation I had once with a retired programmer about flow control diagrams. They relayed how the normal form for these required, for example, the boolean nodes to exit True in one direction and False in another--but all similar nodes had to exit in the same direction.

I wondered if a paper-based design, once translated into code, might not include conditionals such as the example which seem awkward once the paper design is lost and forgotten.

Now I don't know which detail is more interesting--

How design methodology effects the comprehensibility of written code.

How I was inspired to apply natural language writing principles as programming best practices.

[1]: https://en.wikipedia.org/wiki/The_Elements_of_Style

[WalterBright → xtiansimon]

> 1920s book on English writing style inspiring your coding style.

Absolutely. It is surprising (but not really once you think about it) how applicable it is.

[palerdot → WalterBright]

I use negative flags (but not negations) so that I can break out early with early returns ...

  if (isFeatureDisabled()) {
    // do not proceed
    return
  }

But still the style guide holds, since there is no negations ...

[WalterBright → palerdot]

I do try to reframe as different words, such as "right" instead of "notLeft", to eliminate negations.

[undergrowth54 → WalterBright]

I think that Style: Towards Clarity and Grace is a good follow-up. Have a free PDF: https://sites.duke.edu/niou/files/2014/07/WilliamsJosephM199...

[rement → WalterBright]

"Writing with Style, Conversations on the Art of Writing", by John Trimble is another great writing book (The second edition is 161 pages if you don't include the appendices).

The ability to communicate in writing is an important skill even for developers.

[chemicalnovae → WalterBright]

I was first put onto this book by my PhD supervisor while writing up my dissertation. Revolutionised the way I wrote English for the better.

[harry8 → WalterBright]

Ever used a router command line from Cisco, arista etc? Switch on a port with "no shut"