Thanks for the tip!

@Aaron:

I’ll check out the book, thanks. Wadler and SPJ seem like good references…do you have any particular favorites?

Have you looked at the crossword I made? You’ll definitely get 2D.

Benjamin ran an informal writing seminar a while back. (Did you hear about it?) It didn’t last long, but we read a few chapters from “Style: The Basics of Clarity and Grace” by Joseph M. Williams. That is really an incredible book. It breaks down and explains the principles of what makes good phrases, sentences, and paragraphs. We looked at papers by Phil Wadler and Simon Peyton-Jones to see examples of computer science writing done well.

http://tex.loria.fr/typographie/mathwriting.pdf

It’s a set of lecture notes with suggestions on how to write mathematics well.

That riddle is a little bit basic — you should watch Douglas Crockford’s “Advanced JavaScript” series. (I can’t find them, though, since Yahoo seems to have taken them down.) Check out my old post on closures over this for something even weirder.

@Brian:

Thanks for the link; I’ve heard about the book, so I’ll check it out. You’re definitely right about knowing the audience. Nevertheless, the general CS audience has very low standards, particularly when it comes to conference papers. I’m not looking merely for success (getting an article published), but I want to be proud of the quality of the final artifact: idea and paper (and, if I’m feeling plucky, software).

I think the key is to know your audience. You have to speak the same language as people. Even among “computer programmers” there are a huge variety of people immersed in a huge variety of different languages and different types of programming. No one book will ever be good for everyone.