A place to cache linked articles (think custom and personal wayback machine)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

index.md 42KB

2 years ago
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877
  1. title: No, We Won’t Have a Video Call for That!
  2. url: https://xahteiwi.eu/resources/presentations/no-we-wont-have-a-video-call-for-that/
  3. hash_url: 6c45b2e9a3bd7dc678d52e047a88cd1d
  4. <p>FrOSCon 2020 was an online event due to the COVID-19 pandemic, and
  5. gave me the opportunity to present an extended and heavily updated
  6. version of my <a href="https://xahteiwi.eu/resources/presentations/devopsdays-tel-aviv-2019/">DevOpsDays 2019</a> talk.</p>
  7. <hr>
  8. <p>I normally make my talks available as a video, and a slide deck with
  9. full speaker notes. In this case though, I consider it fitting to
  10. write the whole thing out, so that you <em>don’t</em> need to watch a full
  11. length video in 45 minutes, but can read the whole thing in 15.</p>
  12. <p>You’ll still find links to the recording and deck downpage, as usual.</p>
  13. <hr>
  14. <p>No, we won’t have a video call for that!</p>
  15. <p>Communications for distributed teams</p>
  16. <p>FrOSCon 2020</p>
  17. <p>This presentation is a talk presented at <a href="https://www.froscon.de/">FrOSCon 2020
  18. Cloud Edition</a>. It is <a href="https://creativecommons.org/licenses/by-sa/4.0/">CC-BY-SA
  19. 4.0</a> licensed, see
  20. <a href="/LICENSE">the license</a> for details.</p>
  21. <p>Hello and welcome, dear FrOScon people — this is my talk on
  22. communications in distributed teams. My name is Florian, this is the
  23. second time I‘m speaking at FrOScon, and you probably want to know
  24. what the hell qualifies me to talk about this specific issue. So:</p>
  25. <h3>Why am I talking here?</h3>
  26. <p>So, why am I talking about <strong>that</strong>?</p>
  27. <p>Or rather more precisely, why am <strong>I</strong> talking about that?</p>
  28. <p>I turned 40 last year, have been in IT for about 20 years now (19
  29. full-time), and out of that I have worked</p>
  30. <ul>
  31. <li>
  32. <p>in 4 successive companies, all of which worked out of offices,
  33. for 11 years, </p>
  34. </li>
  35. <li>
  36. <p>in a completely distributed company, that I founded, for 6 years,</p>
  37. </li>
  38. <li>
  39. <p>and now, for about three years, I have been running a distributed
  40. team that is a business unit of a company that has existed for 15
  41. years and throughout that time, has only ever worked from a single
  42. office.</p>
  43. </li>
  44. </ul>
  45. <p>So I think I might have seen and become aware of some of the rather
  46. interesting challenges that come with this.</p>
  47. <h3>What changed since last time?</h3>
  48. <p>I originally wrote and presented this talk for the first time in
  49. December 2019. At the time, you probably had forgotten about SARS, had
  50. no idea what SARS-CoV2 or COVID-19 were, and many of you were probably
  51. working from offices.</p>
  52. <p>And then something like three months later, everything changed and
  53. suddenly, this talk became much more relevant to a much greater
  54. audience.</p>
  55. <p>And something else happened: a lot of people suddenly started talking
  56. about working from home and distributed teams, and a lot of those
  57. people who were talking very loudly, had themselves only been working
  58. with or managing distributed teams since March. And a fair amount of
  59. what you could about the subject then, and can still read now, is
  60. complete and utter bullshit.</p>
  61. <p>So there’s one point I actually <em>didn’t</em> make in the initial version
  62. of this talk, because I thought it was self-evident. But I have come
  63. to the conclusion that to a lot of people it is not, so to rectify
  64. this omission from last December — and with apologies for that
  65. omission to the wonderful DevOpsDays Tel Aviv crowd, who were my first
  66. audience for this talk, let me make this one thing very clear from the
  67. outset:</p>
  68. <blockquote>
  69. <p>Effective distributed collaboration is <strong>not</strong> pretending to be in
  70. an office while staring into a webcam all day.</p>
  71. </blockquote>
  72. <p>You will never be able to capitalize on work as a distributed team
  73. unless you kick some office habits. The key to distributed teams being
  74. effective is <strong>not</strong> that they happen to not be in the same place, as
  75. you’ll see from the remainder of this talk. So to expect success from
  76. the approach that you take the habits of an office, simply remove the
  77. element of locality, replace every face to face meeting with a video
  78. call and carry on, is ludicrous.</p>
  79. <p>The good news is that if you do it right, you’ll end up with a far
  80. better team than a local one would ever be, <em>and</em> everyone has a
  81. chance at far better work-life balance, <em>and</em> you don’t waste awful
  82. amounts of time and energy and fossil fuels on your commute.</p>
  83. <h3>What’s in this talk?</h3>
  84. <p>So you’ll find a few general themes throughout this talk:</p>
  85. <ul>
  86. <li>
  87. <p>What modes we have <em>available</em> for communications in teams;</p>
  88. </li>
  89. <li>
  90. <p>Why distributed teams always collaborate <em>asynchronously,</em> and what
  91. communication modes lend themselves to that particularly well;</p>
  92. </li>
  93. <li>
  94. <p>Why <em>written communication</em> is so important in distributed teams;</p>
  95. </li>
  96. <li>
  97. <p>And why <em>meetings</em> (like video calls) are a mode of communication
  98. that effective distributed teams hardly ever need to use — except
  99. for very specific reasons.</p>
  100. </li>
  101. </ul>
  102. <p>But I do want to state one thing upfront:</p>
  103. <blockquote>
  104. <p>This is <em>not science.</em></p>
  105. </blockquote>
  106. <p>Nothing of what I am talking about is steeped in any scientific
  107. rigour. I present anecdotes, not evidence. I might be mistaking
  108. correlation for causation, or the other way round. It’s solely based
  109. on my personal experience, and the experience of others I have talked
  110. to, watched, or read. Everything I say here is subject to debate and
  111. rebuttal, or you can simply have a different opinion.</p>
  112. <p>But it’s definitely <strong>not</strong> science.</p>
  113. <p>Now with all of that said, let me attempt to give a definition of a
  114. distributed team, according to my understanding:</p>
  115. <p>A distributed team is a <strong>professional</strong> group whose members do not
  116. rely on proximity in order to <strong>routinely</strong> collaborate
  117. productively.</p>
  118. <p>Now this is clearly not an ideal definition, not least because it
  119. defines something by a negative, and an outside factor to boot: it
  120. defines a distributed team by what it <em>does not need</em> to exist to
  121. function. But it’s the best definition I’ve been able to come up with.</p>
  122. <p>Now there’s a couple of key words in here:</p>
  123. <ul>
  124. <li>
  125. <p><strong>Professional.</strong> I’m talking about teams that work towards a
  126. professional goal. This doesn’t necessarily mean that they all work
  127. in the same company. They could, for example, all work in different
  128. companies collaborating on a joint project, which is what frequently
  129. happens in open source software projects. But they’re not pursuing
  130. their hobby, they’re doing their jobs.</p>
  131. </li>
  132. <li>
  133. <p><strong>Routinely.</strong> I’m talking about teams that <em>habitually</em> work in a
  134. distributed fashion, not the work that goes on in an office-based
  135. team when one person is having a work-from-home day.</p>
  136. </li>
  137. </ul>
  138. <p>It is important to understand that that lack of proximity is not only
  139. spatial, it is temporal as well, because:</p>
  140. <blockquote>
  141. <p>Working in a distributed team means <strong>working asynchronously.</strong></p>
  142. </blockquote>
  143. <p>If your team is distributed, this is equivalent to saying that it
  144. works in an asynchronous fashion, that is to say, that people will
  145. work on things in parallel, and a capable distributed team will have
  146. just as few synchronization points as absolutely necessary.</p>
  147. <p>The reason for this is not just working in different timezones, but
  148. also the fact that everyone will have their own daily routine, and/or
  149. have their individual times when they are most productive. Which you
  150. <em>will not attempt to synchronize.</em> (Doing so would mean setting the
  151. entire team up for failure.)</p>
  152. <p>Now, this doesn’t come for free, nor does it fall in our lap:</p>
  153. <blockquote>
  154. <p>Being productive in a distributed team is a skill
  155. that most people must <strong>learn;</strong> it is not innate to us.</p>
  156. </blockquote>
  157. <p>People are not born with the ability to work in a distributed
  158. team. Humans function best in groups that collaborate in close
  159. proximity to one another; it is only very recently that technology has
  160. started to enable us to override that to an extent — giving us other
  161. benefits like the ability to work from home, or the ability to hire
  162. people residing anywhere, provided they have internet connectivity.</p>
  163. <p>So we now <em>can</em> work in teams despite being continental distances away
  164. from each other but we do have to acquire the skills to do that. And
  165. if we fail to do so, that has a rather grave disadvantage, which is
  166. that...</p>
  167. <blockquote>
  168. <p><strong>Nothing</strong> has as dire an impact on productivity as <strong>poor
  169. communications.</strong></p>
  170. </blockquote>
  171. <p>This is a truism that applies to both distributed and non-distributed
  172. teams. Having bad communications will wreck any project, blow any
  173. budget, fail any objective. Now note that the reverse is <em>not true:</em>
  174. having <em>good</em> communications does not guarantee success. But having
  175. bad communications does guarantee failure.</p>
  176. <p>And here is one thing to start with:</p>
  177. <blockquote>
  178. <p>A capable distributed team <strong>habitually externalises</strong> information.</p>
  179. </blockquote>
  180. <p>Information is generally far less useful when it is only stored in one
  181. person’s head, as opposed to being accessible in a shared system that
  182. everyone trusts and can use. If you take important information out of
  183. your own head and store it in a medium that allows others to easily
  184. find and contextualise it, that’s a win for everyone.</p>
  185. <p>And since we’re all technology people, we typically have multiple
  186. facilities to externalise, share, and then access information at our
  187. disposal. So let’s see how those compare.</p>
  188. <h2>Modes of communication in distributed teams</h2>
  189. <p>A distributed team will habitually use multiple modes of
  190. communication, relying mostly on those that make sharing, finding, and
  191. contextualising information easy, and avoiding those that make it
  192. difficult.</p>
  193. <p>In many teams, distributed or not, using chat as a default mode of
  194. communication is becoming the norm. Now with an important exception,
  195. which I’ll get to near the end of the talk, this is <strong>not</strong> a symptom
  196. of having a particularly dynamic or efficient team; it’s the opposite.</p>
  197. <blockquote>
  198. <p>Excessively using chat isn’t being efficient.
  199. It’s being lazy.</p>
  200. </blockquote>
  201. <p>It’s a symptom of the worst kind of laziness <em>(not malice!)</em>: in an
  202. attempt to communicate quickly and easily, for yourself, you are really
  203. making things harder for everyone, including yourself.</p>
  204. <table class="table-hover table table-striped">
  205. <thead>
  206. <tr>
  207. <th></th>
  208. <th align="center">Share</th>
  209. <th align="center">Find</th>
  210. <th>Contextualise</th>
  211. </tr>
  212. </thead>
  213. <tbody>
  214. <tr>
  215. <td>Chat</td>
  216. <td align="center">🙂</td>
  217. <td align="center">😐</td>
  218. <td>🙁</td>
  219. </tr>
  220. </tbody>
  221. </table>
  222. <p>This is because, while <em>sharing</em> information in a chat is extremely
  223. easy, it is also a “fire and forget” mode of communications. Chat
  224. makes it difficult to find information after the fact. If you’ve ever
  225. attempted to scour a busy Slack or IRC archive for a discussion on a
  226. specific topic that you only remember to have happened a “few months
  227. ago”, you’ll agree with me here.</p>
  228. <p>It’s even <em>more</em> difficult to read a Slack discussion in context, that
  229. is to say in relation to <em>other</em> discussions on the same topic, days
  230. or weeks earlier or later.</p>
  231. <p>Let’s compare that to other communication modes:</p>
  232. <table class="table-hover table table-striped">
  233. <thead>
  234. <tr>
  235. <th></th>
  236. <th align="center">Share</th>
  237. <th align="center">Find</th>
  238. <th>Contextualise</th>
  239. </tr>
  240. </thead>
  241. <tbody>
  242. <tr>
  243. <td>Chat</td>
  244. <td align="center">🙂</td>
  245. <td align="center">😐</td>
  246. <td>🙁</td>
  247. </tr>
  248. <tr>
  249. <td>Email</td>
  250. <td align="center">😐</td>
  251. <td align="center">😐</td>
  252. <td>😐</td>
  253. </tr>
  254. </tbody>
  255. </table>
  256. <ul>
  257. <li>Email makes it easy to share information with a person or a group
  258. from the get-go, but quite difficult to loop people into an ongoing
  259. discussion after the fact. Finding information later is just as hard
  260. as with chat, and it’s marginally better at contextualizing
  261. information than chat (because you get proper threading).</li>
  262. </ul>
  263. <table class="table-hover table table-striped">
  264. <thead>
  265. <tr>
  266. <th></th>
  267. <th align="center">Share</th>
  268. <th align="center">Find</th>
  269. <th>Contextualise</th>
  270. </tr>
  271. </thead>
  272. <tbody>
  273. <tr>
  274. <td>Chat</td>
  275. <td align="center">🙂</td>
  276. <td align="center">😐</td>
  277. <td>🙁</td>
  278. </tr>
  279. <tr>
  280. <td>Email</td>
  281. <td align="center">😐</td>
  282. <td align="center">😐</td>
  283. <td>😐</td>
  284. </tr>
  285. <tr>
  286. <td>Wiki</td>
  287. <td align="center">🙂</td>
  288. <td align="center">🙂</td>
  289. <td>🙂</td>
  290. </tr>
  291. <tr>
  292. <td>Issue tracker</td>
  293. <td align="center">🙂</td>
  294. <td align="center">🙂</td>
  295. <td>🙂</td>
  296. </tr>
  297. </tbody>
  298. </table>
  299. <ul>
  300. <li>A wiki and an issue tracker (provided you don’t lock them down with
  301. silly view permissions), in contrast, both make it <em>very</em> easy to
  302. share, find, <strong>and</strong> contextualise information.<br>
  303. Note that “wiki”, in this context, is shorthand for any facility
  304. that allows you to collaboratively edit long-form documents
  305. online. That can be an actual wiki like a MediaWiki, but also
  306. something like Confluence, or even shared Google Docs.<br>
  307. Likewise, “issue tracker” can mean RT, OTRS, Jira, Taiga, Bugzilla,
  308. whatever works for you.</li>
  309. </ul>
  310. <table class="table-hover table table-striped">
  311. <thead>
  312. <tr>
  313. <th></th>
  314. <th align="center">Share</th>
  315. <th align="center">Find</th>
  316. <th>Contextualise</th>
  317. </tr>
  318. </thead>
  319. <tbody>
  320. <tr>
  321. <td>Chat</td>
  322. <td align="center">🙂</td>
  323. <td align="center">😐</td>
  324. <td>🙁</td>
  325. </tr>
  326. <tr>
  327. <td>Email</td>
  328. <td align="center">😐</td>
  329. <td align="center">😐</td>
  330. <td>😐</td>
  331. </tr>
  332. <tr>
  333. <td>Wiki</td>
  334. <td align="center">🙂</td>
  335. <td align="center">🙂</td>
  336. <td>🙂</td>
  337. </tr>
  338. <tr>
  339. <td>Issue tracker</td>
  340. <td align="center">🙂</td>
  341. <td align="center">🙂</td>
  342. <td>🙂</td>
  343. </tr>
  344. <tr>
  345. <td>Video call</td>
  346. <td align="center">😐</td>
  347. <td align="center">🙁</td>
  348. <td>🙁</td>
  349. </tr>
  350. </tbody>
  351. </table>
  352. <ul>
  353. <li>Video calls are even worse than chat or email, because sharing
  354. information works but doesn’t scale — you can’t reasonably have more
  355. than 5-or-so people in a video call, and sharing the recording of a
  356. full video call is just pointless.</li>
  357. </ul>
  358. <p>So really, make your wiki and your issue tracker your default mode of
  359. communications, and use the others sparingly. (This isn’t meant to be
  360. a euphemism for “don’t use them”, as we’ll get to in a moment.)</p>
  361. <h2>Text chat</h2>
  362. <p>So. Let’s talk about text chat. These days, that frequently means
  363. <a href="https://slack.com/">Slack</a>, but what I am talking about also and
  364. equally applies to
  365. <a href="https://en.wikipedia.org/wiki/Internet_Relay_Chat">IRC</a>,
  366. <a href="https://mattermost.com/">Mattermost</a>, <a href="https://riot.im/">Riot</a>, and
  367. anything similar.</p>
  368. <p>Is text chat universally useful? No. Is it universally bad? Not that,
  369. either. There is a very specific type of situation in which text chat
  370. is a good thing:</p>
  371. <blockquote>
  372. <p>Use <strong>chat</strong> for collaboration that requires <strong>immediate,
  373. interactive mutual feedback.</strong></p>
  374. </blockquote>
  375. <p>Using interactive chat is a good idea for the kind of communication
  376. that requires immediate, interactive mutual feedback from two or more
  377. participants. If that is not the case, chat is not a good idea.</p>
  378. <p>This means that the only thing that chat is good for is communication
  379. that is required to be <em>synchronous,</em> and remember, in a distributed
  380. team <em>asychronicity</em> is the norm. So using interactive chat for
  381. communications needs to be an <em>exceptional</em> event for a distributed
  382. team; if it is instead a regular occurrence you’ll make everyone on
  383. the team miserable.</p>
  384. <p>For any interaction that does <em>not</em> require feedback that is <em>both</em>
  385. immediate and interactive, email, a wiki, or an issue tracker are <em>far
  386. superior</em> modes of communication.</p>
  387. <blockquote>
  388. <p>The only reason to use <strong>DMs</strong> for collaboration<br>
  389. is a need for immediate, interactive mutual feedback<br>
  390. <strong>and confidentiality.</strong></p>
  391. </blockquote>
  392. <p>Using chat direct messages (DMs) as the <em>default</em> means of
  393. communication is utterly braindead. In order for a chat DM to be
  394. useful, there is precisely one clearly delineated confluence of events
  395. that must occur:</p>
  396. <ul>
  397. <li>You need immediate feedback from the other person,</li>
  398. <li>you need mutual back-and-forth with the other person,</li>
  399. <li>you don’t want others to follow the conversation.</li>
  400. </ul>
  401. <p>I can’t emphasize enough that this combination is perfectly valid —
  402. but it is <em>exceedingly rare.</em> If you want just a private exchange of
  403. ideas with someone, encrypted email will do. If you want to work on
  404. something together with one person before you share it with others,
  405. restricted view permissions on a wiki page or an issue tracker ticket
  406. will work just fine.</p>
  407. <p>If you don’t need confidentiality but you do need interactive and
  408. immediate feedback, chances are that you’re working on something
  409. urgent, and it is far more likely you’ll eventually need to poll other
  410. opinions, than that you won’t. So just use a shared channel from the
  411. get-go, that way it’s easier for others to follow the conversation if
  412. needed — and they might be able to point out an incorrect assumption
  413. that one of you has, before you end up chasing a red herring.</p>
  414. <blockquote>
  415. <p>A chat ping is a shoulder tap.</p>
  416. </blockquote>
  417. <p>“Pinging” someone in a chat (that is, mentioning their username, which
  418. usually triggers a visual or auditory notification), is exactly like
  419. walking up to a person, interrupting what they are doing, tapping them
  420. on the shoulder, and asking them a question.</p>
  421. <p><strong>No matter whether it is your intention or not,</strong> they will feel
  422. compelled to answer, relatively promptly (the only exception is when
  423. you’ve done this so often that you have conditioned your colleagues
  424. to ignore you — congratulations).</p>
  425. <p>This means that you’ve broken their train of thought, yanked them out
  426. of a potentially complex task, forced them to redo what they did
  427. pre-interruption, or actually have them commit a mistake.</p>
  428. <p>So pinging someone in a chat is something you should only do if you
  429. are aware of exactly this risk, <em>and</em> you are convinced that whatever
  430. you’re pinging about is more important. Otherwise, to be very blunt,
  431. you’ll be seen as the asshole.</p>
  432. <blockquote>
  433. <p>Want people to hate you? Send naked pings.</p>
  434. </blockquote>
  435. <p>A “naked ping” is the action of sending someone a message consisting
  436. only of their username and a marker like “ping”, “hi”, “hey” or
  437. similar.</p>
  438. <div class="highlight"><pre><span></span><code><span class="mi">14</span><span class="o">:</span><span class="mi">00</span><span class="o">:</span><span class="mi">02</span><span class="n">Z</span> <span class="n">johndoe</span><span class="o">:</span> <span class="n">florian</span><span class="o">:</span> <span class="n">ping</span>
  439. <span class="o">[...]</span>
  440. <span class="mi">15</span><span class="o">:</span><span class="mi">56</span><span class="o">:</span><span class="mi">17</span><span class="n">Z</span> <span class="n">florian</span><span class="o">:</span> <span class="n">johndoe</span><span class="o">:</span> <span class="n">I</span> <span class="n">hate</span> <span class="n">you</span>
  441. </code></pre></div>
  442. <p>Don’t. Just don’t.</p>
  443. <p>Any person who is versed in the use of chat communications will, when
  444. subjected to this behavior, be inclined to flay you alive. Infinitely
  445. more so if it’s a DM. <strong>Do not do this.</strong></p>
  446. <p>Instead, always provide context. Always always always. Don’t say “can
  447. I ask you a question, instead, <em>ask the question.</em> If something isn’t
  448. urgent, say something like “no urgency.”</p>
  449. <div class="highlight"><pre><span></span><code><span class="mi">14</span><span class="o">:</span><span class="mi">00</span><span class="o">:</span><span class="mi">02</span><span class="n">Z</span> <span class="n">johndoe</span><span class="o">:</span> <span class="n">florian</span><span class="o">:</span> <span class="n">can</span> <span class="n">I</span> <span class="kd">get</span> <span class="n">your</span> <span class="n">eyes</span> <span class="n">on</span> <span class="n">PR</span> <span class="err">#</span><span class="mi">1422</span><span class="o">?</span>
  450. <span class="o">[...]</span>
  451. <span class="mi">15</span><span class="o">:</span><span class="mi">56</span><span class="o">:</span><span class="mi">17</span><span class="n">Z</span> <span class="n">florian</span><span class="o">:</span> <span class="n">johndoe</span><span class="o">:</span> <span class="n">done</span><span class="o">!</span>
  452. <span class="o">(</span><span class="n">was</span> <span class="n">afk</span> <span class="k">for</span> <span class="n">a</span> <span class="n">bit</span> <span class="err">–</span> <span class="n">sick</span> <span class="n">kiddo</span><span class="o">)</span>
  453. <span class="mi">15</span><span class="o">:</span><span class="mi">56</span><span class="o">:</span><span class="mi">58</span><span class="n">Z</span> <span class="n">johndoe</span><span class="o">:</span> <span class="n">florian</span><span class="o">:</span> <span class="n">np</span><span class="o">,</span> <span class="n">ty</span>
  454. </code></pre></div>
  455. <p>It should be self-evident why this is better than naked pings, but if
  456. to you it is not, then please read <a href="https://blogs.gnome.org/markmc/2014/02/20/naked-pings/">Naked
  457. Pings</a>,
  458. courtesy of Adam Jackson and Mark McLoughlin.</p>
  459. <h2>Video calls</h2>
  460. <p>(Zoom, Hangouts, BlueJeans etc.)</p>
  461. <p>Next, I’d like to talk about video calls. Doesn’t matter what
  462. technology you’re using. Could be Zoom, Google Hangouts, BlueJeans,
  463. Jitsi, whatever.</p>
  464. <p>And I’d like to address this specifically, given the fact that in the
  465. current pandemic the use of video calls appears to have skyrocketed.</p>
  466. <p>There’s a very good reason to use video calls: they give you the
  467. ability to pick up on nontextual and nonverbal cues from the call
  468. participants. But that’s really the only good reason to use them.</p>
  469. <p>Video calls have a significant drawback: until we get reliable
  470. automatic speech recognition and transcription, they are only
  471. half-on-the-record. Hardly anyone goes to the trouble of preparing a
  472. full transcript of a meeting, and if anything, we get perhaps a
  473. summary of points discussed and action items agreed to. So even if we
  474. keep recordings of every video call we attend, it’s practically
  475. impossible to discern, after the fact, what was discussed in a meeting
  476. <em>before</em> decisions were made.</p>
  477. <p>It is also practically impossible to <em>find</em> a discussion point that
  478. you only have a vague recollection of when it was discussed in a video
  479. call, whereas doing so has a much greater probability of success if
  480. a discussion took place on any archived text-based medium.</p>
  481. <blockquote>
  482. <p>Every video call needs an agenda.</p>
  483. </blockquote>
  484. <p>This is, of course, true for any meeting, not just those conducted by
  485. video call.</p>
  486. <p>A conversation without an agenda is useless. You want people to know
  487. what to expect of the call. You also want to give people the option to
  488. prepare for the call, such as doing some research or pulling together
  489. some documentation. If you fail to circulate those <em>ahead of time,</em> I
  490. can guarantee that the call will be ineffective, and will likely
  491. result in a repeat performance.</p>
  492. <blockquote>
  493. <p>Until machines get intelligent enough to automatically transcribe
  494. and summarise words spoken in a meeting, <strong>write notes and a summary
  495. of every meeting you attend,</strong> and <strong>circulate them.</strong></p>
  496. </blockquote>
  497. <p>Just as important as an agenda to set the <em>purpose</em> of the meeting, is
  498. a set of notes that describes its <em>outcome</em>. </p>
  499. <p>Effective distributed teams understand that the <em>record</em> of a call is
  500. what counts, not the call itself. It is not the spoken word that
  501. matters, but the written one.</p>
  502. <p>From that follows this consequence:</p>
  503. <blockquote>
  504. <p>To be useful, the write-up of a call <strong>takes more time and effort</strong>
  505. than the call itself.</p>
  506. </blockquote>
  507. <p>If you think that video calls are any less work than chat meetings or
  508. a shared document that’s being edited together or dicussed in
  509. comments, think again. The only way a video call is less work, is when
  510. everyone’s lazy and the call is, therefore, useless. Every meeting
  511. needs notes and a summary, and you need to circulate these notes not
  512. only with everyone who attended the meeting, but with everyone who has
  513. a need-to-know.</p>
  514. <p>Here’s the standard outline I use for meeting notes:</p>
  515. <ol>
  516. <li>Meeting title</li>
  517. <li>Date, time, attendees</li>
  518. <li>Summary</li>
  519. <li>Discussion points (tabular)</li>
  520. <li>Action items</li>
  521. </ol>
  522. <p>Putting an executive summary at the very top is extraordinarily
  523. helpful so people can decide if they</p>
  524. <ul>
  525. <li>should familiarise themselves with what was discussed, immediately,
  526. and possibly respond if they have objections, or</li>
  527. <li>only want to be aware of what was decided, or</li>
  528. <li>just keep in the back of their head that a meeting happened, that
  529. notes exist, and where they can find them when they need to refer
  530. back to them.</li>
  531. </ul>
  532. <blockquote>
  533. <p>Once you do meetings right, you no longer need most of them.</p>
  534. </blockquote>
  535. <p>The funny thing is that once you adhere to this standard — and I
  536. repeat, having a full and detailed record is <em>the only acceptable
  537. standard</em> for video meetings – you’ll note that you can actually skip
  538. the meeting altogether, use <em>just</em> a collaboratively edited document
  539. <em>instead</em> of your meeting notes, and remove your unnecessary
  540. synchronization point.</p>
  541. <h3>Video calls for recurring team meetings</h3>
  542. <p>There is one thing that I do believe video calls are good for, and
  543. that is to use them for <em>recurring</em> meetings as as an
  544. opportunity to feel the pulse of your team.</p>
  545. <p>Obviously, a distributed team has <em>few</em> recurring meetings, because
  546. they are synchronization points, and we’ve already discussed that we
  547. strive to minimize those. So the idea of having daily standups, sprint
  548. planning meetings, and sprint retrospectives is fundamentally
  549. incompatible with distributed teams. <em>Aside: in my humble opinion,
  550. this is also why using Scrum is a terrible idea in distributed teams —
  551. not to mention <a href="https://youtu.be/f-ULT_Ic4qk">that it’s a terrible idea,
  552. period.</a></em></p>
  553. <p>However, having perhaps one meeting per week (or maybe even one every
  554. two weeks) in a video call is useful <em>precisely for the aforementioned
  555. reasons</em> of being able to pick up on nonverbal clues like body
  556. language, posture, facial expressions, and tone. If people are
  557. stressed out or unhappy, it’ll show. If they are relaxed and
  558. productive, that will show too.</p>
  559. <p>Note that these meetings, which of course do follow the same rules
  560. about agenda and notes, are not strictly <em>necessary</em> to get the work
  561. done. The team I run has one one-hour meeting a week, but whenever
  562. that meeting conflicts with anything we skip it and divide up our
  563. work via just the circulated coordination notes, and that works
  564. too. The meeting really serves the purpose of syncing emotionally, and
  565. picking up on nonverbal communications.</p>
  566. <h2>Briefing people</h2>
  567. <p>Whenever you need to thoroughly <strong>brief a group of people on an
  568. important matter,</strong> consider using a <strong>5-paragraph format.</strong></p>
  569. <ol>
  570. <li>Situation</li>
  571. <li>Mission</li>
  572. <li>Execution</li>
  573. <li>Logistics</li>
  574. <li>Command and Signal</li>
  575. </ol>
  576. <p>This is a format as it is being used by many armed forces; in NATO
  577. parlance it’s called the 5-paragraph field order. Now I’m generally
  578. not a fan of applying military thinking to civilian life — after all
  579. we shouldn’t forget that the military is an institution that kills
  580. people and breaks things, and I say that as a commissioned officer in
  581. my own country’s army —, but in this case it’s actually something that
  582. can very much be applied to professional communications, with some
  583. rather minor modifications:</p>
  584. <ol>
  585. <li>Situation</li>
  586. <li>Objective</li>
  587. <li>Plan</li>
  588. <li>Logistics</li>
  589. <li>Communications</li>
  590. </ol>
  591. <p>Let’s break these down in a little detail:</p>
  592. <ol>
  593. <li>Situation is about what position we’re in, and <strong>why</strong> we set out
  594. to do what we want to do. You can break this down into three
  595. sub-points, like the customer’s situation, the situation of your
  596. own company, any extra help that is available, and the current
  597. market.</li>
  598. <li>Objective is <strong>what</strong> we want to achieve.</li>
  599. <li>Plan is <strong>how</strong> we want to achieve it.</li>
  600. <li>Logistics is about what budget and resources are available, and how
  601. they are used.</li>
  602. <li>Communications is about how you’ll be coordinating among yourselves
  603. and with others in order to achieve your goal.</li>
  604. </ol>
  605. <p>Note that people <em>always</em> have questions on what they’ve just been
  606. briefed about. They just might not think of them straight away. Give
  607. people time to think through what you’ve just briefed them on, and
  608. they will think of good questions. So always have a follow-up round at
  609. a later time (2 hours later, the following day, whatever), for which
  610. you <em>encourage</em> your group to come back with questions.</p>
  611. <p>Also, use that same follow-up for checking how your briefing came
  612. across, by gently quizzing people with questions like</p>
  613. <ul>
  614. <li>“by what date do we want to implement X?”, or</li>
  615. <li>“Joe, what things will you need to coordinate with Jane on?”</li>
  616. </ul>
  617. <p>This gives you valuable feedback on the quality of your briefing: if
  618. your team can’t answer these questions, chances are that you weren’t
  619. as clear as you should have been.</p>
  620. <h2>Pinching the firehose</h2>
  621. <p>Finally, I want to say a few words about what I like to call pinching
  622. the figurative firehose you might otherwise be forced to drink from:</p>
  623. <blockquote>
  624. <p>The amount of incoming information in a distributed team can be
  625. daunting.</p>
  626. </blockquote>
  627. <p>When you work in a distributed team, since everyone is on their own
  628. schedule and everything is asynchronous, you may be dealing with a
  629. constant incoming stream of information — from your colleagues, your
  630. reports, your manager, your customers. </p>
  631. <p>There is no way to change this, so what you need to do is apply your
  632. own structure to that stream. What follows is not <strong>the</strong> way to do
  633. that, but <em>one</em> way, and you may find another works better for
  634. you. But you will need to define and apply <em>some</em> structure, otherwise
  635. you’ll feel constantly overwhelmed and run the risk of burning out.</p>
  636. <blockquote>
  637. <p>Consider using the <strong>“4-D” approach</strong> when dealing with incoming
  638. information.</p>
  639. </blockquote>
  640. <p>(Hat tip to David Allen)</p>
  641. <p>There’s a defined approach for doing this, which I learned about from
  642. reading <a href="https://en.wikipedia.org/wiki/David_Allen_(author)">David
  643. Allen</a>’s <a href="https://www.goodreads.com/book/show/1633.Getting_Things_Done">Getting
  644. Things
  645. Done</a>. I
  646. don’t know if Allen invented the 4-D approach or whether someone came
  647. up with it before him, but that’s how I know about it.</p>
  648. <p>In his book, David Allen suggests to apply one of the following four
  649. actions to any incoming bit of information:</p>
  650. <ul>
  651. <li><strong>Drop</strong> means read, understand, and then archive. It’s what you use
  652. for anything that doesn’t require any action on your part.</li>
  653. <li><strong>Delegate</strong> is for things that do require action, but not from
  654. you. Make sure that it gets to the right person and is understood by
  655. <em>them</em>, and make a note for follow-up.</li>
  656. <li><strong>Defer</strong> means it needs doing, and it’s you who needs to do it, but
  657. it doesn’t need doing <em>immediately</em>. Enter it into your task list
  658. (to use a very generic term, more on this in a bit), and clear it
  659. from your inbox.</li>
  660. <li><strong>Do</strong> are the (typically very few) things that remain that need to
  661. be done <em>by you, and immediately.</em></li>
  662. </ul>
  663. <p>Following this approach does not mean that you’ll never be overwhelmed
  664. by the amount of information that you need to process. But it’ll
  665. greatly reduce that risk.</p>
  666. <h3>“Drop” rules</h3>
  667. <p>“Dropping” things doesn’t mean ignoring them. You still have to read
  668. and understand what’s in them, and be able to find them later. So:</p>
  669. <ul>
  670. <li>
  671. <p>Never delete things (except spam).</p>
  672. </li>
  673. <li>
  674. <p>Only archive them in a way that that keeps them retrievable in the
  675. future.</p>
  676. </li>
  677. <li>
  678. <p>If there something isn’t understandable to you, think it through and
  679. look for clarification.</p>
  680. </li>
  681. </ul>
  682. <h3>“Delegate” rules</h3>
  683. <p>Delegation obviously requires that there is a person you can delegate
  684. to. This is <em>not necessarily</em> someone who reports to you; indeed, it
  685. might be someone <strong>you</strong> report to. (You might be asked to deal with
  686. something that you have no control over, but your manager does.) So:</p>
  687. <ul>
  688. <li>
  689. <p>Find the right person that can get the task done.</p>
  690. </li>
  691. <li>
  692. <p>Preemptively send them <strong>all</strong> the information that you think they
  693. might need (and that you have access to), rather than relying on
  694. them to ask.</p>
  695. </li>
  696. <li>
  697. <p>Ask them to acknowledge that they have received what they need.</p>
  698. </li>
  699. <li>
  700. <p>Make a note to follow up to see if they need anything else, and
  701. follow through by seeing the task to completion.</p>
  702. </li>
  703. </ul>
  704. <p>Within your own team, <strong>you only ever delegate tasks, not
  705. responsibility.</strong></p>
  706. <blockquote>
  707. <p>Tasks without follow-up and follow-through are a waste of people’s
  708. time.</p>
  709. </blockquote>
  710. <p>Do not delegate, or even define, tasks that you are not prepared to
  711. follow through on. If you handwave “everyone use encrypted email from
  712. now on,” and you’re not even prepared to make that work for your own
  713. email account, you might as well just leave it.</p>
  714. <p>And if you do proclaim an objective or rule and <em>then</em> you find yourself
  715. unable to see it through — <em>this happens,</em> and is no sign of
  716. ineptitude or failure — then loudly and clearly rescind it. It’s far
  717. better for you to visibly backtrack, than to be perceived as someone
  718. whose pronouncements are safe to ignore.</p>
  719. <h3>“Defer” rules</h3>
  720. <p>Deferring simply means that because something you need to do doesn’t
  721. need doing <em>immediately,</em> you can do it at a time that suits your
  722. schedule.</p>
  723. <p>This means that you’ll need to</p>
  724. <ul>
  725. <li>
  726. <p>add the task immediately to some sort of queue (for email, this can
  727. be a folder named “Needs Reply”),</p>
  728. </li>
  729. <li>
  730. <p>make sure to go through that queue at a later time to prioritize
  731. (ideally, right after you’re done with your “Do” tasks, which we’ll
  732. get to in a second),</p>
  733. </li>
  734. <li>
  735. <p>absolutely ensure that you make time to go back and actually do your
  736. prioritized tasks, at a time you consider convenient.</p>
  737. </li>
  738. </ul>
  739. <h3>“Do” rules</h3>
  740. <p>And finally, there’ll be your “Do” tasks — stuff that <em>you</em> need to
  741. do, and do immediately.</p>
  742. <ul>
  743. <li>
  744. <p>Tell people that you’re doing them, because you’ll want to be
  745. uninterrupted. Update your chat status, put some blocked time in
  746. your calendar.</p>
  747. </li>
  748. <li>
  749. <p>Make sure you’ll be uninterrupted. For email, turn off all your
  750. notifications.</p>
  751. </li>
  752. <li>
  753. <p>Plow through all the undropped, undelegated,
  754. undeferred items in your inbox until it’s empty.</p>
  755. </li>
  756. </ul>
  757. <h2>But what about the watercooler?</h2>
  758. <p>The entirety of this talk, up to this point, has focused on
  759. professional communications. And among people unfamiliar or
  760. unexperienced with work in a distributed team, it is often accepted
  761. that teams can communicate well “professionally.” </p>
  762. <p>However, they frequently ask, “what about watercooler chats? What about
  763. the many informal discussions that happen at work while people are
  764. getting some water or coffee, or sit together over lunch? There’s
  765. always so much communication happening at work that’s informal, but is
  766. extremely beneficial to everyone.”</p>
  767. <blockquote>
  768. <p>Office workers often don’t habitually externalise information. A
  769. distributed team that tries that won’t last a week.</p>
  770. </blockquote>
  771. <p>Firstly, many companies where information exchange hinges on coffee or
  772. cafeteria talk simply don’t give a damn about externalising
  773. information. Sure, if 90% of your company’s knowledge is only in
  774. people’s heads, you’re dead without the lunchroom. </p>
  775. <p>But if the same thing happens in a distributed team, it never gets off
  776. the ground. So, if you have a team that’s functional and productive,
  777. <em>because it habitually externalises information,</em> the absence of
  778. chit-chat over coffee has zero negative impact on information flow.</p>
  779. <p>However, you may also be interested in the completely non-work-related
  780. talk that happens over coffee, that simply contributes to people’s
  781. relaxation and well-being.</p>
  782. <blockquote>
  783. <p>People working in distributed teams are often introverts. Or they
  784. simply choose to have their social relationships outside of work.</p>
  785. </blockquote>
  786. <p>I know this might shock some people, but there are plenty of people
  787. who can make a terrific contribution to your company, but who dislike
  788. the “social” aspect of work. They might thrive when being left
  789. alone, with as little small-talk as possible, and ample opportunity to
  790. socialize with their friends and family, away from work.</p>
  791. <p>But if you do have people on your team that enjoy having an entirely
  792. informal conversation every once in a while, there totally is room for
  793. that even in a distributed team. All you need to do is agree on a
  794. signal that means “I’m taking a break and I’d be happy to chat with
  795. anyone who’s inclined, preferably about non work related things” (or
  796. whatever meaning your group agrees on). </p>
  797. <p>This could be</p>
  798. <ul>
  799. <li>a keyword on IRC,</li>
  800. <li>a message to a specific channel, or</li>
  801. <li>(if you want to get fancy) a bot that updates your group calendar
  802. when it receives a message with a particular format.</li>
  803. </ul>
  804. <p>However, as a word of caution, I’ve actually done this with my team
  805. before, and it didn’t catch on — for the simple reason that we almost
  806. never took breaks that happened to overlap. But that doesn’t rule out
  807. that it works on <em>your</em> team, and also there’s always the remote
  808. possibility that two or more people on your team might like to
  809. schedule their breaks concurrently.</p>
  810. <p>What you can <em>also</em> do, of course, is have a channel in which you can
  811. discuss completely random things that are not work related. And if the
  812. rule is that confidential or company-proprietary discussion topics are
  813. off-limits there, the channel might as well be public. It might even
  814. be Twitter.</p>
  815. <h2>The antithesis: ChatOps</h2>
  816. <p>I do want to mention one other thing for balance. There is a complete
  817. alternative framework for distributed teams working together, and it’s
  818. what people refer to as ChatOps.</p>
  819. <p>To the best of my knowledge, the first company to run ChatOps on a
  820. large scale <em>and talk about it publicly</em> was GitHub, <a href="https://youtu.be/NST3u-GjjFw">back in
  821. 2013</a> in a
  822. <a href="https://www.rubyfuza.org/">RubyFuza</a> talk by <a href="https://twitter.com/jnewland">Jesse
  823. Newland</a>.</p>
  824. <p>If a distributed team operates on a ChatOps basis, the interactive
  825. text chat is where absolutely everything happens. </p>
  826. <ul>
  827. <li>
  828. <p>Everyone lives in chat all the time, and all issues, alerts and events are
  829. piped into the chat.<br>
  830. Everything is discussed in the chat, and everything is also
  831. <em>resolved</em> in the chat.</p>
  832. </li>
  833. <li>
  834. <p>Such a system relies on heavy use of chat bots. For example, if an
  835. alert lands in the channel, and the discussion then yields that the
  836. proper fix to the problem is to run a specific Ansible playbook,
  837. you send an in-chat bot command that kicks off that playbook, and
  838. then reports its result.</p>
  839. </li>
  840. </ul>
  841. <p>And this is of course very laudable, because it resolves a major issue
  842. with using chat, which is the classic scenario of something being
  843. discussed in a chat, someone else then going away for a bit and then
  844. coming back saying “I fixed it!”, and nobody else actually
  845. understanding what the problem was. </p>
  846. <p>If you make everything explicit and in-band, in becomes easy, in
  847. principle, to go back to a previously-solved problem that reappears,
  848. and replay the resolution.</p>
  849. <blockquote>
  850. <p>When does ChatOps make sense? Here’s a hint: It’s called Chat<strong>Ops</strong>.</p>
  851. </blockquote>
  852. <p>So can this make sense? Yes, absolutely. Under what circumstances
  853. though? I maintain that this is best suited for when your work tends
  854. to be inherently linear with respect to some dimension. For example,
  855. if your primary job is to keep a system operational versus the linear
  856. passage of <em>time,</em> ChatOps is an excellent approach.</p>
  857. <p>And keeping complex systems operational over time is the definition
  858. of, you guessed it, ops. So ChatOps may be a very suitable
  859. communication mode for operations, but it’s highly unlikely to be
  860. efficient as a generic mode of communication across distributed teams.</p>
  861. <p>And even then I posit it’s difficult to get right, since you’ll have
  862. to curb channel sprawl and threading and other things, but’s that’s a
  863. whole ‘nother talk and indeed a talk for another <em>speaker,</em> because I
  864. don’t lead an ops team.</p>
  865. <h2>To summarize...</h2>
  866. <p>So to summarize, here are my key points from this talk, in a nutshell
  867. — please make these your key takeaways.</p>
  868. <ul>
  869. <li>Distributed teams are better than localized teams — not because
  870. they’re distributed, but because they’re asynchronous.</li>
  871. <li>Avoid anything that makes a distributed team run synchronously.</li>
  872. <li>Use less chat.</li>
  873. <li>Have fewer meetings.</li>
  874. <li><strong>Write. Things. Down.</strong></li>
  875. </ul>