News for hackers. Stuff that matters.
Re:Feynman's Razor (if an expert can't understand, you've du... by nicbou on Saturday June 08, 2024 @03:37AM (#40615965)
I struggle a lot with this in my work. I can’t assume that my readers are fluent English speakers, nor that they understand the topic. I can’t even assume that they care to understand. I have adopted a plain and unambiguous writing style that hopefully accounts for it. I am now experimenting with formatting that allows them to skim everything and still get the gist of it. In my opinion, nhs.uk is the best example to learn from.

People are not stupid, but they are busy, tired, lazy, or simply not that interested in the finer details. There is a balance between respecting their intellect and respecting their time.

Re:Feynman's Razor (if an expert can't understand, you've du... by kohbo on Saturday June 08, 2024 @04:33AM (#40616174)
How come you're avoiding every contraction, except "can't"?
Re:Feynman's Razor (if an expert can't understand, you've du... by zexbha on Saturday June 08, 2024 @07:54AM (#40616968)
I would not have observed this on my own. Do contractions make English harder to comprehend for non-natives? I'll have to avoid using y'all'dn't've
Re:Feynman's Razor (if an expert can't understand, you've du... by Aspos on Saturday June 08, 2024 @09:59AM (#40617596)
Yes they do
Re:Feynman's Razor (if an expert can't understand, you've du... by lupire on Saturday June 08, 2024 @08:39AM (#40617163)
Common English. The "n't” contractions are the most comfortable, and "can't" is most comfortable because it saves a syllable.
Re:Feynman's Razor (if an expert can't understand, you've du... by DavidPiper on Saturday June 08, 2024 @09:40AM (#40617486)
That's a cool observation - it could just be GP's natural turn of phrase. I know a few people who never use any contractions when they speak. I assume it's a local/familial style.
Re:Feynman's Razor (if an expert can't understand, you've du... by isleyaardvark on Saturday June 08, 2024 @10:16AM (#40617700)
You can probably skip nhs.uk and go straight to uk.gov's writing guidelines themselves:

https://www.gov.uk/guidance/content-design/writing-for-gov-u...