Re:Undervalued Engineering Skills: Writing Well
by briandear on Friday May 31, 2019 @05:02PM
(#20064938)
It depends on what you are writing. Also, there is a question of readability. A document written in legalese is certainly “accurate,” but that doesn’t make it comprehensible. Writing with clarity isn’t about following a standard, it’s about using language in such a way that the consumer of that language understands the message. If documents were written following like the RFC, they’d be incredibly tedious to read. English isn’t a computer language, there is a such thing as context, tone, and diction. Of course if you are actually writing a legal document or standards document, certainly use that idiom.
[ Parent
| on HN ]
There are no comments on this comment yet.