Hacker News new | ask | show | jobs
by ethbr0 1054 days ago
I desperately wish there was more awareness of military writing styles in the civilian world.

- They're organizations that have existed for as long as their countries.

- They're incredibly large.

- They have to communicate critical information to a very diverse set of readers.

- They iteratively update their approaches, over decades, often in direct reaction to the most stringent real-world tests.

... how could we not learn something from the systems they're currently using?

My favorite nuggets are (1) the glory of BLUF (bottom-line, up front; or an executive summary of everything to follow), (2) including a formal intent preface to any document (to guide writers and readers in what to include/exclude), (3) thoroughly defining terms (to avoid "we're using the same word with different meanings" problem), and (4) rigorously structuring information into separate sections.

Which isn't to say militaries get everything right all of the time. They do tons of stupid things. But dismissing or ignoring them as a source to cherry-pick best practices is shortsighted.

3 comments

BLUF is my favorite nugget as well

> ... how could we not learn something from the systems they're currently using?

You haven't noticed the aversion to the military, especially the US military, around here or in "academic" circles?

I wouldn't say I've seen aversion, more lack of awareness.

And what aversion there is seems to be a missing distinction between the military organization and military outcomes.

There are 1.3m active duty US DoD uniformed personnel. And another 1m reserve.

The bulk of those are performing support functions and keeping the whole organization running.

It's difficult for me to form any kind of ethical judgment about support folks, however the military is ultimately employed. And especially when weighed against the large number of tech careers that are in support of advertising/tracking.

>BLUF is my favorite nugget as well

I wonder if the next generation will invent their own version of this. The current 'trendy' one is tl;dr

Because "Abstract" is too abstract of a concept, and "Executive Summary" is too long and presumes the audience.

It's one of these ideas that are universally useful, but get a different name in each context.

I will often do "TL;DR:" at the top when realize I've written rather more than I'd expected.
>But dismissing or ignoring them as a source to cherry-pick best practices is shortsighted.

No truer statement about humanity has been spoken

BLUF is great but is kind of like the MVP in that execution highly varies from author to author