LEADERSHIP LAB: Writing Beyond the Academy 1.23.15

Last year wrote a technical writing advice checklist for engineers called How to ask for help in Slack : link . I was at Canva, a fast growing company adding 500 engineers a year, and the tenured engineers were getting hit with a lot of questions and help requests. I thought about this list a lot, and believe that maintaining adherence to all 10 checklist items will dramatically improve your technical communication in chat apps. For advice on writing long form communications, my absolute favorite resource is LEADERSHIP LAB: Writing Beyond the Academy [1]. This lecture will cleanse you of all the bad writing ideas you picked up in 12+ years of schooling, and show you actually how to think about professional writing. I've watched it about 4-5 times. 1. ▶ this video

It's an article about writing, which means I will plug this lecture again: ▶ this video Short version: good writing is not about rules, it's about the function of the text, the readers, and what they value.

My favorite writing lecture is this one: ▶ this video The number one piece of advice: your writing can be clear and structured, but if it's not valuable it's useless and people will stop reading. If you want to write well, figure out who your readers are, figure out what they value, and give it to them.

the act of writing takes raw experience, puts it in front of the eyes, and then filters it back through your critical faculties so you can refine and reason about it. the iteration makes it higher quality thought. making writing valuable is another skill (see this evergreen lecture from the university of chicago leadership lab: ▶ this video ) however when I encounter people with low written or verbal acuity, they have to survive somehow, so it's wise to observe what tools of cunning they tend to reach for.

A post about writing means that I need to plug a couple talks by Larry McEnerney. [1,2] The tool described in this blog post is all about text-based rules: what the _text_ ought to look like. To improve your own writing (a) learn who your readers are, (b) know what they value, and (c) write so that as readers, they find your work valuable to them. [1] link [2] ▶ this video

This is clearer, more indepth, and longer: ▶ this video But I found it more motivated me to change. (Chicago U, writing class for grad students)

> "Tell ‘Em What You’re Going To Tell ‘Em; Next, Tell ‘Em; Next, Tell ‘Em What You Told ‘Em" “This is not a source of value !” — ▶ this video

Apologies, that was the wrong link: the explicit mention of the three-step structure is here: ▶ this video ALthough, I think that the first link is a better version of the two.