TE
TechEcho
Home24h TopNewestBestAskShowJobs
GitHubTwitter
Home

TechEcho

A tech news platform built with Next.js, providing global tech news and discussions.

GitHubTwitter

Home

HomeNewestBestAskShowJobs

Resources

HackerNews APIOriginal HackerNewsNext.js

© 2025 TechEcho. All rights reserved.

On Writing Well

130 pointsby free9 months ago

14 comments

derstander9 months ago
Just going by the title, I thought this was going to be related to William Zinsser&#x27;s book of the same name. It&#x27;s not, though of course many of the topics are shared between the two.<p>It&#x27;s been a few years since I&#x27;ve returned to it, but the material in Zinsser&#x27;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&#x27;s book if you like the content in the article and wouldn&#x27;t mind a bit more.
评论 #41301056 未加载
评论 #41339084 未加载
评论 #41339894 未加载
stavros9 months ago
I&#x27;d add &quot;don&#x27;t use demonstratives, like &#x27;this&#x27; and &#x27;that&#x27;, repeat the clause&quot;. Sometimes, &quot;that&quot; is ambiguous, leading to unclear writing.<p>E.g. &quot;The foo program is running on the bar server. Who is in charge of that?&quot; vs &quot;The foo program is running on the bar server. Who is in charge of the bar server?&quot;
评论 #41299539 未加载
评论 #41337231 未加载
评论 #41300498 未加载
评论 #41341107 未加载
altgans9 months ago
There was another article&#x2F;blog on hackernews some time ago along the lines of &#x27;I&#x27;m an editor, here is how I edit my friends texts&#x27; with some really good advice.<p>Unfortunately I can&#x27;t find it anymore -- if someone knows which post I mean, I&#x27;d appreciate sharing it with me again.
评论 #41339340 未加载
eatonphil9 months ago
On Writing Well by Zinsser is my favorite book on nonfiction writing. 10&#x2F;10 recommend to folks who&#x27;d like to work on their writing.
评论 #41337255 未加载
rramadass9 months ago
For Technical Writing, follow &quot;The Minto Pyramid Principle&quot; (<a href="https:&#x2F;&#x2F;untools.co&#x2F;minto-pyramid&#x2F;" rel="nofollow">https:&#x2F;&#x2F;untools.co&#x2F;minto-pyramid&#x2F;</a>), keep everything Concise, Precise, use Assertive&#x2F;Definitive voice and show Usage with Examples in the beginning itself.
评论 #41300824 未加载
condortg9 months ago
For anyone interested in the topic, I would recommend reading this article:<p><a href="https:&#x2F;&#x2F;www.americanscientist.org&#x2F;blog&#x2F;the-long-view&#x2F;the-science-of-scientific-writing" rel="nofollow">https:&#x2F;&#x2F;www.americanscientist.org&#x2F;blog&#x2F;the-long-view&#x2F;the-sci...</a>
surfingdino9 months ago
Also, get a copy of Strunk &amp; White&#x27;s &quot;The Elements of Style&quot; and read it often.
paulpauper9 months ago
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&#x27;t work as well as assumed or advertised. Simple writing is great if you&#x27;re writing a brochure or instructional guide, but I don&#x27;t think it&#x27;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 months ago
As an engineer who became a founder, I cannot recommend the book enough. Whether you&#x27;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.<p>Invest in improving your writing skills. It will pay dividends in every aspect of your business.
评论 #41339183 未加载
chrisweekly9 months ago
Related book recommendation: &quot;First, You Write a Sentence&quot;, by Joe Moran. Even if you&#x27;re not aspiring to improve your own writing, and you simply love to read, it&#x27;s really worthwhile.
ruuda9 months ago
<a href="https:&#x2F;&#x2F;developers.google.com&#x2F;tech-writing" rel="nofollow">https:&#x2F;&#x2F;developers.google.com&#x2F;tech-writing</a> covers the same topics in more detail.
mo_429 months ago
For technical writing, journalism, etc., one can follow the simple rule <i>no adjectives</i>.<p>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.)<p>Edit: past perfect based on comment
评论 #41336972 未加载
layer89 months ago
I hope I’m not the only one who cringes at the “asks” terminology, in the context of “writing well”.
评论 #41346267 未加载
kuba_dmp9 months ago
Reading it reminded me of a book &quot;Writing without bullshit&quot; which adds a few more concepts to what op shared.<p>Frontloading information is my favorite, where instead of building to the core conclusion you start with it and then expand.<p><a href="https:&#x2F;&#x2F;www.goodreads.com&#x2F;book&#x2F;show&#x2F;28448362-writing-without-bullshit" rel="nofollow">https:&#x2F;&#x2F;www.goodreads.com&#x2F;book&#x2F;show&#x2F;28448362-writing-without...</a>