Live data from Hacker News

Undervalued Engineering Skills: Writing Well

blog.pragmaticengineer.com

341–350 of 385 posts

Re: Undervalued Engineering Skills: Writing Well

#341

Writing well is an undervalued skill in life, not just in engineering. When you work on a team of peers with similar skills in your field, whether that field is engineering or something else, being able to write well and communicate well become strong differentiators. FWIW, I'm pretty sure that writing (reasonably) well online is what got me a job in venture capital after ten years as an engineer. David Perell (host…

I disagree that writing is undervalued. I think that writing is highly valuable and highly rewarded...but that the path to overcome challenges with writing is bafflingly mysterious. Does anyone know of a therapist who has experience helping people overcome writing anxiety? I genuinely don’t know how to find one. Therapist-shopping is baffling. I ask this as a software engineer who can produce pretty solid writing if…

I'm a naturally bad writer but somehow I managed to become confident in writing documentation, cover letters etc. For cover letters asking friends/family for feedback had helped me a lot, also for this specific topic there are a bizillion great books about the topic - amazon is your friend. Or google: how to write performance review

That said, I think depending on the kind of writing you want to do, there is probably a book/article about it.

Also what is a nice strategy that always works for me: start with brainstorming or random bullet points. Put things in order, like a 1 or 2 level hierarchy. Mark important things, throw out things you are not comfortable with. Add some details.

Then get an example text. In the case of cover letters there's always a standard structure: intro, main part, end. And then replace it with your words. Also in the case of reviews, maybe you can ask your colleagues to see how they structure their writing and even review yours before you hand it in.

Re: Undervalued Engineering Skills: Writing Well

#342

Fully agree and I'd expand the point to cover communication in general. Explaining ideas clearly with text or voice is one of the characteristics that I've noticed in high-functioning engineering teams. I did a talk[1] a few years back about my experiences helping a team to improve their communication skills. What surprised me was the emotional complications that prevent people from communicating effectively. [1] htt…

Is there are tutorials or training material you would recommend. I have been hearing "plain writing" more and more...but not sure if it is the right thing.

I’m sorry I don’t have any link to hand that would help with writing.

Re: Undervalued Engineering Skills: Writing Well

#343
post #33
post #25

I used to be a huge proponent of learning to write well as the most important skill an engineer can learn. Now, I think it's the second most important skill. The most important skill is sales . The key value of writing well, in a workplace environment (or other environments, really) is to convince others to agree with what you're proposing. Convincing people that something they don't initially understand or trust is…

And as a follow-on comment rather than an edit... There's nothing smarmy or dishonest about sales. Misleading sales is bad sales. The best salespeople are focused on fulfilling the customer's needs, not selling the product. The product sells itself once the customer understands that it fulfills their needs and offers them real benefits relative to the expense. And expense isn't just money. It's time. It's risk. It's…

>Misleading sales is bad sales.

True, unfortunately it’s also the majority of sales.

Re: Undervalued Engineering Skills: Writing Well

#344

Writing well is an undervalued skill in life, not just in engineering. When you work on a team of peers with similar skills in your field, whether that field is engineering or something else, being able to write well and communicate well become strong differentiators. FWIW, I'm pretty sure that writing (reasonably) well online is what got me a job in venture capital after ten years as an engineer. David Perell (host…

I disagree that writing is undervalued. I think that writing is highly valuable and highly rewarded...but that the path to overcome challenges with writing is bafflingly mysterious. Does anyone know of a therapist who has experience helping people overcome writing anxiety? I genuinely don’t know how to find one. Therapist-shopping is baffling. I ask this as a software engineer who can produce pretty solid writing if…

[deleted]

Re: Undervalued Engineering Skills: Writing Well

#345

Earlier quoted context omitted.

I used to think like that (being the kid that wrote well in school). But now I'm not so sure anymore... Been humbled too many times by people much, much smarter than me that wrote in smsesque. Have read too many apparently well-written texts that are nothing but bullshit written by ignorants.

> Been humbled too many times by people much, much smarter than me that wrote in smsesque. Have read too many apparently well-written texts that are nothing but bullshit written by ignorants. I cannot imagine why you found them humbling. Ignorance or lack of skill are forgivable, but poor writing by someone who could do better but just doesn't care about their output or their audience is just lazy. If someone who cou…

> I cannot imagine why you found them humbling.

Because they were humbling to me and I learned a lot from them, despite their clumsy writing style (not because of their writing style!).

Imagine that you have worked several weeks on a problem, you are very proud of the code that you created that solves the problem elegantly; you document it with well-written, correctly punctuated comments and documentation. Then the smspeaker looks over your shoulder and says "dude, this data structure isn't necessary here, just use a table of integers and it will be faster and the code 80% shorter", which is a self-evident statement after the fact. THAT is humbling, regardless of whether the guy writes his mails in correct english or smsesque.

Re: Undervalued Engineering Skills: Writing Well

#346

Earlier quoted context omitted.

exactly! i am reading all these replies and i found them really interesting. i think the same people being annoyed by sms-like writing, would get mad at me not using proper casing with my sentences. at the end of the day, i think it does not matter. i am not writing a book or an article. and when i am texting, i would rather keep it short, sms-like. i would like to understand, truly, why people get mad at such things…

Emoji are a terrible insult to the written word. They're also an affront to imagery. Standard images, at least, are the same image everywhere. A grid of pixels is a grid of pixels. Emoji, however, vary from platform to platform, so what you pick may well not be what your reader sees. In some cases that may matter, in others it may not. Furthermore, some people construct new meanings and usages for emoji that do not a…

Emoji are part of the natural oscillation of written language history between ideographic and phonetic. It has happened several times in history, there's nothing to worry about.

Re: Undervalued Engineering Skills: Writing Well

#347
post #34

In a past life I helped optimize >$1b of online transactions as a CRO professional and learning to objectively "write well" could be quantified in two ways: 1) Message Density - there's a great quote attributed to Mark Twain that nails this "If I'd had more time I would have written you a shorter letter". In practice Jeff Bezo's push to making executives build "4 page memos" for meetings outlines this idea clearly: "…

It is more accurate to credit Blaise Pascal for that aphorism https://quoteinvestigator.com/2012/04/28/shorter-letter/

Re: Undervalued Engineering Skills: Writing Well

#348
Funny, I never thought that that would be the hill one of my plans would die on. Writing well - and reasonably quick - is rare, when you take the intersection of people that have that skill with people that are technically inclined the resulting set is super small.

Re: Undervalued Engineering Skills: Writing Well

#349
post #4

I agree with the author that writing is one of the most undervalued skills for SWEs, but for a completely different reason - it forces you to reason things through properly, even if nobody else will ever read what you write. Writing a couple of pages of design docs or an Amazon-style 6 pager or whatever might take a few days of work, but can save weeks or more of wasted implementation time when you realise your syste…

As a friend of mine said: "When you write something down you think you are changing the contents of the paper but really it changes you."
Post reply on HN