logoalt Hacker News

weinzierl • today at 3:40 PM • 3 replies • view on HN

"The meandering intro"

Not only the intro. Many bloggers try to write as if they'd writing a story, building suspense and all. For technical writing, don't bury the lede.


Replies

CM30 • today at 10:07 PM

Not just bloggers either. One look at the average YouTube video, and you'd think most people making those things had never heard the word 'brevity' in their life.

pastel8739 • today at 4:00 PM

Is blogging necessarily technical writing?

➕ show 1 reply
IslandRebel • today at 5:38 PM

This is a pet peeve of mine when there is a news story, opinion piece, case study where they spend like several paragraphs (or much more) telling story like it was a novel when in reality you it about maybe one or two paragraphs explaining what happened to a particular person/couple/family etc. and then get into the facts.

It is a massive turn off for me and I just simply close the window if I find they don't get start getting to the point.

I am much more forgiving if the meandering intro is done by someone that is clearly just someone writing up their own work.