科技回声

14 条评论

Just going by the title, I thought this was going to be related to William Zinsser's book of the same name. It's not, though of course many of the topics are shared between the two.It's been a few years since I've returned to it, but the material in Zinsser's book has been useful to me as an engineer that has to occasionally write for both fellow engineers and non-technical folks. I would recommend Zinsser's book if you like the content in the article and wouldn't mind a bit more.

评论 #41301056 未加载

评论 #41339084 未加载

评论 #41339894 未加载

stavros9 个月前

I'd add "don't use demonstratives, like 'this' and 'that', repeat the clause". Sometimes, "that" is ambiguous, leading to unclear writing.E.g. "The foo program is running on the bar server. Who is in charge of that?" vs "The foo program is running on the bar server. Who is in charge of the bar server?"

评论 #41299539 未加载

评论 #41337231 未加载

评论 #41300498 未加载

评论 #41341107 未加载

altgans9 个月前

There was another article/blog on hackernews some time ago along the lines of 'I'm an editor, here is how I edit my friends texts' with some really good advice.Unfortunately I can't find it anymore -- if someone knows which post I mean, I'd appreciate sharing it with me again.

评论 #41339340 未加载

eatonphil9 个月前

On Writing Well by Zinsser is my favorite book on nonfiction writing. 10/10 recommend to folks who'd like to work on their writing.

评论 #41337255 未加载

rramadass9 个月前

For Technical Writing, follow "The Minto Pyramid Principle" (<a href="https://untools.co/minto-pyramid/" rel="nofollow">https://untools.co/minto-pyramid/</a>), keep everything Concise, Precise, use Assertive/Definitive voice and show Usage with Examples in the beginning itself.

评论 #41300824 未加载

condortg9 个月前

For anyone interested in the topic, I would recommend reading this article:<a href="https://www.americanscientist.org/blog/the-long-view/the-science-of-scientific-writing" rel="nofollow">https://www.americanscientist.org/blog/the-long-view/the-sci...</a>

surfingdino9 个月前

Also, get a copy of Strunk & White's "The Elements of Style" and read it often.

paulpauper9 个月前

Then how does this account for the success or writers who do not write simply or use a more advanced structure or verbosity? I think writing tips are overrated. They don't work as well as assumed or advertised. Simple writing is great if you're writing a brochure or instructional guide, but I don't think it's an iron clad rule for expository writing or creative writing or blog writing. There are too many exceptions. The best writing is that in which the message most aligns with the values of the recipient.

评论 #41339133 未加载

hubraumhugo9 个月前

As an engineer who became a founder, I cannot recommend the book enough. Whether you're improving your landing page, writing your pitch deck, reaching out to customers, or developing your company and product strategy, communicating effectively in writing is a very crucial skill.Invest in improving your writing skills. It will pay dividends in every aspect of your business.

评论 #41339183 未加载

chrisweekly9 个月前

Related book recommendation: "First, You Write a Sentence", by Joe Moran. Even if you're not aspiring to improve your own writing, and you simply love to read, it's really worthwhile.

ruuda9 个月前

<a href="https://developers.google.com/tech-writing" rel="nofollow">https://developers.google.com/tech-writing</a> covers the same topics in more detail.

mo_429 个月前

For technical writing, journalism, etc., one can follow the simple rule no adjectives.For prose, replace all common adjectives by more specific or descriptive one, or even remove them too and describe properties. For example: The F-35 passed by my house. When I heard its sound, the jet had already disappeared at the horizon. (This describes super-sonic speed without an adjective or an overly precise speed number.)Edit: past perfect based on comment

评论 #41336972 未加载

layer89 个月前

I hope I’m not the only one who cringes at the “asks” terminology, in the context of “writing well”.

评论 #41346267 未加载

kuba_dmp9 个月前

Reading it reminded me of a book "Writing without bullshit" which adds a few more concepts to what op shared.Frontloading information is my favorite, where instead of building to the core conclusion you start with it and then expand.<a href="https://www.goodreads.com/book/show/28448362-writing-without-bullshit" rel="nofollow">https://www.goodreads.com/book/show/28448362-writing-without...</a>