3 ms·
To me, this principles of this style are best described in the Economist's Style Guide: http://www.economist.com/styleguide/introduction http://www.economist.c
by jjguy 10y ago
To me, this principles of this style are best described in the Economist's Style Guide: http://www.economist.com/styleguide/introduction http://www.economist.com/styleguide/introduction
"Clarity of writing usually follows clarity of thought. So think what you want to say, then say it as simply as possible."
"Pomposity and long-windedness tend to obscure meaning, or reveal the lack of it: strip them away in favour of plain words."
"Do your best to be lucid (“I see but one rule: to be clear”, Stendhal). Simple sentences help. Keep complicated constructions and gimmicks to a minimum"
"Long paragraphs, like long sentences, can confuse the reader. “The paragraph”, according to Fowler, “is essentially a unit of thought, not of length; it must be homogeneous in subject matter and sequential in treatment.”"
"Get: Get is an adaptable verb, but it has its limits. A man does not get sacked or promoted, he is sacked or promoted. Nor does a prize-winner get to shake hands with the president, or spend the money all at once; he gets the chance to, or is able to, or is allowed to.
- appleiigs 10y agoAll of these suggestions apply to coding too! I wish email writers would spend a bit more time on composition. I do realize code lives a lot longer than an email does, but if they put in just a fraction of the effort a programmer spends on structuring code, it would make email a lot better.