11 ms·
Write less
- dllthomas 13y ago"Omit words."
- chasing 13y ago"Omit unnecessary words."
- bigben 13y agoeschew surplusage
- RyanMcGreal 13y agoWhy use big words when grandiloquent locutions suffice?
- eCa 13y agoLike a good wine words tend to grow with time. (I believe the parent quoted Twain.)
- kalid 13y agoThis is the right amount of brevity, IMO. "Omit words" doesn't give you a hueristic about what to omit. "Needless" gives a test you can apply to every word. "Omit words" sounds simpler, even obvious, but only because you know it's a shortened form of "omit needless words". We could shorten the advice to "simplify", but that doesn't give you the how.
- dllthomas 13y agoIf a word is needed, obviously you won't omit it. It's a tongue in cheek response to the EoS quote ("Omit needless words"), not - devoid context - serious style guidance.
- vickytnz 13y agoI hope everyone knows you're quoting "The Elements of Style" en.wikipedia.org/wiki/The_Elements_of_Style
- dllthomas 13y ago... and I hope everyone is aware of both the virtues and the limits of that work.
- rthomas6 13y agoI'm not. Care to enlighten me?
- dllthomas 13y agoVirtues: A lot of the style rules are great guidelines. Limitations: minor: Style rules shouldn't be followed when they make things awkward or harder to understand; that's more a problem with some readers than the book, but it's something to keep in mind... less minor: A lot of the grammar proscriptions are confused at best (and not followed by the authors themselves, in that work or others). Language Log has oodles of examples: http://languagelog.ldc.upenn.edu/nll http://languagelog.ldc.upenn.edu/nll
- FreakLegion 13y agoThere was a good article in the Chronicle of Higher Education a while back: http://chronicle.com/article/50-Years-of-Stupid-Grammar/25497 http://chronicle.com/article/50-Years-of-Stupid-Grammar/2549...
- rmrfrmrf 13y ago"Omit."
- dllthomas 13y ago""
- Ari_Rahikkala 13y ago> Fewer words, create a more powerful message. Fewer commas, create a sentence that makes more sense.
- erroneousfunk 13y agoAlso needs a string.replace("less", "fewer") in v1
- jonny_eh 13y agoYou're nitpicking the grammar in a crossed out paragraph?
- chasing 13y ago(And this is where anyone with a background in writing sighs.)
- avelis 13y agoFrom what I understand writing a story to be read is not the same comparison to writing a story for information sharing via the internet. It's all about your audience. The audience who picks up a book wants to sit and read. Sometimes at length. tl;dr Writing blog posts and writing stories are comparing apples to oranges.
- bgnm2000 13y agoCouldn't agree more - I hope its obvious my post is regarding content such as blogs, articles, and web content (based on myself as the author). Not stories.
- bargl 13y agoMaybe you should have said that. :-)
- yannyu 13y agoNot the case at all. Writing blog posts, writing stories, writing emails, all share the same principle: use only the words necessary to convey the message. Just because story-writing has a lot more description does not mean that those words aren't necessary. For example, for Hamlet to simply say "I am conflicted about my current situation and am contemplating suicide", does not nearly give the same nuance or insight into what his thought process is as "To be, or not to be, that is the question:/Whether 'tis Nobler in the mind to suffer/The Slings and Arrows of outrageous Fortune,/Or to take Arms against a Sea of troubles,/And by opposing end them: to die, to sleep". tl;dr the goal of most forms of writing is to convey a message with just the right amount of words
- dllthomas 13y agoWhile your point is reasonable, particularly to modern style, I think your Hamlet example is far more "Show, don't tell" than any useful demonstration of preference for brevity.
- bgnm2000 13y agoThis isn't a statement about grammar, or how to structure your writing pieces. Its about articles / blogs I stumble upon (from hackernews) which are needlessly long. I want to read something, understand the message the author is trying to convey, and I want to move on.
- bowerbird 13y agowhatever. -bowerbird
- bowerbird 13y agoyou can downvote my "whatever" until the cows come home, but -- in the end -- that's what it'll all boil down to. seriously, ya'll have already accumulated 57 comments on a piece that says "be brief", with a hidden qualifier of "to the greatest extent possible without losing the plot." how many comments will it take you before you realize that you've been sent on a wild goose chase, chasing your tail? and now i too have over-explained. and wasted _my_ time. and undoubtedly will be docked a few more "karma" points, because some people don't wanna hear they've wasted time. -bowerbird
- fusiongyro 13y agoFrom the guidelines: http://ycombinator.com/newsguidelines.html http://ycombinator.com/newsguidelines.html - Please don't sign comments, especially with your url. They're already signed with your username. If other users want to learn more about you, they can click on it to see your profile. - Resist complaining about being downmodded. It never does any good, and it makes boring reading. - Please don't bait other users by inviting them to downmod you. We would be happy to have your participation in a discussion, but this method is boring, tiresome and uninteresting. If you're willing and capable of elevating your discourse a bit I'm sure we'd appreciate what you have to say, but if not, you may find other forums more inviting.
- bowerbird 13y agoi'm not "complaining about being downmodded." it's funny. nor am i "baiting" anyone, even though i am highly amused. and i think it's ironic that you totally missed the point that my "whatever" response is in keeping with the advice being offered by the article which is the thread's topic. while, at the same time, 87 comments have now been posted. evidently, the "be brief" message did not register here... and you say _i_ am the one who is "boring, tiresome, and uninteresting"? methinks the lady doth protest too much. -bowerbird
- danso 13y agoThe OP has the right mindset but the advice is not very helpful. It's not just overall number of words, but which words you remove. In general, you should cut adjectives. As C.S. Lewis notes: http://www.lettersofnote.com/2012/04/c-s-lewis-on-writing.html http://www.lettersofnote.com/2012/04/c-s-lewis-on-writing.ht... > In writing. Don't use adjectives which merely tell us how you want us to feel about the thing you are describing. I mean, instead of telling us a thing was "terrible," describe it so that we'll be terrified. Don't say it was "delightful"; make us say "delightful" when we've read the description. You see, all those words (horrifying, wonderful, hideous, exquisite) are only like saying to your readers, "Please will you do my job for me." Here's some advice from Woodrow Wilson that should strike a note with programmers who write modular code: http://books.google.com/books?id=zjcUAAAAIAAJ&pg=PA268&dq=%22when+you+frame+a+sentence%22&hl=en&sa=X&ei=cuMsUtCkNZGq4AOyv4DoBw&ved=0CDoQ6AEwAA#v=onepage&q=%22when%20you%20frame%20a%20sentence%22&f=false http://books.google.com/books?id=zjcUAAAAIAAJ&pg=PA268&dq=%2... > The best teacher I ever had used to say to me, “When you frame a sentence don’t do it as if you were loading a shotgun but as if you were loading a rifle. Don’t fire in such a way and with such a load that while you hit the thing you aim at, you will hit a lot of things in the neighborhood besides; but shoot with a single bullet and hit that one thing alone.”
- tommorris 13y agoAdjectives can be very useful. Let's take delightful. Imagine one is writing a ’50 Shades’-style S&M story. He ran through the previous night's activities. There was the brutal whipping, followed by a caning. He was forced to drink the urine of a dog, and then she stretched his arms out in agonising pain. "That sounds brutal," Melanie said with her eyelids agape. She had never understood the appeal of kinky sex. "No, it was delightful really," he said with a big, perverse grin on his face. Lewis' suggested rule against adjectives in writing is fine, but sometimes they are very useful for contrast or in dialogue. The adjectives you use can build up the character of a person, and can form part of their personal idiolect. Lewis' advice is fine and good, but one ought not to extrapolate from a rule against applying adjectives lazily in place of actual description to a rule against using adjectives at all.
- keesj 13y agoIronically though, without the author's previous revisions (saying the same thing multiple times) the article wouldn't deliver the message as well.
- rmrfrmrf 13y agoThe "revisions" aren't really revisions; they're part of the article. If you have the proper context, you don't need to be verbose. For example, if I go to your startup's website, I don't need to be told that "Company X is a lightweight web application that..."; if you have visuals and a context, information like "lightweight web application" is redundant.
- jamesaguilar 13y agoSometimes it's good to support a position with argumentation. Brevity is saying the same thing with fewer words. In this case, the blog post is actually saying less. That may work for something obvious, but take care before applying this rule universally.
- sengstrom 13y agoYes. A simple assertion does little to convince me of anything.
- MichaelMcQuirk 13y agoI do believe that the point he is trying to make is not that you should say the same thing but with fewer words, but rather that you should say ONLY what you NEED to say. ie. Don't beat around the bush!
- jalanb 13y agocomment more
- programminggeek 13y agoBrevity is good for some things. A long description full of descriptive adjectives is absolutely critical for certain types of writing that require you to literally paint a picture of scenery, emotion, and dialogue. Know what you're writing.
- deleted 13y ago[deleted]
- mbrock 13y agoBrevity isn't always a time-saver in technical writing, either. Sometimes it's confusing and ambiguous. Just consider that your words are real things that other people are going to encounter. Those people are often likely to be stressed, confused, or even angry – especially if you're making a web page. Is your user someone who has a problem that they want to solve right now? Then be as clear as you possibly can. Don't try to be funny or clever. Don't even try to be exceptionally brief!
- Tloewald 13y agoIf you're going to make this point, I like the story of the Oxford literature professor (probably a reader or don or some other weird title, but professor in US terms) who walked into class on his first day and said: "Omit. Needless. Words." And then: "Omit. Needless. Words." And then: "Omit. Needless. Words." And then walked out. End of first lecture.
- adambard 13y ago"Eschew surplusage", in the words of Mark Twain.
- ams6110 13y ago"Omit needless words" is from Strunk & White's Elements of Style
- Tloewald 13y agoYes but he follows it with a long paragraph saying the same thing in lots of different, less clear ways. Repeating those three words three times is, in fact, far more effective.
- anoplus 13y agoI was waiting for this kind of message for months!
- eCa 13y ago> Write less Write more, succinctly.
- alexanderRohde 13y agoThe ironic thing in this instance is that in a way the author is clearly negating his point by needing to show the crossed-out text. Imagine you had followed the link, and the only text was "Fewer words create a more powerful message." We would likely feel cheated at some level, like "That's it? How did one sentence get a whole HN link?" In a way we're conditioned to expect a bunch of garbage filler that we merely skim, and because that's what's in demand right now it's what authors are incentivized to provide.
- vinceguidry 13y agoI came here to say this. Brevity is not the goal. Mindless brevity destroys context. Concision is the goal. Bake the context into your prose. If you can't be concise, don't attempt to be brief. It will only annoy your readers.
- echohack 13y agoThe reality is that you need BOTH. This is how modern news articles are written: http://www.theverge.com/2013/9/24/4698382/second-lifes-strange-second-life http://www.theverge.com/2013/9/24/4698382/second-lifes-stran... Some people will skim and get the information. Some people will read and get entertainment. Some people want the details, because they need a deeper understanding. Some people want a high level overview, because they already understand things and just want the information. See also: Richard Feynman's books on physics.
- _mulder_ 13y agoA good example to prove the OP. Your Second Life article probably has some interesting things to say, I wouldn't know, I didn't read it. Instead I clicked the link, scrolled and scrolled and before I'd even got to the bottom I'd calculated it would take me about half an hour of my life to read the thing. I don't want to invest half an hour of my life in learning about someone's blow-by-blow account of their Second Life experience (I'd question anybody who does and point them to one of the numerous HN articles on procrastination/wasted time). An article that long devoted only to Second Life (condescension aside, there really are more important things, honestly) seems pretentious and serving the authors Ego more than the readers curiosity. Richard Feynman however, the secrets of the universe and world around us, yes, I would like to learn more about that.
- dfbrown 13y agoI think v4 has a very different message from v1-3. 1-3 seem to be saying value your readers time by writing as succinctly as possible whereas v4 says a shorter message is more powerful. This may sometimes be the case, but often it is not. Many of the most powerful speeches use repetition and deliberate at length on their message in order to emphasise it. Shortening them would probably have made the message less powerful.
- deleted 13y ago[deleted]
- deleted 13y ago[deleted]
- NovemberWest 13y agoThe last sentence leaves out very important points made in the struck-through versions about valuing the time of your audience. I am currently looking for more information-dense delivery mechanisms, among other things. The struck-through versions provide vivid illustration of the point, which provides a kind of information-density. Words are not your only medium, not even in copy, much less online generally.
- debacle 13y agoThis is missing a single word: "Sometimes."
- deleted 13y ago[deleted]
- davidad_ 13y ago"If I had more time, I would have written you a shorter letter." —Blaise Pascal
- tmoertel 13y agoWhen writing about technical subjects, however, you often need redundancy. People sometimes misunderstand concepts. When they do, the only thing that will alert them to their error is the second explanation crashing into the first.
- Anonmattymous 13y agoWhen writing technically you need to be specific and redundant.
- ripter 13y agoYou have to say the same thing in several different ways. Everyone has their own ways of thinking and understanding so you must be as clear as possible and provide several ways to express the same idea. This will allow different readers to understand the same subject.
- edw519 13y agoI am going to tell you about the 3 phases of technical writing. You tell them what you are going to tell them. You tell them. You tell them what you just told them. I just told you about the 3 phases of technical writing.
- nalbyuites 13y agoI recently came to appreciate this as a novice programmer learning Lisp. After working through the initial chapters of 'Practical Common Lisp' and 'Land of Lisp', I settled on DS Touretzky's 'Common Lisp: A Gentle Introduction to Symbolic Computation'. The pace is very comforting for a beginner and the reiterations are meticulous in detail and yet concise. For any beginner, the joy and confidence from being able to grok simple concepts and finishing all exercises provides the impetus to move on to tomes like SICP, 'On Lisp' and 'Let Over Lambda'. I would highly recommend technical authors to study the prose and content layout in this book.
- mathattack 13y agoI recall a story of EB White who condensed his lessons so compactly that he didn't have enough material to fill a classroom, so he would just repeat each concept three times.
- t_hozumi 13y agoI found that good books describe things in rich details. It is hard to compress a sentence without losing information.
- just2n 13y agoI disagree. You understand my context, though, right?
- crazygringo 13y agoCounterpoint (specifically in the field of advertising), titled "Do long copy ads work? Let’s ask some of the greatest names in advertising history" [1] Answer at the end: "Every one of the authors I have quoted is a giant in the field of advertising... And they all agree about the [positive] effectiveness of long copy ads." [1] http://www.realityassociates.com/Articles/Art-LongCopy.htm http://www.realityassociates.com/Articles/Art-LongCopy.htm
- deleted 13y ago[deleted]
- adkatrit 13y ago*be concise
- mekoka 13y agoComprehension is what saves readers time. Write as much as it's needed for your readers to understand. If I opened a page and fell on author's last one-liner, I'd be inclined to dispute the statement. It's void of context and arguments and we can surely find countless examples to contradict the notion. Fewer doesn't mean simpler. Maths or programming expressions can be terse, yet so packed full of information that they take hours to decipher. We can find the equivalent in literature. Sometimes to get your point across fast you have to use longer, yet more accessible sentences. To save readers' time, just write simpler, not shorter.
- ksrm 13y agoI absolutely hate that "don't move" kudos device. Terrible, obnoxious design.
- Datsundere 13y agoSame thing could be said about lectures in college. I'm amazed at how much professors can expand on for a simple little concept making the idea more convoluted than it should be.
- fusiongyro 13y agoBrilliant illustration. Terse writing has more punch, true. And for some media and most audiences, that's what you want. Most authors use a lot of weaselly filler (like "most" and "a lot") but not every interesting idea can be adequately conveyed by a pithy sentence. If people keep that in mind, we'll all benefit from better writing.
- deleted 13y ago[deleted]
- Imagenuity 13y agoFewer words are also easier to proofread.
- adamzerner 13y agoThere's an obvious tradeoff between speed and information. People tend to be biased towards information (writing too much), but that doesn't mean that "write less" is good advice.
- teddyknox 13y agoThe irony is strong.
- chacham15 13y agoId like to point out that this is similar to the idea of compression. Lossless compression is ideal, but you should not confuse lossy compression for lossless compression. To illustrate, going from v3 to v4 is very lossy. You lose the reason why shorter messages are better.
- mattjaynes 13y agoFor my recent technical book, I spent 3 weeks writing over 200 pages and then 3 weeks editing to get the book down to under 80 pages. It's funny because I then had several complaints (from non-buyers particularly) that the book cost too much for an 80 page book. Someone can certainly save their money and reproduce the experience of the book by spending a couple of painful weeks combing through documentation and hitting their head against walls. OR, they can spend less than what they probably make in an hour and get the same knowledge in 80 pages. My target audience was people that value their time far more than their money, so that's why I spent so much effort making the book as succinct as possible. As an aside: I'm really glad I put a price on the book. Initially I was tempted to have it be "pay what you want" so it would be more accessible, but that would have devalued it I think. Instead, I've offered a special cheaper option for students, junior developers, and those in countries where the book would be prohibitively expensive. So far, I've had about 50 people take me up on that. The book has been successful enough to give me another month where I don't have to take contracts and I can focus on creating more content. If I hadn't charged sufficiently for it, then I'd have to pause everything and do contract work. So, spending that extra 3 weeks making the book shorter and more focused was a win for both me and my target customers. For anyone curious, here's the book: http://devopsu.com/books/taste-test-puppet-chef-salt-stack-ansible.html http://devopsu.com/books/taste-test-puppet-chef-salt-stack-a...
- rentnorove 13y agoIMO, your book is far too expensive. As a casual interested in dev-ops (surely your target market), I'm completely turned off by you asking old-academia style prices of an ebook. I appreciate you're charging to cover the opportunity cost of your consulting, but presumably you're also aware that pricing it on your perceived value is a suboptimal strategy. Have you considered reducing the price to open up a larger market, and if you have, what is your justification for not doing so?
- nazgulnarsil 13y agoWrite more, edit more.
- adamtj 13y agoWrite as little as possible, but not less. Consider your audience and purpose: if you write too little, it can only be understood by those who already understand it. The Gettysburg address shows that less can be more. But, too little is nothing at all: http://norvig.com/Gettysburg/ http://norvig.com/Gettysburg/
- undoware 13y agoThere's a flip side of course<br/> Just like there always is<br/> Writing, whether text or source<br/> Is about tradeoffs, not the biz<br/> Of perfect solutions. For example, you will find<br/> That a rhyming passage will stay in mind<br/> Far longer than a tweet.<br/>
- bloaf 13y ago"The present letter is a very long one, simply because I had no leisure to make it shorter." http://c2.com/cgi/wiki?TimeToMakeItShort http://c2.com/cgi/wiki?TimeToMakeItShort
- pjdorrell 13y agoMy own experiment in brevity: the Pitch Blurb. (Ironically long) explanation at http://thinkinghard.com/blog/PitchBlurb.html http://thinkinghard.com/blog/PitchBlurb.html. Lots of examples in one web page at http://thinkinghard.com/blog/index.html http://thinkinghard.com/blog/index.html.
- SuperChihuahua 13y agoStephen King's rule is that the second draft of his book should be ten percent shorter compared with the first draft. Source: his biography On Writing (http://www.amazon.com/Writing-10th-Anniversary-Memoir-Craft/dp/1439156816/ http://www.amazon.com/Writing-10th-Anniversary-Memoir-Craft/...)
- scriptstar 13y agoV5 less is more!
- choffee 13y agoStart with a simple statement and follow up with the detail. If you read a good newspaper article you will see it starts off with a paragraph containing most of the detail of the story and then expands on it later allowing the user to skim. Blog readers, like newspaper readers, are viewing a number of stories and reading some of them just to get the gist and others to get the detail. So the headline is there to grab their attention and then the first paragraph has to give enough detail that they can go away with most of the details and move on. You can then expand later in the page for those that want a greater detail. It's quite a skill and one that journalist and editors work hard at.
- PaulHoule 13y ago"Omit needless words"