Live data from Hacker News

Best Writing Advice for Engineers I've Ever Seen.

engineerwriting.jottit.com

1–10 of 75 posts

Re: Best Writing Advice for Engineers I've Ever Seen.

#4
This is similar to how one of my English TA's in college taught me to write essays. Perhaps this is standard advice, but to hear it so plainly put was new to me.

Paragraph 1: First sentence: Your thesis statement. Follow it with several sentences that back up different aspects of your thesis. Write a paragraph for each of those supporting sentences. The first and last sentence of each of those paragraphs should be the original sentence stated a bit differently. Last paragraph is a restatement of your first paragraph.

It sounds like a lot of repetition, but once I started following his advice, my writing quality improved vastly. It tends to impart a razor-like focus to the writing. Not to mention that the systematic quality of it almost makes it feel like the paper is writing itself.

Re: Best Writing Advice for Engineers I've Ever Seen.

#6
In a newspaper article, the paragraphs are ordered by importance, so that the reader can stop reading the article at whatever point they lose interest, knowing that the part they have read was more important than the part left unread.

I never knew that, though now that I've seen it said, it does seem accurate. Articles do lose importance as the article goes on. But I'd argue that it's a much older method, known as a "hook". Relying on a reader's knowledge of an unstated rule / guideline is effectively suicide when dealing with large quantities.

It does make good advice for engineers, though, especially as it's procedural. Follow the steps for win. If couched in these terms, you'd probably get more / better technical writing from most people.

Re: Best Writing Advice for Engineers I've Ever Seen.

#8
When I was working on my book O'Reilly sent me a copy of "On Writing Well" by William Zinsser (http://www.amazon.com/Writing-Well-Classic-Guide-Nonfiction/...). I read the entire book and I thought it was well worth it. One of his best pieces of advice is to end each paragraph leading the reader to the next one; the reader should want to know more.

It's slightly amusing that the first sentence of the linked article is grammatically incorrect: "How to make engineers write concisely with sentences?" is not a question despite the question mark. The second sentence is overly long and uses three commas to give the reader breathing space.

Re: Best Writing Advice for Engineers I've Ever Seen.

#9
post #2

aka "How to write a high school essay."

Additionally, I tend to ignore writing advice from people who use incomplete sentences. That page was a travesty.

edit: I didn't know this was a comment before I posted this, but it does bring up issues with 'blogging in general.

Post reply on HN