Key takeaways: 1. One of the best ways to improve your writing is to learn how to cut out words that are not necessary 2. Stuffy writing is bad writing! It lowers the power of your brain and mine! 3. What words should you never use in writing? Words whose exact meanings you don’t know! Never use a word unless you know EXACTLY what it means 4. If your writing is nonsense, maybe your thoughts are nonsense too! 5. To ke…
How to write more clearly, think more clearly, and learn complex material [pdf]
151–159 of 159 posts
Re: How to write more clearly, think more clearly, and learn complex material [pdf]
#152As someone who explains complicated things to people in writing for a living, this is one of the best guides for business and technical communication I’ve ever seen.
Fake example:
A bicycle has two wheels of equal size.
Some bicycles have two extra smaller wheels on each side to train bicycle riders.
Occasionally you might have one helper wheel on the left or right instead of two, but it's rare.
If a bicycle has two wheels in the back and one in the front it's a tricycle. Not to be confused with training wheels.
Re: How to write more clearly, think more clearly, and learn complex material [pdf]
#153Key takeaways: 1. One of the best ways to improve your writing is to learn how to cut out words that are not necessary 2. Stuffy writing is bad writing! It lowers the power of your brain and mine! 3. What words should you never use in writing? Words whose exact meanings you don’t know! Never use a word unless you know EXACTLY what it means 4. If your writing is nonsense, maybe your thoughts are nonsense too! 5. To ke…
>Key takeaways: 1. One of the best ways to improve your writing is to learn how to cut out words that are not necessary I believe you meant, "1. Cut out unnecessary words." ;)
( Strunk and White, 1918 )
Re: How to write more clearly, think more clearly, and learn complex material [pdf]
#154This is my writing gem: when you send an email, you either want them to know something or do something, so say that in the first sentence: Good: "FYI, our etcd cluster is broken, but we're working to fix it." Bad: "I came in this morning, and while I was going through my emails when I saw a message about one of the nodes in our cluster. So I checked it out, and sure enough it was down, and I went to the console and s…
Then you can add more details and narrative.
This applies to email, PowerPoint, wiki pages, etc.
It's a hard rule to follow - I'd risk saying that the "better" writer you are, larger the chance you'll drift into details and narrative.
A good mechanism to solve that problem is to add the tl; Dr aka executive summary after you've written all you need.
----
Many years at Big Consulting Inc may have dried up my soul but at least taught me to communicate effectively, I think.
Re: How to write more clearly, think more clearly, and learn complex material [pdf]
#155Key takeaways: 1. One of the best ways to improve your writing is to learn how to cut out words that are not necessary 2. Stuffy writing is bad writing! It lowers the power of your brain and mine! 3. What words should you never use in writing? Words whose exact meanings you don’t know! Never use a word unless you know EXACTLY what it means 4. If your writing is nonsense, maybe your thoughts are nonsense too! 5. To ke…
Re: How to write more clearly, think more clearly, and learn complex material [pdf]
#156Key takeaways: 1. One of the best ways to improve your writing is to learn how to cut out words that are not necessary 2. Stuffy writing is bad writing! It lowers the power of your brain and mine! 3. What words should you never use in writing? Words whose exact meanings you don’t know! Never use a word unless you know EXACTLY what it means 4. If your writing is nonsense, maybe your thoughts are nonsense too! 5. To ke…
>Key takeaways: 1. One of the best ways to improve your writing is to learn how to cut out words that are not necessary I believe you meant, "1. Cut out unnecessary words." ;)
I think it's funny the summarized version is that statement. Because, in the presentation, they progressively cut down that exact statement to arrive at:
"To improve your writing, cut out unnecessary words."
> I believe you meant, "1. Cut out unnecessary words."
I think your version cuts out a little too much. It loses the why and becomes an unexplained imperative.
Re: How to write more clearly, think more clearly, and learn complex material [pdf]
#157Earlier quoted context omitted.
Regarding 1, something I've noticed on HN is the overuse of some adverbs. "Absolutely" comes to mind. "I absolutely agree" could as well be "I agree".
I try to remove common enhancing adverbs when writing emails at work. Removing "very," "definitely," "absolutely," etc. makes professional communication come across more authoritatively and clearly. I still use adverbs to be clear, but they need to communicate something specific that is otherwise hard to articulate.
Re: How to write more clearly, think more clearly, and learn complex material [pdf]
#158I found it embarrassing that I actually do not know much material that worth to be written. My gut feeling is that one month of intensive research/work/study can be summarized in a long blog post. But in my post-student life I have, unfortunately, avoided so many of those intensive experience because they are difficult. I even switch job every 2-3 years so that I never get much deep understanding of pretty much anyth…
Every time I wanted to write, I felt that what I'm writing about is either trivial or already done. But whenever someone asked me something, I could speak about it for hours. So now, I'm building personal wikis - one for learning and work, the other for thinking. I jot down whatever I feel somewhat relevant. Aiming for the perfect blog post stunted me, so I love writing in a more raw format and a less structured envi…
Re: How to write more clearly, think more clearly, and learn complex material [pdf]
#159Forgive me for bringing up my own material here, but I wrote a piece that is highly relevant in this context only two days ago: Writing for Engineers - https://www.heinrichhartmann.com/posts/writing/ This text is particularly geared towards Software Engineers and focuses more on the psychology of getting started with writing. Lot's of overlap with the content in this post (which has much more depth on the "how to wri…
I haven't heard that idea before - makes a lot of sense, thanks!