News for hackers. Stuff that matters.
Re:Why Engineers Need to Write by rmsaksida on Friday March 24, 2023 @03:29PM (#35294253)
When hiring, I always pay close attention to a person's writing skills. I find it to be a useful heuristic for general software engineering competency. But I actually look at this from the opposite direction - someone who's good at writing is usually also good at reading, and being a good reader is extremely helpful in our field. (Good) engineers spend so much time reading: technical books, documentation, requirements, specs, email, and of course code. Engineers who don't mind reading and are able to read attentively tend to be a lot more effective, as they will be more knowledgeable and less likely to miss important details.
Re:Why Engineers Need to Write by ryanlpeterman on Friday March 24, 2023 @03:43PM (#35294430)
That's a good point, I think Paul Graham has a similar line of thinking in the relationship between reading and writing. I linked this tweet in my article (https://twitter.com/paulg/status/1618747829975130115) but I've seen other places he's mentioned something similar as well.
Re:Why Engineers Need to Write by bavila on Friday March 24, 2023 @04:20PM (#35294887)
Where do I find more people like you when I'm job hunting? :)

I used to work as an attorney before getting into software engineering, and I clearly took for granted that other educated professionals (particular those in a field where precision is required) would write clearly, logically, and succinctly. My expectations have frequently not been met.

It's particularly humorous, as everyone who has hired me has acted like they were taking a big risk because of my non-technical background. Yet, each time, they quickly realize it was a good idea to hire someone with a strong command of the English language and a ruthless attention to detail.

Of course, the technical skills are required as well, but I don't think people appreciate how easy those are to pick up for someone who is capable of reading and distilling voluminous amounts of information in a short period of time.

Re:Why Engineers Need to Write by mhluongo on Friday March 24, 2023 @04:47PM (#35295228)
Big hiring criterion for us as well! Details in my profile if you're looking.
Re:Why Engineers Need to Write by bavila on Friday March 24, 2023 @09:00PM (#35297913)
I'm good now, thanks. :)
Re:Why Engineers Need to Write by BurningFrog on Friday March 24, 2023 @04:56PM (#35295367)
My theory is that the field has a big population "on the spectrum", and they're just not great communicators. Maybe because the "theory of mind" deficit.

They do have extra gifts in writing code which compensates somewhat. But it's a huge problem when half your team struggles to carry a conversation.

Re:Why Engineers Need to Write by jacob171714 on Friday March 24, 2023 @09:47PM (#35298286)
Not exactly a theory that this field has a higher percentage of autistic people. I think the communication deficit is more of a deficit between non autistic people and autistic people.
Re:Why Engineers Need to Write by jrochkind1 on Saturday March 25, 2023 @12:04AM (#35299234)
I'm not sure there's a correlation between austistic people and (lack of) ability to write "clearly, logically, and succinctly." I think there's a variation of skill there among all people. Some autistic people are excellent technical communicators and documentation or specification/standards writers.
Re:Why Engineers Need to Write by quickthrower2 on Friday March 24, 2023 @05:07PM (#35295524)
Some of the best people I worked with did something else professionally before becoming a software developer. For example army, accountants and electronic engineers. They are the good all rounders, good at going from ambiguity to decent code.
Re:Why Engineers Need to Write by vsareto on Friday March 24, 2023 @05:32PM (#35295877)
>They are the good all rounders, good at going from ambiguity to decent code.

That's useful for day-to-day issues, but if you're getting a lot of ambiguity that these folks have to address, someone higher up needs to write more.

Re:Why Engineers Need to Write by quickthrower2 on Friday March 24, 2023 @07:44PM (#35297190)
I have only worked in small companies. Developer means developer and all other gaps.
Re:Why Engineers Need to Write by ClumsyPilot on Friday March 24, 2023 @09:27PM (#35298149)
most business problems require good understanding of the goal and only mid-level technical expertise.

Ive seem more projects fail because requirements weren't understood, often by the customer themselves, than because of tech

just like most cars are not F1 racecars and revolutionary engineering - other concerns like costs and aesthetics dominate

Re:Why Engineers Need to Write by jrochkind1 on Saturday March 25, 2023 @12:01AM (#35299215)
Which is why domain knowledge is so important for software engineers. In most projects. Not always the way the industry works to stay in a given business domain though.
Re:Why Engineers Need to Write by bavila on Friday March 24, 2023 @11:42PM (#35299092)
> particular

And of course I would make a typo. That should say "particularly". :)

Re:Why Engineers Need to Write by jahsome on Saturday March 25, 2023 @12:52AM (#35299558)
I have a journalism degree, and spent a short stint as a reporter before transitioning to engineering.

I share much the same experience: both encountering a distinct lack of effective communication based on what I had expected, and being written off (pun intended) during the hiring process.

My biggest daily struggle is with those who want to verbally discuss every single issue, or worse, chat over informal DMs. Typically those conversations are somehow both circular and meandering all at once.

For me personally, I feel my commitment to writing-competency-over-technical-prowess has been my biggest asset throughout this second act. I'd like to think it allows me to back in to the technical aspects and keeps me better organized overall.

I also have diagnosed ADHD and a form of dyslexia so perhaps I'm just too easily distracted.

p.s. Please don't judge my grammar or spelling on this reply -- I'm writing from the bath with a fever!

Re:Why Engineers Need to Write by v-erne on Saturday March 25, 2023 @07:01AM (#35301429)
>> My biggest daily struggle is with those who want to verbally discuss every single issue, or worse, chat over informal DMs.

That's interesting - I tend to have mixed feeling about this. Sometimes I wish I had all communication done in writting.

But the reality is that as a dev and seminconsultant I work in 10 different domains at the same time and there is no way for me to have enough time to encode all my clients knowledge in structured writing - the only way for my situation to be bearable is to encode this into code and working applications. And the only way to quickly gather knowledge and and have feedback loop on it is to encode it as working applications. Because lets face it even if I was master communicator and writer most clients areny and never will be. And most areny paing for writing text but for providing solutions.

So I'm in this dissonance here where I would love to be better writer but the reality is that its not really that useful in my situation. Ok, and now I feel depressed, thank goodness I just this moment went into confectionery.

Re:Why Engineers Need to Write by selimthegrim on Saturday March 25, 2023 @09:54AM (#35302648)
>Ok, and now I feel depressed, thank goodness I just this moment went into confectionery.

Where do we order?

Re:Why Engineers Need to Write by fnordpiglet on Friday March 24, 2023 @05:41PM (#35296009)
I’m a great software engineer but I think by talking not writing. I know others that are visual and draw things from I think and others that code POCs. Maybe that heuristic is more a projection of what you are good at and you look for that in others? Maybe having a team with a written word person, a visual person, an explanatory person, and a code it first person makes a team that can explain what they’ve written with excellent diagramming and a functional POC to demonstrate?
Re:Why Engineers Need to Write by tilne on Friday March 24, 2023 @07:48PM (#35297225)
One of the points from the article was that writing helps you scale yourself. If you were a great engineer on my team I would want you to write everything down regardless if that was the way you thought through the alternatives or if it was just recording the understanding after you’d gotten to it.

That said, I don’t buy the idea that you reach the same clarity of thought by talking through an idea as compared to writing that same idea down with the intention of communicating it clearly to another person. The latter requires significantly more command over an idea.

Re:Why Engineers Need to Write by fnordpiglet on Friday March 24, 2023 @08:41PM (#35297740)
Why? Because you can’t? You’re illustrating my point. You are asserting something about my experience without having had it, based on your own. On my teams everyone writes stuff down to their ability, for instance a lot of non native speakers just can’t do a good job of this. But I always have the writer, and everyone works with them to be sure everything of importance is written down in a high quality way. But I judge people by their contribution, not the mode of the contribution. I’ll betcha my teams are more functional, but I’m sure you will disagree so I suspect we have to agree to disagree (but I’ll still poach your nonwriters and non English speakers with aplomb!)
Re:Why Engineers Need to Write by marcellus23 on Friday March 24, 2023 @09:15PM (#35298035)
I have to agree with tile and the OP. Even if you have a dedicated formal writer for writing formal documents like briefs or proposals, every engineer should be decent at writing. Especially now that more and more communication is asynchronous.

I've worked with many engineers who couldn't write, and it always came across in the aspects of the work mentioned in the thread — less ability to parse error messages, to describe things to others over email/Slack/comments, and most critically, to understand things that others wrote. Fundamentally, a huge amount of engineering is reading and writing. And I find those skills are very often linked.

Re:Why Engineers Need to Write by fnordpiglet on Friday March 24, 2023 @09:49PM (#35298300)
Sorry I think I wasn’t clear. I didn’t mean there was a dedicated writer any more than there’s a dedicated speaker or dedicated coder. The conversation is about the mode by which people gain their clarity. A person who gains clarity by writing will naturally gravitate to doing that and will be the dominant writer in the team. But that doesn’t obviate anyone from writing. There are people that gravitate to drawing things out to think things through. That’s where the gravitate, and they’ll likely end up doing a lot of the diagramming. Etc. But everyone participates in every aspect to their ability. The key is recognizing everyone isn’t the same, and that’s not a flaw but a feature. Many managers have a prescriptive view of an engineer and evaluate them like quality control in a widget factory. An excellent manager evaluates the people for their strengths and aligns their work to those strengths. In the foot ball analogy the core skill is running. Everyone runs. But some are really really fast runners. So you have them run really really fast. You let the person who’s really good at throwing be the quarter back. They still run, but it’s not expected they run as well as the fastest runners nor is it a problem. Because the fastest runners are the catchers. If you think engineers don’t come in the variety and shapes and skills as a football team, I don’t think you really understand how teams or humans or engineers work yet and I hope you consider looking at them as individuals and not a prescriptive skill set.
Re:Why Engineers Need to Write by orange8 on Saturday March 25, 2023 @02:16AM (#35300004)
I feel you are putting yourself, and others in a box. We all can gain more clarity from an idea by talking, writing or drawing about it. You don't have to be good at it, it will still improve your grasp of the problem. Of the three, writing is the slowest, meaning your mind takes more time and effort. And the time spent on something has a direct relation to its quality.

Long story short, you will become an even greater engineer by drawing and writing out your ideas.

Re:Why Engineers Need to Write by marcellus23 on Sunday March 26, 2023 @12:22AM (#35310905)
Sure, of course everyone has different strengths. That might apply to things like one's ability to work with other teams, or being detail-oriented versus being able to see the big picture.

I don't think that applies here. Writing and reading are very basic skills that will help you in all aspects of your job as an engineer, and everyone should be as good as they can be at them.

Re:Why Engineers Need to Write by tilne on Saturday March 25, 2023 @12:10PM (#35304062)
If we’re going to get pedantic about who can assert what about which experiences: you are asserting that you’re able to reach greater clarity of thought when talking as opposed to writing, correct? But how do you know that’s true? You’re unable to try talking first and writing first for any given task. So although I may be asserting something about your experience without having had it myself, so are you.

On a (somewhat) less pedantic note I would add that “asserting” is a bit strong of a word to describe the statement I made. Perhaps you should be a bit more precise with your words. Writing more could help :).

Re:Why Engineers Need to Write by davnicwil on Friday March 24, 2023 @06:16PM (#35296426)
> Engineers who don't mind reading and are able to read attentively

One very direct application of this skill in day to day engineering is just reading and correctly interpreting error logs and stacktraces.

It's pretty incredible how often that's just the cause of a bug being literally given verbatim, if one can only engage with the message on its terms and frame of reference, and parse out the info from it that's meaningful in the context of the software you're writing (and not, for instance, expecting the error message to somehow do that work for you, which is often impossible)

Re:Why Engineers Need to Write by recfab on Friday March 24, 2023 @08:15PM (#35297497)
It's surprising how many developers won't even bother to read an error message.

At my list gig there were a few folks who would regularly message me anytime there was a failure in their CI pipeline. No reading the message. Possibly not even opening the failed job at all.

Most of the time, the pipeline was doing what it was supposed to: failing a bad build. It didn't even occur to them that it was their code that was the problem. Just "the pipeline is red: send to @recfab".

Re:Why Engineers Need to Write by sophiabits on Saturday March 25, 2023 @12:58AM (#35299596)
I recently paired with someone who was running into issues configuring some settings in the Facebook developers console.

I got them to demo the issue for me, and they /immediately/ closed out of the error dialog when it popped up. Maddening!

Re:Why Engineers Need to Write by pixelfarmer on Saturday March 25, 2023 @02:31AM (#35300063)
> expecting the error message to somehow do that work for you, which is often impossible

But that is in part also because many error messages are closer to "there was an error" than providing full context info. These few minutes more invested into proper error messages can save many many man hours down the line.

Re:Why Engineers Need to Write by 908B64B197 on Friday March 24, 2023 @07:24PM (#35297053)
With remote being more prevalent, clear written communication is a must for anyone we hire.

One of the best signal for that is... a college degree.

Re:Why Engineers Need to Write by sinenomine on Friday March 24, 2023 @08:09PM (#35297432)
> I find it to be a useful heuristic for general software engineering competency.

So, like an IQ test without naming it an IQ test?

Re:Why Engineers Need to Write by Wohlf on Friday March 24, 2023 @08:20PM (#35297542)
Communicating clearly doesn't require a high IQ at all, it's a general skill. If anything, high intelligence might be a detriment since a lot of the smarter people I've known can't or refuse to communicate clearly.
Re:Why Engineers Need to Write by ClumsyPilot on Friday March 24, 2023 @09:29PM (#35298162)
then they arent that smart? /s

Seriously, I think our judgement of 'smartness' is lacking. We call people of loelw emotional intelligence smart.

Re:Why Engineers Need to Write by latency-guy2 on Friday March 24, 2023 @10:25PM (#35298558)
Nothing wrong with IQ tests at all, in fact we perform them all the time, maybe we call them coding tests, take home projects, or whiteboard interviews from time to time, but they are still a very effective measure of ability.

Each of these has a way to eliminate people I have no reason to hire, including timid/shy people with no backbone of their own, people who are terrible at communicating, people who are clearly out of their depth even in a low stakes environment on a toy problem that doesn't even need to be fully solved.

Re:Why Engineers Need to Write by analog31 on Saturday March 25, 2023 @12:48AM (#35299531)
This isn't too shocking, given what's said about programming, namely that you're writing code to be read by humans first, and computers second.