Oddbean new post about | logout
▲ ▼
2fa1d787 | 1 years ago (raw) | root | parent | reply | flag 
 @d028a7b1 As indicated, I knew nothing about pipx. The problem of tech writers presuming familiarity with the topic and dispensing with the courtesy of a summary up front and plunging into detail is one of the reasons for the TL;DR meme's manifestations.

It's not that difficult to be a bit more informative up front.
▲ ▼
Linux TLDR | 1 years ago (raw) | root | parent | reply | flag 
 @06e722d1 I think this would be the main focus of your "It's not that difficult to be a bit more informative up front". I also agree with this viewpoint, but while writing such an article, especially when it's "how-to", technically, writers typically give a short context about the topic, so the reader gets a sneak idea of the topic, followed by installation instructions, the article's core purpose, and examples.
▲ ▼
Linux TLDR | 1 years ago (raw) | root | parent | reply | flag 
 @06e722d1 So if anything is missed in the introduction, readers can read the topic's functionality and get a better idea of how it will work, indirectly solving their question about what the topic is about. And this is basically tradition, and most readers prefer this format, yet there are diverse responses. If such feedback continues, I might consider altering the article structure in the future.