Re:Good Plain English: The problem with writing manuals
by mcarden on Tuesday February 21, 2017 @08:14PM
(#13701997)
It is at least slightly amusing that the ambiguous title led me to expect that the article would be about the writing of manuals, rather than a discussion of manuals explaining how to write.
Re:Good Plain English: The problem with writing manuals
by dredmorbius on Tuesday February 21, 2017 @08:20PM
(#13702027)
Likewise. I also found the title ambiguous, and the style of the piece itself an exemplar of much it rails against. Verbose, excessivly so, and somewhat over-endeared with itself.
Re:Good Plain English: The problem with writing manuals
by lolc on Tuesday February 21, 2017 @05:03PM
(#13700485)
I stoppped reading mid-article. Then I decided to come here to indulge in the metaness of criticizing the article critical of language style guides that criticize classics.
Re:Good Plain English: The problem with writing manuals
by j10sanders on Tuesday February 21, 2017 @06:00PM
(#13700998)
I think it was critical of the language style guide's language style outside of its criticisms of classics, but then somehow finds the real issue is the meaninglessness of words in the common-folk language of Trump compared to the eloquent (yet also straight-forward) language style Obama.
Re:Good Plain English: The problem with writing manuals
by ouid on Tuesday February 21, 2017 @07:27PM
(#13701669)
ok, I'll start.
I think the article starts on its best point, and then never comes back to it. There is less editorial process than there used to be. It's not inconsistent to fail to adhere to your own style if one of the methods that you use to adhere to your own style is an editor.
Writing communicatively is hard, but testing whether your writing is communicative is easy, just have someone (else) try to read it, and tell you if they found it convincing.
Why did the author not come back to this? It seems like it should be the point of the article.
Silly business.
In other words, I'm confused too.
I think the article starts on its best point, and then never comes back to it. There is less editorial process than there used to be. It's not inconsistent to fail to adhere to your own style if one of the methods that you use to adhere to your own style is an editor.
Writing communicatively is hard, but testing whether your writing is communicative is easy, just have someone (else) try to read it, and tell you if they found it convincing.
Why did the author not come back to this? It seems like it should be the point of the article.
William Safire satirised it nicely in his Fumblerules.
https://en.wikipedia.org/wiki/Fumblerules
http://dmorgan.web.wesleyan.edu/materials/safire.htm
http://gioclairval.blogspot.it/2010/02/umberto-ecos-rules-fo...
lolwut
much hypocritical so verbosity
but bernoff's book is brilliant.
The low for me was a 16 page manual for using an RSA token!