News for hackers. Stuff that matters.
Re:On Technical Writing by wenc on Tuesday December 31, 2019 @02:41PM (#21924002)
Curious, what do folks get out of Zinnser's book specifically?

The title has made its rounds in tech circles for a while, and I've read it. Not to be an HN contrarian, but apart from a few tips that it offers toward the beginning, it's actually a pretty dry read and does not itself, in my opinion, reflect good writing (the first few chapters are OK, then it goes downhill from there). I read a lot and unfortunately I wouldn't say Zinnser's book is a piece of writing I would admire.

I've taken IRL creative writing courses since, and I gotten a lot more out of these, because not only did I manage to receive instruction in technique, I also received continuous direct feedback in the form of workshops and instructor critique.

Re:On Technical Writing by dnh44 on Tuesday December 31, 2019 @03:03PM (#21924231)
I feel that it helped me learn to write better business emails, by getting me to focus on writing clearly and concisely.

I’d have to refer to the book to be able to comment on the specifics of the advise though.

I also remember the beginning of the book being more interesting but perhaps the beginning was just more relevant to me.

Re:On Technical Writing by wenc on Tuesday December 31, 2019 @03:31PM (#21924473)
Since you brought up writing business emails...

For writing emails and structuring presentations I've found the Pyramid Principle [1] to be quite practical. (apparently McKinsey consultants are trained to do this, along with stuff like MECE, etc. Whatever we think the actual abilities of McKinsey consultants may be, they are generally pretty good at making million dollar PowerPoint decks :)

The idea is simple:

1. Start with the answer first.

2. Group and summarize your supporting arguments. (not more than 3)

3. Logically order your supporting ideas. (chronology, structure or priority)

The article below makes the point that "this “top-down” structure is counter-intuitive for many of us with a scientific or engineering background", but I've observed it is exactly this structure we must adopt for impactful business writing.

[1] https://medium.com/lessons-from-mckinsey/the-pyramid-princip...

Re:On Technical Writing by yesenadam on Tuesday December 31, 2019 @06:56PM (#21925651)
>a pretty dry read

I'm not sure what you mean, except you didn't enjoy his style? Gee, he seems the opposite of dry to me–a very warm, friendly, human voice. If you think he's pretty dry, who in the field do you prefer?

I don't think you can have read Zinsser. You misspell his name, and it's hard to believe your sentences are those of someone who's heard his message:

"Not to be an HN contrarian, but" – this adds nothing. The reader of On Writing Well learns to cut every unnecessary word.

"it's actually a pretty dry read and does not itself, in my opinion, reflect good writing" says unclearly in 16 words what could be said clearly in a few. Cut "actually", "in my opinion" and "itself". Does not reflect good writing – do you mean "it's not good writing"? i.e. "it's bad writing"? I'm not sure what saying a book "doesn't reflect good writing" means, but seemingly something other than its not being written well, or you would have said so, the reader assumes.

"unfortunately I wouldn't say Zinnser's book is a piece of writing I would admire." Again, the head spins, although what you're trying to say seems simple. If it's "I don't admire it", why not say so? If something else, say that. Simplicity! Etc.

I encourage you to give him another go!

Re:On Technical Writing by wenc on Tuesday December 31, 2019 @07:20PM (#21925742)
I think your response comes across as unnecessarily presumptuous and sarcastic. I did read Zinsser (that was a uncharitable blow -- names are misspelled all the time). However just because I have read him does not mean I have assimilated his style or prescriptions, and even if I have, I wouldn't necessarily apply them uniformly in all of my writing.

I will admit I am expressing a subjective preference, not an objective indictment of Zinsser (I did get some value out of the first few chapters). Perhaps this dissenting opinion didn't need to be expressed because in retrospect no value was added because I didn't provide specifics myself (though I could -- I'm happy to make the case). And it's possible that I'm being unfair to the work. So in light of that, I withdraw my statement. But I still don't appreciate your sarcasm.

Re:On Technical Writing by yesenadam on Tuesday December 31, 2019 @07:32PM (#21925794)
Hi, sorry, I wasn't being sarcastic at all. I meant every word sincerely and literally, including the questions. At first I thought I had no answer for "what do folks get out of Zinnser's book specifically?", but while writing my comment I discovered that I did! Sure, it wasn't very friendly, sorry for that. I was trying to help your prose. It seemed you mostly didn't like On Writing Well for its being a book, when you got much more from courses and their feedback.
Re:On Technical Writing by wenc on Wednesday January 01, 2020 @09:41PM (#21932539)
Thanks for your clarifying response. I appreciate it. Perhaps I took it the wrong way, and for that I apologize. Happy new year to you.