Ask HN: How do I develop terse yet elegant written communication skill
I am amazed at some of the design docs by my co-workers here at Google. The docs have phenomenal word economy AND read beautifully. It is literally a joy to read such docs as one sentence leads me to a question which is answered soon in the next paragraphs. The sentences use the minimum yet precise words to deliver phenomenal information density. What are ways people develop this skill?
FYI English is my second language but I did grow up learning both. I'd say my formal English is on par (if not better) than the native speakers.
15 comments
[ 3.0 ms ] story [ 47.2 ms ] threadPerhaps you will find encouragement here: https://quoteinvestigator.com/2012/04/28/shorter-letter/
Mark Twain (or was it Blaise Pascal?) put it best - “I didn't have time to write a short letter, so I wrote a long one instead.”
[1] http://www.au.af.mil/au/awc/awcgate/army/p600_67.pdf
The structure for the document comes from knowledge of the intended audience and their purpose combined with knowledge of the topic.
Economy of expression is gained from careful and continuous 'refactoring'; restructuring what you say, optimising for simplicity and leverage of the language.
Working at Google, I like that I get the chance to practice through design docs, although that may be my rose-tinted 6-month-tenure glasses speaking. I also try to write outside of work, though the deliberate practice does take some effort for me.
Have you taken the technical writing class at Google? That may be another good resource, although there's a deep waitlist for the ones I see now.
Mainly: write, then edit, re-edit etc. Keep going until nothing can be improved. In Clean Code it says, no-one can write clean code - you write dirty code then clean it. Every first draft of a novel sucks. Writers do 50 drafts and it starts looking OK. Every word carefully weighed dozens of times. No-one can write perfect prose in the first draft. Write a terrible first draft, of a chapter or part, then you have raw material to edit. Don't judge the first draft for quality - it's supposed to be bad.
Also, I've found that you often learn as much about the subject while doing that as you knew before! It's a great way to learn. Questions arise as you're doing it - make a temporary list of them at the end, most will answer themselves or can be answered in minutes or hours. If any are left, leave as Exercises for the reader :-)
p.s. Some people say it's way better doing it on paper. When "cut and paste" was with scissors and glue, you could cut everything up and move the parts around before starting to paste, as many great writers have done - on a computer screen you can only move one section at a time. Cut, paste, cut paste.
It covers how to write logically so that a document flows as you have described it.
He says:
> Books on writing tend to be windy, boring, and impractical. I intend this one to be different—short, fun, and genuinely useful.
See a review: https://nargaque.com/2010/07/07/writing-with-style-john-r-tr...
If you could read only one book on this topic, this is it.
Copy a favorite blog post or a few paragraphs from a book chapter by typing them yourself.
It is a very interesting exercise, makes your brain take in the words and digest them in a different way.
In your case retype one of your coworker’s docs.
Some other sources I’d recommend for this: Seth Godin’s blog, Dan Lyon’s Lab Rats book. Efficient, energetic and energizing writing with a high signal to noise ratio.
Read what you wrote aloud to yourself (go somewhere where people won’t stare at you while you’re doing this)
Listen and try to remember more samples of what you think good writing is, subconsciously your writing will start getting better gradually as you write more.