logoalt Hacker News

jph00yesterday at 5:36 PM1 replyview on HN

No, your job is to help your reader get to the end of the text. That means writing in a way that most of your audience finds compelling, readable, and not intimidating.

Not all readers are the same, so you will fail at your job for some readers.

But few readers are emotionless automatons that need nothing but dry technical content, unless it’s a topic they are very motivated to understand.


Replies

jonahxyesterday at 6:04 PM

> That means writing in a way that most of your audience finds compelling, readable, and not intimidating.

I would agree with that. And I think emojis and unnecessary reassurances subvert that goal. It's fluff, it's more to read, and if the writing isn't already clear, they don't fix the problem.

> But few readers are emotionless automatons that need nothing but dry technical content

Nothing in my post argues for dry technical content.

Bartosz Ciechanowski's superb work, which may have inspired the author, gets the balance just right without any hand-holding asides:

https://ciechanow.ski/mechanical-watch/