News for hackers. Stuff that matters.
Re:How to write more clearly, think more clearly, and learn ... by westcort on Sunday April 17, 2022 @05:17PM (#31064597)
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 keep things clear and readable: Put the main point of each paragraph in its first sentence

6. Pretend you’re writing a textbook! That’s how I ended up writing so many books...Organizing knowledge Learning is a lot like writing a book

7. I often write the introduction last, after I know what it will introduce!

8. Never draw the reader’s eye to anything that is not the main point

Re:How to write more clearly, think more clearly, and learn ... by enigmatic02 on Sunday April 17, 2022 @09:15PM (#31066264)
Disagreed with 5, it's too prescriptive. Lots of great writers use progressive disclosure to keep people hooked

Being unselfish also helps with building great products. Reminds me of this article, treat your reader like a customer: https://www.productlessons.xyz/article/improve-business-writ...

Re:How to write more clearly, think more clearly, and learn ... by maroonblazer on Sunday April 17, 2022 @10:41PM (#31066734)
I don't think progressive disclosure applies in the cases the author is discussing.

Slide 8: "Most of the writing in the world is for information." Readers looking for information aren't interested in being teased to keep reading. That's a recipe for 'unhooking' them. They want to know what the author thinks they should know.

No pussyfooting.

Re:How to write more clearly, think more clearly, and learn ... by MaxBarraclough on Monday April 18, 2022 @09:34AM (#31070317)
Agree. Adopting a less helpful structure in the name of manipulating the reader, is surely incompatible with unselfish writing. From the article:

> I’m not going to demand that you put up with my quirks (bad spelling, bad organization, sloppiness). I’m going to package the information so that it enters your heads as easily as possible.

If we were discussing fiction writing, that would be different. Fiction writers aren't aiming for maximally efficient communication.

Re:How to write more clearly, think more clearly, and learn ... by mym1990 on Monday April 18, 2022 @02:22AM (#31067967)
I feel like progressive disclosure is such a broad term that anything can be made to fall under it...any book written, show filmed, movie created is progressively disclosing information/story.

FWIW plenty of informational books pussyfoot just to get a bigger piece out, there is fluff, anecdotes, tangents, but humans understand through storytelling, and ultimately that is usually a good way to go about sharing ideas.

Re:How to write more clearly, think more clearly, and learn ... by westcort on Sunday April 17, 2022 @10:35PM (#31066700)
This is great! Here are my takeaways from that article.

1. Easy writing makes for hard reading; invest in editing and treat your reader like a customer

2. What’s the biggest difference between great writers and all the rest? It’s not talent, it’s treating the process like a product

3. Make it skimmable; expect that your reader is busy

4. Every word should serve a purpose

5. Your points should fit like a jigsaw puzzle, each connected to another

Re:How to write more clearly, think more clearly, and learn ... by douglee650 on Monday April 18, 2022 @09:25AM (#31070216)
In the article, author reduces (1.)

From: "One of the best ways to improve your writing is to learn how to cut out words that are not necessary"

To: "To improve your writing, cut out unnecessary words."

Re:How to write more clearly, think more clearly, and learn ... by kazinator on Monday April 18, 2022 @09:50AM (#31070535)
Progressive disclosure isn't what's keeping me hooked on the meaning of the registers of your chip. People asking about the status of my open bug is doing that. Give me a table.
Re:How to write more clearly, think more clearly, and learn ... by shakezula on Monday April 18, 2022 @01:06PM (#31073489)
You have to know the rules to break them. This is a good rule to know and then know how to break.
Re:How to write more clearly, think more clearly, and learn ... by westcort on Sunday April 17, 2022 @09:18PM (#31066282)
I agree. Sometimes a transition statement is better. Sometimes one must present evidence, then summarize. This is just my summary of the full 120-slide PowerPoint.
Re:How to write more clearly, think more clearly, and learn ... by hammock on Monday April 18, 2022 @10:52AM (#31071458)
>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."

;)

Re:How to write more clearly, think more clearly, and learn ... by carapace on Monday April 18, 2022 @03:05PM (#31075029)
"Omit needless words."

( Strunk and White, 1918 )

Re:How to write more clearly, think more clearly, and learn ... by mlyle on Tuesday April 19, 2022 @02:21PM (#31086836)
> > 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 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 ... by stackbutterflow on Sunday April 17, 2022 @10:11PM (#31066560)
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".
Re:How to write more clearly, think more clearly, and learn ... by kranner on Sunday April 17, 2022 @10:27PM (#31066649)
I don't know; "absolutely" can add emphasis. Advising someone not to use it because "agree" covers it anyway feels like trying to suppress their personality. We're communicating, not playing language golf.
Re:How to write more clearly, think more clearly, and learn ... by stackbutterflow on Sunday April 17, 2022 @10:46PM (#31066770)
I feel that it dilutes the meaning of whatever comes after. "I agree" conveys a stronger tone than "I absolutely agree". Same as "I love you" is more powerful than "I absolutely love you". I see it as a filler word that doesn't add anything to the sentence. It's subjective I know. Also I would add that if you "absolutely [verb]" all the time you might as well [verb].
Re:How to write more clearly, think more clearly, and learn ... by hammock on Monday April 18, 2022 @10:54AM (#31071489)
Unnecessary emphasis betrays insecurity on the part of the author.
Re:How to write more clearly, think more clearly, and learn ... by kwyjibo1230 on Sunday April 17, 2022 @11:26PM (#31067026)
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 ... by Flenser on Tuesday April 19, 2022 @03:25PM (#31087701)
There's a Chrome Extension for Gmail and Outlook for web that helps you send more confident emails by warning you when you use words which undermine your message.

https://justnotsorry.com

Re:How to write more clearly, think more clearly, and learn ... by hammock on Monday April 18, 2022 @10:54AM (#31071477)
Don't use adverbs or adjectives at all unless necessary.
Re:How to write more clearly, think more clearly, and learn ... by bspear on Sunday April 17, 2022 @10:25PM (#31066634)
True, I wonder if it's driven by people's need to over-express over the internet since there's no body language
Re:How to write more clearly, think more clearly, and learn ... by paufernandez on Monday April 18, 2022 @07:31AM (#31069391)
I think some people overexpress in general, regardless of the medium. I think it comes from an excess of "passion", which is like permanent exageration. I am prone to it, that's why I know, and I try to keep it under control.
Re:How to write more clearly, think more clearly, and learn ... by rayiner on Monday April 18, 2022 @09:53AM (#31070575)
> I think it comes from an excess of "passion", which is like permanent exageration. I am prone to it, that's why I know, and I try to keep it under control.

We thank you.

I suffer from the opposite problem—extremely deadpan personality. I insert exclamation points randomly in emails to seem human.

Re:How to write more clearly, think more clearly, and learn ... by supersrdjan on Monday April 18, 2022 @06:06AM (#31068994)
Combining #7 and #5 leads to:

Often write the first sentence of a paragraph last, after you know what is the paragraph's main point.

Re:How to write more clearly, think more clearly, and learn ... by k__ on Sunday April 17, 2022 @06:06PM (#31064936)
1. is not obvious.

For example, if you want to tell a story or go for specific emotions.

Re:How to write more clearly, think more clearly, and learn ... by mnhn1 on Sunday April 17, 2022 @07:33PM (#31065590)
These contexts don't change the idea in rule 1, but they do change the definition of what is "necessary". There are words that "dilute" a message and are not necessary to convey the literal meaning. But usually we don't want just the literal meaning of things, we want a certain level of dilution. Without it, prose can be clear and specific, but at the same time becomes dense and unreadable. Lots of academic writing is like that.

There are words that are necessary for the _overall effect_, even if not necessary for the literal communication goal of a set of words.

Re:How to write more clearly, think more clearly, and learn ... by westcort on Sunday April 17, 2022 @06:18PM (#31065038)
To be clear, this is just a simple summary of the source. I agree with your statement, though. In fact, as Rudolf Flesch said in his book, How To Write Speak And Think More Effectively, "So here we have the secret of plain conversational talk: it is not difficult ideas expressed in easy language, it is rather abstractions embedded in small talk. It is heavy stuff packed with excelsior. If you want to be better understood you don’t have to leave out or change your important ideas; you just use more excelsior. It’s as simple as that." The point his is making that the few clear simple points can be packed with some excelsior to improve clarity.
Re:How to write more clearly, think more clearly, and learn ... by civilized on Sunday April 17, 2022 @07:30PM (#31065569)
There will be exceptions to all these rules at the expert level, but less expert people should probably follow them.

I was reminded of this recently after reading an essay by a high schooler. The essay was actually pretty insightful, but I couldn't help but notice the way in which the words that the author said seemed to be a great deal more than strictly necessary to communicate the point that he was trying to make to the audience that he was speaking to at the time he was writing the essay.

Perchance.

Re:How to write more clearly, think more clearly, and learn ... by mandeepj on Monday April 18, 2022 @01:23PM (#31073739)
I believe those points can also be applicable for speaking also, especially in interviews where you are expected to give canned responses in a STAR format.
Re:How to write more clearly, think more clearly, and learn ... by la6472 on Tuesday April 19, 2022 @09:45AM (#31082996)
Author needs to practice more ..after 125 slides he/she could not communicate clearly to me that the underlying hypothesis is true.
Re:How to write more clearly, think more clearly, and learn ... by erwincoumans on Monday April 18, 2022 @07:33AM (#31069407)
Thanks for your well written summary!
Re:How to write more clearly, think more clearly, and learn ... by stevenally on Sunday April 17, 2022 @05:56PM (#31064854)
What books have you written?
Re:How to write more clearly, think more clearly, and learn ... by westcort on Sunday April 17, 2022 @06:12PM (#31064985)
I just wanted to clarify that these are the main points extracted from the PowerPoint linked. I actually do write for a living, but most of what I write is proprietary for closed distribution.