News for hackers. Stuff that matters.
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.

Silly business.

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.

In other words, I'm confused too.

Re:Good Plain English: The problem with writing manuals by lolc on Tuesday February 21, 2017 @06:52PM (#13701428)
Oh if it went down that path I'm glad I didn't continue reading. Trump-style is not common-folk style, it's rambling-folk style.
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.

Re:Good Plain English: The problem with writing manuals by emmelaich on Tuesday February 21, 2017 @11:33PM (#13703026)
Very few guides follow their own advice.

William Safire satirised it nicely in his Fumblerules.

https://en.wikipedia.org/wiki/Fumblerules

http://dmorgan.web.wesleyan.edu/materials/safire.htm

Re:Good Plain English: The problem with writing manuals by jaclaz on Wednesday February 22, 2017 @03:43AM (#13704128)
Also, JFYI, Umberto Eco's Rules for writing (well):

http://gioclairval.blogspot.it/2010/02/umberto-ecos-rules-fo...

Re:Good Plain English: The problem with writing manuals by m52go on Tuesday February 21, 2017 @07:20PM (#13701632)
> Bernoff is a Canute in an ocean of ordure. As such the gist of his advice is unimpeachable. Get to the point.

lolwut

much hypocritical so verbosity

but bernoff's book is brilliant.

Re:Good Plain English: The problem with writing manuals by ValleyOfTheMtns on Tuesday February 21, 2017 @08:19PM (#13702024)
There is nothing more beautiful to someone than their own creations, even if it contradicts their advice about the craft.
Re:Good Plain English: The problem with writing manuals by Spooky23 on Tuesday February 21, 2017 @07:46PM (#13701800)
Many manuals turn into this weird passive-aggressive ass covering exercises, especially internal manuals.

The low for me was a 16 page manual for using an RSA token!