Live data from Hacker News

Lessons Learned from “On Writing Well”

robinwieruch.de

61–70 of 72 posts

Re: Lessons Learned from “On Writing Well”

#61

There's an amusing number of simple grammatical mistakes in this article.. ("english", "It is unnecessary words that don’t add meaning but complex sentence constructions.", "Write about “grass” except when (my insert) it has another color than green", "Avoid semicolons except when (my insert) you want the reader to make a pause", ...)

The non-native mistakes unwittingly reinforce the point of the article. I found it more readable than many articles having near-perfect grammar and style.

Re: Lessons Learned from “On Writing Well”

#62
post #4
post #3

I was so disappointed with this book. Some of the platitudes Zinsser goes into are reasonable, like try to be uncluttered, direct and to the point, but all the worked examples seem to just be arbitrarily chosen to his taste. For example, in the chapter on "clutter", Zinsser picks out this passage from Walden as his exemplar of "uncluttered English": "I went to the woods because I wished to live deliberately, to front…

I enjoyed (the first 2/3 of) Steven Pinker's The Sense of Style. It includes examples of where prescriptivism fails and succeeds.

He also has a YouTube video which is a great intro to his thoughts on writings.

https://www.youtube.com/watch?v=OV5J6BfToSw

Re: Lessons Learned from “On Writing Well”

#65
I was recommended Zinsser from a writer whose own writing is very wordy.

Personally, I prefer Strunk and White and the AP Style Guide.

But I was looking for good guides for technical documentation, web copy, and B2B high tech marketing material (case studies, data sheets, etc.).

Not how to write a non-fiction book.

Re: Lessons Learned from “On Writing Well”

#66

Earlier quoted context omitted.

"I went to the woods because I wished to live deliberately, to front only the essential facts of life, and see if I could not learn what it had to teach, and not, when I came to die, discover that I had not lived." Dense, incredibly difficult to parse, with a non-standard use of "front" as a verb and what seems to be a triple-negative. If I said that sentence to you, out loud, I doubt you would catch the meaning of i…

I completely agree. As another native English speaker I find the highlighted passage parses incredibly naturally. It feels like a single cohesive thought without the need for back-referencing despite encompassing several 'ideas'.

It's slightly stylised 19th century English, which is very different to 21st century English. We don't use run-on sentences peppered by parenthetical clauses nearly as much as we used to, so I'm not surprised some readers may find it dense.

For more modern English, I think George Orwell is very hard to beat.

For blog posts, Paul Graham is always worth reading - not so much for the content, which is often debatable, but for the style, which is reliably lucid.

But it's always a good idea to match the social register and jargon level of the target audience. Professional writers often work on a range of gigs and know how to mould English into a range of styles and voices to reach different audiences.

So I'd be skeptical of any suggestion there's a One True Style for online content or technical writing. There are certainly common standards and traditions, but they may be out of date or too company-specific to apply generally.

Re: Lessons Learned from “On Writing Well”

#67

Earlier quoted context omitted.

The IBM book "Developing Quality Technical Information" is the best I've read on technical writing. For writing style, pickup any novel by Hemingway and copy it. You can also Google "how to write like Hemingway" for some easy to follow basic rules. IMO, however, the biggest problem with most technical writing is not its style but rather the almost complete ignorance of what it should contain and how it should be stru…

Can you recommend some hemingway books?

I'd recommend The Sun Also Rises or The Old Man And The Sea for a first Hemingway book. They are both within novella length, so they make for easy reading. Farewell To Arms is probably my favourite, if only because of the last page. Hemingway rewrote it around 37 times because he had trouble getting the words right.

Re: Lessons Learned from “On Writing Well”

#68
post #3

I was so disappointed with this book. Some of the platitudes Zinsser goes into are reasonable, like try to be uncluttered, direct and to the point, but all the worked examples seem to just be arbitrarily chosen to his taste. For example, in the chapter on "clutter", Zinsser picks out this passage from Walden as his exemplar of "uncluttered English": "I went to the woods because I wished to live deliberately, to front…

Writing Classic Prose by Mark Turner and Francis Noel Thomas opened my eyes to a different way of thinking about prose style. Instead of focusing on surface features like "avoid the passive voice" and "use adverbs sparingly", it delves into the underlying assumptions of a specific style like the fictional situation (people in conversation), attitude to truth (it's possible to tell the truth about something so you don't need constant hedging), and the audience.

It's well worth reading that book, but it can be a bit repetitive. There's a chapter in Steven Pinker's The Sense of Style that explains classic style more concisely, and also has excellent advice about writing clearly and coherently founded on a more scientific understanding of how grammar and language cognition actually works.

Re: Lessons Learned from “On Writing Well”

#69
post #36

Earlier quoted context omitted.

I don't see anything wrong with the sentence besides maybe the use of "front" that you pointed out. I got it easily the first time reading it and I'm certain it would be just as clear to me spoken as long as I was paying attention.

I remember this story and the only (personal preference) issue I can take with it were the comma placements. Yikes. Shatner anyone?

Commas have two roles: syntactic and prosodic. Today, we almost always use them to indicate syntax: separating subclauses etc.

In the nineteenth century, they were commonly used to indicate prosody — breathing pauses and the intended rhythm of the sentence — which leads to comma placements that seem odd to modern eyes but would have been perfectly normal to a nineteenth-century reader. If you read any Jane Austen, George Eliot, or other Victorian writers, you'll see that sort of usage everywhere:

> "It is a truth universally acknowledged, that a single man in possession of a good fortune, must be in want of a wife."

Re: Lessons Learned from “On Writing Well”

#70
post #21
post #3

I was so disappointed with this book. Some of the platitudes Zinsser goes into are reasonable, like try to be uncluttered, direct and to the point, but all the worked examples seem to just be arbitrarily chosen to his taste. For example, in the chapter on "clutter", Zinsser picks out this passage from Walden as his exemplar of "uncluttered English": "I went to the woods because I wished to live deliberately, to front…

I'm sure you've seen it before, but The Economist's style guide is my usual resource: http://www.economist.com/styleguide/introduction

Every time I read the Economist I wonder if their apparent compulsion to explain everything is some sort of in-joke.

"The US, a large north-american country,...".

Post reply on HN