News for hackers. Stuff that matters.
Re:Some things I've learnt about writing by telemachos on Friday July 13, 2012 @08:40AM (#4239543)
As a counterpoint to the Strunk and White recommendation, please take a look at this: 50 Years of Stupid Grammar Advice[1]. (Note that it doesn't primarily object to the stylistic advice in S&W, which it calls "vapid" but "mostly harmless". The real objections are to the grammatical claims and advice.)

Two books on writing I strongly recommend:

Clear and Simple as the Truth: Writing Classic Prose[2], exerpt here[3].

Style: Towards Clarity and Grace - this one has gone through countless versions as the publisher seems to re-release it every academic year. (Make used copies obsolete and raise the price.) I prefer the older, shorter versions to the more recent ones. It was clearer itself when briefer! Anyhow, here's an author search on Amazon - look for older used copies[4]. Edit: Just found this outline of the 6th ed. of the book. A good way to see what he covers in a hurry.[5]

The first is not a standard writing guide; it's a thoughtful analysis of what makes a certain kind of writing clear and persuasive. The second is a more nuts-and-bolts guide to writing. They're both excellent.

[1]: http://chronicle.com/article/50-Years-of-Stupid-Grammar/2549...

[2]: http://classicprose.com/

[3]: http://classicprose.com/csx.html

[4]: http://www.amazon.com/Joseph-M.-Williams/e/B001H6MZ40/ref=nt...

[5]: http://www.oxfordtutorials.com/StyleTenLessons.htm

Re:Some things I've learnt about writing by tgrass on Friday July 13, 2012 @12:06PM (#4240370)
I second Towards Clarity and Grace.

Additionally, Orwell's Politics and the English Language https://www.mtholyoke.edu/acad/intrel/orwell46.htm.

And as for listening to editors, the world is your editor. Put your writing into the hands of anyone you can and ask for feedback. When someone says it is great, thank them and move on until you find someone who can honestly provide constructive criticism...your work is never great.

Re:Some things I've learnt about writing by jgrahamc on Friday July 13, 2012 @08:51AM (#4239579)
Thanks for those recommendations. I was looking for my next few books to read.
Re:Some things I've learnt about writing by jeremyt on Friday July 13, 2012 @11:02AM (#4240075)
I've read those, which are good, but I think this one is better than all of them put together:

http://www.amazon.com/Writing-Well-30th-Anniversary-Edition/...

Re:Some things I've learnt about writing by telemachos on Friday July 13, 2012 @11:11AM (#4240108)
Without arguing for or against it, I'll just say it's the first book JGC recommends in his linked post. :)
Re:Some things I've learnt about writing by jeremyt on Friday July 13, 2012 @01:15PM (#4240711)
I'm just going to fess up and say that I didn't read the linked post, just the comments.
Re:Some things I've learnt about writing by telemachos on Friday July 13, 2012 @04:47PM (#4241796)
We all do it sometimes, and it's no big deal. I just couldn't pass up the smile.
Re:Some things I've learnt about writing by rgraham on Friday July 13, 2012 @11:30AM (#4240206)
This book is on my shelf. It's a thoughtful and practical approach to language and writing. The prose in the book is often winking at you as it reveals a principle.
Re:Some things I've learnt about writing by wmat on Friday July 13, 2012 @01:16PM (#4240714)
Two books I've found quite useful are:

The Elements of F*cking Style: a helpful parody. http://www.amazon.ca/Elements-cking-Style-Helpful-Parody/dp/...

The Yahoo Style Guide http://www.amazon.ca/Yahoo-Style-Guide-Ultimate-Sourcebook/d...

Re:Some things I've learnt about writing by dfc on Friday July 13, 2012 @02:41PM (#4241207)
I would add Garner's Modern American Usage.
Re:Some things I've learnt about writing by b_emery on Friday July 13, 2012 @01:58PM (#4240939)
> One risk with technical writing is what I call the fog of knowledge. You know so much about a subject that it's hard to write for someone who isn't as knowledgeable.

Never heard it described that way, but it brilliantly summarizes the point. I think this is why you sometimes learn better from peers than from profs (or other teachers).

Re:Some things I've learnt about writing by AhtiK on Friday July 13, 2012 @01:53PM (#4240904)
My favorite book on writing comes from advertising. Two authors, Kenneth Roman (former Ogivly CEO) and Joel Raphaelson (former Ogivly creative director): Writing That Works (http://www.amazon.com/Writing-Works-Communicate-Effectively-...)

This book has been transforming my long and vague e-mails, letters and blog posts into more crisp and to the point while keeping the tone of the message. Still learning, the book has tons of concrete advice to follow.

Re:Some things I've learnt about writing by Swizec on Friday July 13, 2012 @07:46AM (#4239347)
> Think about the reader -> I've often heard people say "write for yourself"

Here's the truth, everyone who tells you they're writing for themselves is lying. If they were writing for themselves, they wouldn't publish it publicly.

Re:Some things I've learnt about writing by jstraszheim on Friday July 13, 2012 @11:36AM (#4240251)
It seems pretty unnecessary to call such people liars. Surely they know their own minds better than you.

Anyhow, it is not too difficult to understand the “write for yourself” aesthetic, if you are willing to make the effort. I think Jane Espenson describes it best: http://www.janeespenson.com/archives/00000619.php

Re:Some things I've learnt about writing by tjr on Friday July 13, 2012 @09:26AM (#4239682)
Why cannot both be true? You write something for yourself, but also publish it in the event that it benefits someone else.

But even so, I think the context here was more like "write the sort of book you would like to read", not strictly "write the book so that I and I alone can then read it".

Re:Some things I've learnt about writing by tgrass on Friday July 13, 2012 @12:16PM (#4240411)
"Write for yourself" is shorthand. In part, it's to get an individual writing. After a hundred pages of short stories and essays it might evolve to a more restrictive "find your voice".

Once a writer finds a consistent voice, with recurring themes and techniques, the call to write for oneself is unnecessary. There's enough material for an editor to work with that more specific and constructive criticism can be given.

Re:Some things I've learnt about writing by danmaz74 on Monday July 23, 2012 @04:45AM (#4280131)
Maybe we should interpret that advice as "write about something that is interesting to you"? You could write about something that you find genuinely interesting, but in a way that makes it accessible to your audience (which isn't yourself, unless you're wrinting your personal diary).