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.

Writing well

279 pointsby doover 4 years ago

29 comments

jgrahamcover 4 years ago
I found this very hard to read. There are so many short sentences and bullet points that it looks like a PowerPoint presentation masquerading as prose.<p>What he seems to have lost with this approach is a rhythm. It&#x27;s a staccato battering with ideas. I&#x27;d much rather be seduced and cradled by writing that made me feel I&#x27;m learning by osmosis and not trepanning.<p>EDIT:<p>The author illustrates how his writing goes wrong by saying that the following paragraph:<p><i>To be brief on the sentence-level, remove words that don’t add necessary context. Extra words cause readers to slow down and do extra work. That makes it harder for them to recognize the sentence’s point. And when you bore readers, they quit reading.</i><p>is better rewritten as:<p><i>Your sentence is brief when no additional words can be removed. Being succinct is important because filler buries your talking points and bores readers into quitting.</i><p>It&#x27;s not. The two sentence rewrite is ugly. The first sentence is weird because it uses &quot;additional&quot; (which sounds like adding something) for things that will be removed. The second sentence uses &quot;talking points&quot; which makes it appear the writer is aiming for sound bites and not to educate the reader.<p>I much prefer the first paragraph above. Partly because it makes me empathize with the trouble readers might have and makes me want to work for them. When I read the first paragraph I imagine myself, the reader; when I read the second I&#x27;m being instructed by a voice that sounds like it comes from a cold machine.
评论 #25219853 未加载
评论 #25218994 未加载
评论 #25219117 未加载
评论 #25220951 未加载
评论 #25221595 未加载
评论 #25218848 未加载
评论 #25220127 未加载
评论 #25219909 未加载
评论 #25219631 未加载
评论 #25222129 未加载
评论 #25218943 未加载
评论 #25220300 未加载
评论 #25222832 未加载
评论 #25219776 未加载
评论 #25221189 未加载
CaptArmchairover 4 years ago
This is a well written tutorial about writing well. It practices what it preaches. And it makes good points about clarity, succinctness and persuasiveness.<p>This isn&#x27;t a tutorial about &quot;writing well&quot; in general. It focusses on a particular way of writing: writing short articles that sell a specific idea, service or product to as many readers as possible. It&#x27;s a practice that won&#x27;t make great or enjoyable novels, though. And while Hemingway became famous for his terse and objective prose, so did the eclectic writing of James Joyce or the long winded storytelling of Proust.<p>I feel that tone of voice and style are crucial in one&#x27;s writing. The words you choose, ordering of your sentences, the construction of your argument, attention for positive or negative sentiment,... shape the perception with your audience. The author only briefly glosses over those points in his fourth section, before admitting it needs expansion. And yet, without developing those, your writing won&#x27;t yield much life to the topic you want to brings across.<p>This brings me back to the style of this tutorial. It&#x27;s well written in a particular context, bring a point across as quickly and efficiently as possible, but it&#x27;s written in a style which I don&#x27;t enjoy at all. It&#x27;s a purely functional, dry, uncompromising way of writing. It&#x27;s a style that comes with risks and trade offs.<p>This type of writing might come off as treating the reader as a passive agent that needs to be educated. And the key in doing so is applying well known devices to achieve that goal as quickly and efficiently as possible. Push the right buttons and you&#x27;ll be able to build the desired sentiment with your audience.<p>This shines through, for instance, in his second section - objectives - where his bullet points read as:<p>&gt; Open people’s eyes by proving the status quo wrong.<p>&gt; Identify key trends on a topic. Then use them to predict the future.<p>While this isn&#x27;t inherently wrong, these are bold tactics that create huge expectations at the start of the article. As an author, you better make sure you can deliver on your promise when you go down that road. Worst case, you may come of as presumptuous, even pretentious, and lose a big chunk of your target audience, while the readers that stick likely already are part of the parish you&#x27;re preaching to.<p>Writing only becomes better when you go on a journey of identifying your own intentions, and confronting your own trepidation. Why do you want to write? Who do you want to convince? Why do you want to convince them? What do you hope to achieve with your writing? What is your relationship with the reader and what defines your relationship with your readers? What is the importance to you, personally, in writing down your thoughts? What is it you want to express through your writing?<p>Answering these questions as you practice your writing will provide the building blocks you need to define your style, your tone of voice, the pace of your writing and so on.<p>Without a due amount of self reflection, authors might risk treating this type of writing into a golden hammer. Writing only becomes compelling if there&#x27;s clear, genuine, personal investment in the content itself. Without it, &quot;writing like Paul Graham or Derek Sivers&quot; risks turning into a cargo cult like practice which produces boring, look-a-like writing.
评论 #25222193 未加载
评论 #25221651 未加载
lqetover 4 years ago
The style of this article reminds me of Wittgenstein: short, clinical, almost mathematical statements, with no poetical ambition whatsover. I understand that there might be situations in which such a style is appropriate, but this article is just very annoying to read. I would not definitely not call it &quot;good writing&quot;.<p>The kind of &quot;clarity&quot; presented here as good writing works well if you assume that everything that can be thought can be directly expressed in words, without substantial loss. This is clearly not the case. Language is a very poor medium to transmit throughts and feelings. So the &quot;trick&quot; every good writer uses is this: don&#x27;t describe something directly, but instead try to construct some secondary clues, hints and a general atmosphere that will start a thought process <i>in the reader&#x27;s mind</i> which leads to the conclusions you want to bring across. This is the poetic approach, it could also simply be called &quot;writing between the lines&quot;.<p>In my experience, this approach is a much more effective transmitter of ideas than trying to describe them directly, also for the simple reason that the reader will subconsiously assume that it is <i>his own idea</i>.<p>You need beautiful prose, rhythm and images to achieve that, as those open up this additional dimension. The article undertakes considerable (even pedantic) effort to leave that dimension closed.
评论 #25220307 未加载
评论 #25221199 未加载
young_unixerover 4 years ago
You know what I consider engaging writing? HN comments<p>Good HN comments are longer than tweets but shorter than essays, they strike a perfect balance of expressing an interesting idea in a reasonable time. And they always have an underlying, implicit amount of playful pedantry that makes them even more fun to read.<p>This very comment was fun to write because not even I know if I&#x27;m being sarcastic or not.
评论 #25256225 未加载
will_pseudonymover 4 years ago
The resource that has spurred me into thinking differently about effective writing was shared on HN, from UChicago Social Sciences&#x27; Leadership Lab - The Craft of Writing Effectively.<p><a href="https:&#x2F;&#x2F;www.youtube.com&#x2F;watch?v=vtIzMaLkCaM" rel="nofollow">https:&#x2F;&#x2F;www.youtube.com&#x2F;watch?v=vtIzMaLkCaM</a>
评论 #25267668 未加载
评论 #25223967 未加载
评论 #25218769 未加载
评论 #25218971 未加载
prof-dr-irover 4 years ago
Am I the only one who thinks that sinlge-sentence paragraphs should be the exception, not the rule?
评论 #25218650 未加载
评论 #25218608 未加载
评论 #25218796 未加载
评论 #25218506 未加载
评论 #25218622 未加载
评论 #25218933 未加载
评论 #25220555 未加载
评论 #25218953 未加载
episode0x01over 4 years ago
Would also recommend On Writing Well by William Zinsser. Amazing guide on writing nonfiction.
throwaway98797over 4 years ago
Too much clarity loses writing voice.<p>Poor writers with substance can create compelling content.<p>Sometimes I want the cliff notes and sometimes I want to be enamored with some lovely prose that leads me somewhere and makes me think.
评论 #25220786 未加载
sixhobbitsover 4 years ago
This looks amazing - added it to my collection of technical writing resources [0].<p>I&#x27;d also specifically recommend this talk by Larry McEnerney [1] which I discovered only recently in spite of actively looking for similar content - I guess I have a bias for written stuff.<p>[0] <a href="https:&#x2F;&#x2F;github.com&#x2F;sixhobbits&#x2F;technical-writing&#x2F;blob&#x2F;master&#x2F;resources.md" rel="nofollow">https:&#x2F;&#x2F;github.com&#x2F;sixhobbits&#x2F;technical-writing&#x2F;blob&#x2F;master&#x2F;...</a><p>[1] <a href="https:&#x2F;&#x2F;www.youtube.com&#x2F;watch?v=vtIzMaLkCaM" rel="nofollow">https:&#x2F;&#x2F;www.youtube.com&#x2F;watch?v=vtIzMaLkCaM</a>
huijzerover 4 years ago
Great read with pleasing aesthetics. However, there is one point I do not agree with, namely:<p>&gt; That isn&#x27;t to say children should understand your references and jargon. Do not over-simplify your language and weaken your ideas. Rather, children must be able to follow the logic of every argument.<p>Richard Feynman argues that people often hide between jargon to hide the fact that one doesn&#x27;t know. As a programmer, I often see jargon as an additional dependency and only introduce it if I really cannot avoid it.
johnharrisonover 4 years ago
Brevity and concision on their own are monotonous. You may have stumbled on this before but Gary Provost talks about writing &#x27;music&#x27;:<p>&quot;This sentence has five words. Here are five more words. Five-word sentences are fine. But several together become monotonous. Listen to what is happening. The writing is getting boring. The sound of it drones. It’s like a stuck record. The ear demands some variety.<p>Now listen. I vary the sentence length, and I create music. Music. The writing sings. It has a pleasant rhythm, a lilt, a harmony. I use short sentences. And I use sentences of medium length. And sometimes when I am certain the reader is rested, I will engage him with a sentence of considerable length, a sentence that burns with energy and builds with all the impetus of a crescendo, the roll of the drums, the crash of the cymbals—sounds that say listen to this, it is important.<p>So write with a combination of short, medium, and long sentences. Create a sound that pleases the reader’s ear. Don’t just write words. Write music.&quot;<p>Stripping a sentence to its cleanest components is a worthy aim but not at the cost of composition. Because, writers are part composers. In gmail, you&#x27;re not prompted to &#x27;write&#x27; an email. You&#x27;re prompted to &#x27;compose&#x27; it.<p>Brevity for its own sake isn&#x27;t sustainable.
评论 #25226255 未加载
cercatrovaover 4 years ago
Note that Julian runs an SEO and growth marketing company, so the type of writing here is more for that purpose, to sell your product, than to become the next great author.
评论 #25223271 未加载
评论 #25220607 未加载
Cyberthalover 4 years ago
&gt; Welcome<p>Wasted heading. What website doesn&#x27;t welcome readers? An offline one.<p>&gt; To write well is to think clearly.<p>No, it&#x27;s to communicate well. There is beautifully-written nonsense.<p>&gt; If you can think clearly, you can find something worth saying.<p>Meaninglessly asserts a relationship between two ambiguous thresholds. A vague thought not worth saying!<p>&gt; An ideal place to start is thinking through what bothers you most in life.<p>No. That problem is likely too difficult. The correct essay topic is whatever thought won&#x27;t go away until it&#x27;s written down.<p>&gt; The best writing is therapy that you publish for the world to learn from.<p>False: <a href="https:&#x2F;&#x2F;en.wikipedia.org&#x2F;wiki&#x2F;List_of_best-selling_books" rel="nofollow">https:&#x2F;&#x2F;en.wikipedia.org&#x2F;wiki&#x2F;List_of_best-selling_books</a><p>That&#x27;s where I stopped reading.<p>I know what Julian&#x27;s trying to express. My Pubmind-T3 blogs are for publishing early and often, which is a best practice. But without Textmind (or David Allen&#x27;s GTD), thinking in essays would be a frustratingly overloaded affordance.<p>Good writing, like clear thought, is reliably produced only via sound process.
danukerover 4 years ago
Reminds me of How tech writing ruined me as a letter writer:<p><a href="https:&#x2F;&#x2F;www.reddit.com&#x2F;r&#x2F;funny&#x2F;comments&#x2F;4dmufm&#x2F;how_tech_writing_ruined_me_as_a_letter_writer&#x2F;" rel="nofollow">https:&#x2F;&#x2F;www.reddit.com&#x2F;r&#x2F;funny&#x2F;comments&#x2F;4dmufm&#x2F;how_tech_writ...</a>
adamfaliqover 4 years ago
I have written a similar blogpost on writing here [0], which was received well by HN community. I&#x27;d also recommend the book &quot;Style: Toward Clarity and Grace&quot; and this document [1]. These resources tremendously helped me to improve my writing.<p>[0] <a href="https:&#x2F;&#x2F;adamfaliq.wordpress.com&#x2F;2020&#x2F;10&#x2F;28&#x2F;write-well&#x2F;" rel="nofollow">https:&#x2F;&#x2F;adamfaliq.wordpress.com&#x2F;2020&#x2F;10&#x2F;28&#x2F;write-well&#x2F;</a><p>[1] <a href="https:&#x2F;&#x2F;cpb-us-w2.wpmucdn.com&#x2F;u.osu.edu&#x2F;dist&#x2F;5&#x2F;7046&#x2F;files&#x2F;2014&#x2F;10&#x2F;UnivChic_WritingProg-1grt232.pdf" rel="nofollow">https:&#x2F;&#x2F;cpb-us-w2.wpmucdn.com&#x2F;u.osu.edu&#x2F;dist&#x2F;5&#x2F;7046&#x2F;files&#x2F;20...</a>
评论 #25222021 未加载
idlewordsover 4 years ago
The first step to writing well is to avoid taking advice from people who write this poorly. I recommend Paul Zinnser&#x27;s &quot;On Writing Well&quot; as an alternative to whatever this bad writer is shilling.
评论 #25223238 未加载
评论 #25224222 未加载
auganovover 4 years ago
&gt; The Shakespeares, Twains, and Austens of the future won&#x27;t emerge from the book publishing industry. They’ll come from YouTube, podcasts, and blogs.<p>The author pushes for a cold technical writing style. Then he brings up a bunch of literary writers? The two worlds are very much at odds.<p>The worship of the literary that&#x27;s all too common in classrooms is, I believe, why so many people are scared of writing anything in the first place. And then there&#x27;s the obsession with grammar.
geocrasherover 4 years ago
If you want to write, stop worrying about writing. Worrying about writing isn&#x27;t writing. It&#x27;s just spending time and energy that could otherwise be used as writing. So, write something. Then read it back to yourself out loud. If something sounds stupid, change it.<p>Now do that every day at least once.<p>Congratulations. You&#x27;re a writer.<p>[Edited because I read it out loud to myself and some parts sounded stupid]
评论 #25224640 未加载
justforfunhereover 4 years ago
Reading works written by masters is one way in which one can organically internalize the art of writing well.<p>Another thought that comes to my mind regarding writing is that why does one have to necessarily follow a particular set of rules?<p>Writing is an art. You should be able to develop and hone your own style, your own signature, something that stands apart from others, yet is readable and lucid.
评论 #25219025 未加载
projectileboyover 4 years ago
“Writing well” often takes different shapes in different contexts. The author’s example seems fine, maybe, for product copy, but it certainly isn’t applicable everywhere.<p>If you (or the author) disagree, then you have to explain what Jane Austen doesn’t understand that you do.
mattlutzeover 4 years ago
There&#x27;s a lot of people disagreeing here on the definition of &quot;well,&quot; and it&#x27;s interesting to see in real-time how the various assumed definitions result in assessments that are both valid and disagree with each other.
social_quotientover 4 years ago
Unrelated:<p>What style of icons and graphics are these? They seem hand drawn but I am wondering if stylistically there is a name so I can hunt down something similar or find more inspiration like this.
评论 #25219662 未加载
sethgeckoover 4 years ago
Didn&#x27;t think much of the content but I am impressed he managed to get the julian.com domain and the @julian twitter handle. I would assume that it&#x27;s a pretty common name.
2143over 4 years ago
Just get The Elements of Style by William Strunk Jr and read it cover to cover.<p>It&#x27;s cheap, small (less than 70 pages.. don&#x27;t remember exactly) and full of useful actionable tips.
olufnaeseover 4 years ago
Why is there a new paragraph for every sentence?
j7akeover 4 years ago
This article on writing well seems to be missing basic paragraph structures, which is probably why some find it hard to read.
matthewowenover 4 years ago
This reads like GPT-3
redelbeeover 4 years ago
This reminds me of my first unsuccessful job interview. I came away from it with totally unexpected lessons about writing and life.<p>I had just moved across the country after leaving my job at a newspaper. The job posting was for a copy editor at an in-house trade magazine at a Texas education nonprofit. They called me in for an interview, likely because I had copy editing experience on my resume.<p>Nothing unexpected happened. I talked to a few folks and the hiring manager, completed a copy editing exercise meant to test my competence at finding and addressing various spelling&#x2F;grammar&#x2F;AP style issues, and made my way back to the hiring manager before the final meeting with a few higher level executives.<p>The whole day went to shit when I found myself giving an honest answer to an off-hand question posed by the hiring manager. I heard myself talking about my fascination with writers, and especially those who made convincing and beautiful arguments while ignoring seemingly every rule and convention of the grammar and style books I had mastered in journalism school. As the words wound out of my brain through my mouth I knew there was no getting back to the promising path to a full-time copy editing job I had been on for the last few hours.<p>Based on our conversation thus far I knew this hiring manager was unlikely to be interested in my point of view, or in hiring me, now that the truth was out. A few minutes after we met she told me about how important the copy editor role was, especially since the educators who read the magazine tended to be sticklers when it came to matters of grammar and style. She knew this to be true because her first title at the company was, you guessed it, Copy Editor. It was as if I was running the final stages of a FAANG interview gauntlet, only to find myself loudly extolling the benefits of working for small startups.<p>She reacted as negatively as you would expect, and we moved on to the final portion of the day with the executives. By now I knew my job search would have to continue. The day wasn’t a total waste, however, because the CEO and founder of the nonprofit asked me the final question of the day.<p>“Is there anything else you want to know about me or the nonprofit I started before we wrap up?”<p>I knew there would be no job offer, so I decided to ask about something I was actually interested in knowing. I asked him if he had any regrets in his life, and told him I wanted to know because he was clearly successful and I rarely had the opportunity to ask about the pitfalls of success. He looked at me for a few moments and I wasn’t sure if I had managed to step in another pile of shit. When he finally responded it was to tell me slowly, then quickly, about the neglected relationships in his life, especially those with his children. We talked about the nature of family and friendships for a few minutes and I came away feeling much better about the whole situation.<p>I didn’t get the job (they gave it to a freshly minted English PhD) but I’ll never forget what I learned that day. Grammar and style don’t really matter, even when you’re interviewing for a job ostensibly concerned with nothing else. People and our connections absolutely do matter, and it’s those relationships by which we should judge our success in life.
StormofBytesover 4 years ago
I don&#x27;t know why but blog post comes off as a bit pretentious to me.