News for hackers. Stuff that matters.
Re:Why Engineers Need to Write by GCA10 on Friday March 24, 2023 @02:59PM (#35293875)
"Writing doesn’t just clarify your existing ideas; it generates more of them."

So true! Redrafting and self-editing involves so much more than just getting the commas in the right places. This is how we see new linkages that weren't obvious at first. It's how we become more discerning, so we can define the limits and strengths of our concepts more precisely. And it's one of the best ways of opening up new avenues of thought. (If A is valid, then B, C and D become possible.)

Re:Why Engineers Need to Write by jxramos on Friday March 24, 2023 @03:04PM (#35293951)
fascinating, writing as a generative process. I like it. Think about how many tangents show up in text that can't be explored fully but can become a subject or book in their own right.
Re:Why Engineers Need to Write by theturtletalks on Friday March 24, 2023 @03:35PM (#35294340)
"Writing about something, even something you know well, usually shows you that you didn't know it as well as you thought. Putting your ideas into words changes them." [0]

0. http://www.paulgraham.com/words.html

Re:Why Engineers Need to Write by mtippett on Friday March 24, 2023 @03:37PM (#35294362)
100%.

Just challenged the hacker news crew to draw a bike. See my reply to the OP.

Re:Why Engineers Need to Write by ryanlpeterman on Friday March 24, 2023 @03:42PM (#35294410)
This was a great read, thank you for sharing :)
Re:Why Engineers Need to Write by nextlevelwizard on Friday March 24, 2023 @03:57PM (#35294593)
For me it happens in cycles. I get inspiration to jazz-up/re-write my blog and that gives me a nudge to write something, anything really, just to get to see something new and that gets the rock rolling and I end up writing half a dozen posts in few weeks. Then I get distracted by some other project or a game or whatever and I forget writing for months and when I remember I have a blog I feel like I don't have anything "worthy" of writing. Until I again get inspiration to start working on the code side of the blog again and the cycle beings a new.
Re:Why Engineers Need to Write by abathur on Friday March 24, 2023 @04:38PM (#35295111)
* * *
Re:Why Engineers Need to Write by lifeisstillgood on Friday March 24, 2023 @05:00PM (#35295413)
Writing shows how weak your thinking is - Leslie Lamport
Re:Why Engineers Need to Write by 123pie123 on Friday March 24, 2023 @05:12PM (#35295594)
I'm sure all the people with dyslexia / ADHD would not agree
Re:Why Engineers Need to Write by crabkin on Friday March 24, 2023 @06:40PM (#35296650)
I have ADHD and maybe some sort of low grade dyslexia. My voracious curiosity with no regard to structured learning or topical coherence has only been a huge boon to my reading/writing. I think ADHD/dyslexia has been a bigger problem in my math and science classes where I write something different than what my brain is thinking, or I make arithmetic mistakes. For instance, if I forget to write the first noun in a sentence, it isn't as huge a problem as when I mix up a summation and summand in an answer or on the way to one.
Re:Why Engineers Need to Write by DiggyJohnson on Friday March 24, 2023 @07:02PM (#35296843)
I’m not sure I understand your reasoning, and I’ve been diagnosed with ADHD and am writing a nonfiction book.

I understand how this condition might make the writing process more challenging, but I don’t think that contradicts GPs point at all.

Re:Why Engineers Need to Write by zwkrt on Friday March 24, 2023 @07:06PM (#35296869)
(This is coming from someone with ADHD but not dyslexia)

It's harsh, but it isn't wrong, right? The reason that these states of being are considered 'disorders' is because they interfere with daily life and with tasks that other people consider to be easy.

I need to take a lot of time to edit my writing and to re-evaluate the content that I write because it is easy for me to slip into a multi-paragraph tangent. Fundamentally that happens because my thinking is not sharp/focused.

On the other hand, when I am done writing I get a feeling of great accomplishment. Like I was able to swim through the deep waters of my mind and harpoon all the good ideas. Being smart isn't worth much if you can't communicate your ideas!

Re:Why Engineers Need to Write by 123pie123 on Saturday March 25, 2023 @03:20AM (#35300303)
speaking as someone with mild dyslexia and high ADHD. I would say that my analytical skills, abilty to focus, spatial awareness (I could go on here but I think you get the gist) are well above average based on my work/ university experience

i do take offense of people implying my "mind is weak" based soley on my writing skills. Yes, I know writing skills are important at communicating, but humans have seriously many skills to offer than just writing or even communicating for that matter. yet people seem to be condensing their opinion of other people into a very highlevel simplistic rule. Are we going back in time here? whats next? basing if peoples minds are weak on DNA/ race?

>I need to take a lot of time to edit my writing and to re-evaluate the content that I write because it is easy for me to slip into a multi-paragraph tangent. Fundamentally that happens because my thinking is not sharp/focused.

same here on the first part, but not because I can't focus, its because I have to juggle many train of thoughts whilst writing slowing into one stream of communication. to the point I give up on many things that i really want to say

Re:Why Engineers Need to Write by austin-cheney on Saturday March 25, 2023 @07:18AM (#35301548)
You are seriously underestimating the importance and potential of communication. Excellent communication conveys expectations, specificity, and manipulation in ways you are not capable of imagining without so being skilled. It’s the difference between effective leadership and being a tool.
Re:Why Engineers Need to Write by 123pie123 on Saturday March 25, 2023 @08:21AM (#35301942)
no i'm not

Are you defining people as weak because you think writing is important and ignoring all other aspects of their personality?

Re:Why Engineers Need to Write by austin-cheney on Saturday March 25, 2023 @01:20PM (#35304835)
If you want to talk about personality the member of the big 5 most correlated with intelligence is openness. The member with the highest negative correlation to intelligence is conscientiousness. To be skilled in any kind leadership you need both high intelligence and super high conscientiousness. To be skilled in writing you need high openness and at least moderately high conscientiousness.

Irrespective of creativity and intelligence you need some amount of conscientiousness to be goal oriented. That is just yourself. To direct others to do the same you need that plus excellent communication skills. There are no shortcuts or alternatives here.

Re:Why Engineers Need to Write by kaashif on Saturday March 25, 2023 @09:44AM (#35302552)
I think the quote was paraphrased to make it more offensive than it really was originally.

Originally the quote was about sloppy thinking, not "weak" minds. You're right that weak isn't a great word to use here.

Maybe you'd also disagree that your thinking is sloppy.

Re:Why Engineers Need to Write by tilne on Friday March 24, 2023 @07:20PM (#35297007)
Why do you say that?
Re:Why Engineers Need to Write by lifeisstillgood on Friday March 24, 2023 @07:50PM (#35297246)
So the actual quote is less divisive -

"Writing is nature's way of letting you know how sloppy your thinking is."

As a father to three kids on rhe ASD spectrum, yes I guess you are right. And yeah they need extra time in exams - but honestly no-one writes the final draft the first time. All exams are is how quickly can you regurgitate an essay you wrote (yourself) earlier.

Write, rewrite and repeat. It's the only way. No matter how it bounces around in your brain at some point you mail the slippery thought down and can examine it.

Re:Why Engineers Need to Write by dgb23 on Friday March 24, 2023 @09:35PM (#35298199)
I have an extremely bad short term memory. If you tell me something and I don’t write it down or think about it intensely for a while, I’ll forget it in minutes.

I write everything down because of this. Bullet points, paragraphs etc.

Re:Why Engineers Need to Write by kaustyap on Saturday March 25, 2023 @03:10AM (#35300258)
I second it. My brain is also tuned to discard most of the information which is easily available for retrieval through print or online resource. I have to write any new information or concept multiple times In order to retain it for few days.
Re:Why Engineers Need to Write by ergonaught on Friday March 24, 2023 @10:29PM (#35298597)
My ADHD agrees with it 100% because it's true.
Re:Why Engineers Need to Write by textninja on Friday March 24, 2023 @08:17PM (#35297515)
Writing is thinking
Re:Why Engineers Need to Write by dalmo3 on Friday March 24, 2023 @11:35PM (#35299038)
...without relying solely on short term memory.
Re:Why Engineers Need to Write by sandworm101 on Saturday March 25, 2023 @07:57AM (#35301771)
The quote refers to the writing process, that by writing you learn of weeknesses in your ideas. It doesnt mean to describe writing as a tool of the week-minded.
Re:Why Engineers Need to Write by nanidin on Friday March 24, 2023 @06:32PM (#35296572)
My personal version of rubber duck debugging involves writing an email to explain the problem. It helps solidify my understanding and usually generates new things to follow up on.
Re:Why Engineers Need to Write by cmason on Friday March 24, 2023 @06:49PM (#35296733)
Yes. Very often the email never gets sent — because I find the solution while writing it.
Re:Why Engineers Need to Write by kaashif on Saturday March 25, 2023 @09:38AM (#35302503)
This is an incredibly common experience, lots of people I've asked do this.

When writing a StackExchange post asking for help, I want to include all relevant information and include a list of things I've tried, along with explanations for why they're dead ends.

Writing it all down sometimes helps me realise that one of the ends is in fact not dead.

Re:Why Engineers Need to Write by p4l4g4 on Saturday March 25, 2023 @02:49PM (#35305775)
This happens more often than I'd like to admit. More often it's on work chat or a call, but the principle holds: I try to explain my problem to someone else and while deepening the explanation, I get a face-palm moment (the answer was there all along!), thank the person for its time and franticly start working on the solution.

Rubber ducking can be a highly productive measure when your mentally clouded and can take many forms.

Re:Why Engineers Need to Write by keyle on Friday March 24, 2023 @07:57PM (#35297316)
I do the same by walking and mostly talking to myself like a mad scientist.
Re:Why Engineers Need to Write by vlachen on Friday March 24, 2023 @11:02PM (#35298849)
I'm often found in the back lot, walking around and yelling/gesturing to no one at all about the problem I am trying to solve.
Re:Why Engineers Need to Write by passion__desire on Saturday March 25, 2023 @02:36AM (#35300088)
Jonathan Blow mentioned in one of his interview that sometimes solutions would pop up when he was in middle of dance class or yoga class.
Re:Why Engineers Need to Write by maccard on Saturday March 25, 2023 @07:13AM (#35301507)
I'm pretty sure my dog would qualify for an entry level engineering position at an FAANG from listening to me talk about work while we're walking.
Re:Why Engineers Need to Write by Pokepokalypse on Friday March 24, 2023 @08:11PM (#35297453)
lol. that's me; only I start by writing out the problem as an email to ask someone for help. 90% of the time, I find that I didn't have a complete understanding of the problem to begin with, and I usually end up solving it before hitting "send".

Then I'll have this odd memory of - "I discussed this with you, I told you all abo- oh wait, I didn't send it."

Re:Why Engineers Need to Write by jrochkind1 on Friday March 24, 2023 @11:57PM (#35299180)
Which is so common it's basically what's called https://en.wikipedia.org/wiki/Rubber_duck_debugging
Re:Why Engineers Need to Write by heisenbit on Saturday March 25, 2023 @05:22AM (#35300943)
I found that sometimes sending it is required for me when I‘m absolutely stuck and have explained it a few times. It sort of commits it to memory and frees up mental resources then able to come from a different direction.
Re:Why Engineers Need to Write by sedawk on Saturday March 25, 2023 @01:53PM (#35305165)
I thought I was the weird one... Many a times have I debugged an issue and was convinced of where is the bug and what the fix is. Only to discover that I was off in both the regards when I sat down to write a detailed email to the team!

I felt I was wasting too much time. But I've realized that for me the time spent writing something in details has always helped me fill in the gaps and also discover the unknowns.

Re:Why Engineers Need to Write by OJFord on Friday March 24, 2023 @08:29PM (#35297629)
I resolve a lot of bug tracker issues (before actually opening them) that way.
Re:Why Engineers Need to Write by carlmr on Saturday March 25, 2023 @03:14AM (#35300276)
I started note taking in markdown. I used to note take a lot on paper and it always became a mess.

I'm using Obsidian right now for this, although you can just use plain code editor it's nice to have WYSIWYG.

Re:Why Engineers Need to Write by oneeyedpigeon on Saturday March 25, 2023 @07:00AM (#35301420)
I've just started using obsidian, but only for a subset of my work, to work on individual documents with a very rigid structure. Do you have any tips on taking obsidian to the next level, using it as an integrated tool rather than just a one-off editor?
Re:Why Engineers Need to Write by albrewer on Saturday March 25, 2023 @05:24PM (#35307562)
I have two kinds of people I mentally target when I write documentation: a 6 year old child with an abnormally long attention span, and a grumpy, rude 60 year-old mechanical engineer who isn't quite old enough at the time to skate to retirement before having to learn the thing I'm documenting.

Writing for a child forces me to keep the words and concepts very, very simple, and to write in a style that builds up usage of the program from first principles. Writing for the grumpy old-timer is a practice in minimizing questions from them, forcing me to do a sort of final pass on the overall design of what I'm writing about, to defend design choices, and to add future improvements to the backlog. Drafting the documentation for semi-finished features that are still in progress has sometimes led me to change the design in order to make writing the docs targeting these two people simpler.

Re:Why Engineers Need to Write by playingalong on Friday March 24, 2023 @07:35PM (#35297135)
So does teaching others.
Re:Why Engineers Need to Write by Pokepokalypse on Friday March 24, 2023 @08:14PM (#35297476)
"teaching is the highest form of mastery"

-- (don't know who said this quote)