7 ms·
How to Write
- benihana 14y ago>Never use three words when one will do. Be concise. Tech bloggers: please read this and repeat it to yourself every day until it sticks.
- hammock 14y agoSome editorial comments: 1) "Please read this" is redundant because if they got that far in your post, they've already read it. 2) "Repeat it to yourself every day" is trite and can be made more interesting by substituting "day" with "hour" or something else. 3) You use "this" but refer to an abstract and ambiguous antecedent. 4) If they can remember to repeat it to themselves each morning, then it must have already stuck, so yours is a nonsensical sentence. Here's my stab at something more creative: Tech bloggers, make an effort to follow this advice each time you write, until it becomes effortless. Or something shorter: Tech bloggers, sharpie this quote onto your keyboard.
- alaskamiller 14y agoTech bloggers have quotas. Most tech bloggers also don't know how to write.
- seanmcdirmid 14y agoGood writing takes time and resources, unless you are really good. Writing a good (academic) paper that is concise and coherent takes me a few weeks along with eyeball help from colleagues to point out what I didn't smell myself. I usually don't have those resources to spend on a blog post or even a short hacker news post; its in a different league.
- mattacular 14y agoTech bloggers need way more help than the fundamentals provided in this article. In fact, they are hopeless and should all just stick to writing code.
- chris_mahan 14y agoUh, don't they blog precisely because they cannot code?
- MartinCron 14y agoI don't believe that anyone is "hopeless" as a writer. There are people who may never be great writers, but if someone's capable of writing code competently, there's no reason they can't be a good writer.
- deleted 14y ago[deleted]
- celer 14y agoDo you have any examples of excessive conciseness?
- drp 14y agoYes.
- Uhhrrr 14y agoThis is a humor piece, not a guide (for HN readers who click on comments first).
- joshlegs 14y agoI disagree. There be much good advice in there; all stuff I learned in writing college. My favorite? Rule No. 10: Revise, revise, revise. I can't tell you how many times I've written something, had it published (through the newspaper I work at), then read it 2 weeks later and thought "DAMN! I should have changed that!!"
- nollidge 14y agoYou disagree that it's a humor piece and not a guide? Yes, revising is incidentally a good thing for writers to do, but this is quite obviously satire if you read beyond the first sentence of each rule.
- joshlegs 14y agoI took it to be an exercise in sarcasm to emphasize the point being made. Admittedly, though, I didn't read many of the points through all the way ;) I do have a habit of reading partially through an article and then commenting ...
- mturmon 14y agoIf you do not read something carefully, you will never learn anything new. The habit you have gives too much weight to your internal biases and not enough to what you're reading.
- cynwoody 14y agoThe key is, if possible, to go off and do something else for a while before revising. What seemed perfectly clear when first written will often seem a little off when reviewed with a cleared head.
- 14y ago
- chris_mahan 14y agoI was going to write something; writer's block.
- rokhayakebe 14y agoI heard someone suggesting going through the mechanical process of writing (even if just random uncoordinated phrases), when faced with writer's block, to get the brain in the mood.
- curtis 14y agoThis is a well known technique: http://en.wikipedia.org/wiki/Free_writing http://en.wikipedia.org/wiki/Free_writing
- brycecolquitt 14y agoSince this is mostly satire--what are some actually good articles/blog posts about how to write better? I'm familiar with "Writing, Briefly". Any other suggestions?
- munchbunny 14y agoTry "The Elements of Style." Classic book on writing well.
- dmhdlr 14y agoAnd a terribly overrated one that won't go away... http://en.wikipedia.org/wiki/Elements_of_Style#Criticism http://en.wikipedia.org/wiki/Elements_of_Style#Criticism
- why-el 14y agoI think George Orwell's Politics and the English Language has some good advice on writing clearly and precisely, albeit later in the essay.
- DenisM 14y ago"On writing well" was previosuly suggested here, it's still in my queue though.
- kalid 14y ago"On writing well", William Zinsser http://www.amazon.com/Writing-Well-30th-Anniversary-Edition/dp/0060891548 http://www.amazon.com/Writing-Well-30th-Anniversary-Edition/...
- antidoh 14y agoElmore Leonard's 10 Rules of Writing. The rules: http://www.writingclasses.com/InformationPages/index.php/PageID/304 http://www.writingclasses.com/InformationPages/index.php/Pag... The book: http://www.elmoreleonard.com/index.php?/weblog/more/elmore_leonards_ten_rules_of_writing/ http://www.elmoreleonard.com/index.php?/weblog/more/elmore_l... The man: https://en.wikipedia.org/wiki/Elmore_Leonard https://en.wikipedia.org/wiki/Elmore_Leonard He's written a lot of books-to-movies that you've probably seen, or that your dad has.
- BlackNapoleon 14y agoI find that being active on forums and debating stuff like religion (agnostic-atheist) has really made my persuasive and argumentative writing better.
- gwern 14y ago> Rule No. 5: Keep a dream diary. I wasn't expecting that one.
- vorg 14y agoRule No. 1: Code and Tell. Most people say, “Code, don’t comment,” but I stand by Code and Comment. Rule No. 2: Don’t go searching for a project, let your project find you. You can’t rush inspiration. How do you think Linus came to “Linux”? It was just an ordinary day, and there it was — fate. Rule No. 3: Program in domains you know. Listen to your heart. Ask your heart, Is it true? And if it is, let it be. Rule No. 4: Never use three LOC when one will do. Be concise, use macros. Don’t fall in love with the gentle trilling of your mellifluous commands and blocks. Learn how to “kill your darlings,” as they say. With but a few deft strokes, pare it down to create: “(help land shark)”. Rule No. 5: Keep an open source dream diary. Rule No. 6: What isn’t said is as important as what is said. In many classic systems, the real action occurs in the API calls. Try to keep all the hard yakka out of the code. Some “real world” practice might help. Rule No. 7: Developers’s block is a tool — use it. When asked why you haven’t upped your LOC lately, just say, “I’m cutting out unneeded blocks.” Since most people think that developing is some mystical process where code is always created, cutting out blocks is the perfect cover for when you feel like refactoring. Rule No. 8: Is secret. Yes, check out other jobs. Rule No. 9: Have adventures. The Algol/C mode was in ascendancy for decades before it was eclipsed by trendy fabulist “objects.” The pendulum is swinging back, though, and it’s going to knock these object eggheads right out of their Stroustrup chairs. Keep ahead of the curve. Get out and see the language landscape. You’ll be glad you did. Rule No. 10: Refactor, refactor, refactor. I cannot stress this enough. Refactoring is when you do what you should have done the first time, but didn’t. Get that draft counter going. Remove a semicolon and then print out another copy — that’s another draft right there. Rule No. 11: There are no rules. Except the ones you learned during your Code and Comment days. Have fun. If they don’t want to be friends with you, they’re not worth being friends with. Most of all, just be yourself.