News for hackers. Stuff that matters.

A comment on Ask HN: What are good writing tips for software developers?. Parent comment

Re:Ask HN: What are good writing tips for software developers? by shubhamjain on Monday March 05, 2018 @11:55PM (#16526950)
These prescriptive writing tips do more harm than good. The crucial question is not whether you have adhered to all the tips but if what you wrote sounds good. Following writing advice without critically analyzing it often leads to writing which feels overdone.
[ Parent | on HN ]
Re:Ask HN: What are good writing tips for software developers? by eropple on Tuesday March 06, 2018 @12:29AM (#16527077)
I can write you a sentence that sounds amazing. I can also write it with an unclear pronoun antecedent and make a hash of its meaning.

When you know how to write, you can break the rules. Until you do, guard rails keep you from looking like an idiot.

[ Parent | on HN ]