{"id":372,"date":"2021-07-06T17:02:20","date_gmt":"2021-07-06T21:02:20","guid":{"rendered":"https:\/\/redmonk.com\/kfitzpatrick\/?p=372"},"modified":"2021-07-06T17:02:20","modified_gmt":"2021-07-06T21:02:20","slug":"three-more-conversations-about-tech-writing","status":"publish","type":"post","link":"https:\/\/redmonk.com\/kfitzpatrick\/2021\/07\/06\/three-more-conversations-about-tech-writing\/","title":{"rendered":"Three (more) conversations about tech writing"},"content":{"rendered":"<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-large wp-image-373\" src=\"http:\/\/redmonk.com\/kfitzpatrick\/files\/2021\/07\/Green-and-blue-lights-scaled-e1625515716757-1024x604.jpg\" alt=\"photo of strings of decorative green and blue lights\" width=\"1024\" height=\"604\" srcset=\"https:\/\/redmonk.com\/kfitzpatrick\/files\/2021\/07\/Green-and-blue-lights-scaled-e1625515716757-1024x604.jpg 1024w, https:\/\/redmonk.com\/kfitzpatrick\/files\/2021\/07\/Green-and-blue-lights-scaled-e1625515716757-300x177.jpg 300w, https:\/\/redmonk.com\/kfitzpatrick\/files\/2021\/07\/Green-and-blue-lights-scaled-e1625515716757-768x453.jpg 768w, https:\/\/redmonk.com\/kfitzpatrick\/files\/2021\/07\/Green-and-blue-lights-scaled-e1625515716757-1536x906.jpg 1536w, https:\/\/redmonk.com\/kfitzpatrick\/files\/2021\/07\/Green-and-blue-lights-scaled-e1625515716757-2048x1208.jpg 2048w, https:\/\/redmonk.com\/kfitzpatrick\/files\/2021\/07\/Green-and-blue-lights-scaled-e1625515716757-480x283.jpg 480w, https:\/\/redmonk.com\/kfitzpatrick\/files\/2021\/07\/Green-and-blue-lights-scaled-e1625515716757-1063x627.jpg 1063w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<p>A few weeks ago I had the chance to sit down with Andy Stevens, Technical Content Manager at Linode, to film a <a href=\"https:\/\/redmonk.com\/?series=conversations\">RedMonk Conversation<\/a> video on <a href=\"https:\/\/redmonk.com\/kfitzpatrick\/2021\/06\/30\/documenting-the-alternative-cloud-a-conversation-with-linode\/\">Documenting the Alternative Cloud<\/a>. If you are interested in tech comm and\/or documentation, I recommend checking out that video (and\/or its <a href=\"https:\/\/redmonk.com\/videos\/documenting-the-alternative-cloud\/\">transcript<\/a>), where we cover topics like docs-as-code, documentation sprawl, and tips for delivering better technical documentation.<\/p>\n<p>During our conversation, however, Andy and I covered so many tech writing topics that we ended up with some additional segments that might prove useful to anyone hiring, managing, or considering finding a gig as a technical writer or documentarian. You can find these excerpts (and links to their transcripts) below. They are ordered according to where they fell in our initial conversation, but can be viewed individually or in any order.<\/p>\n<h1>Organizing the Docs Team at Linode<\/h1>\n<p>A discussion of the organization and responsibilities of the six-person docs team at Linode (including the types of documentation it produces), where the team is located in the larger org structure, and some of the professional backgrounds of team members.<\/p>\n<p>Read the transcript of this video <a href=\"https:\/\/redmonk.com\/videos\/organizing-the-docs-team-at-linode\">here<\/a>.<\/p>\n<p><span class=\"embed-youtube\" style=\"text-align:center; display: block;\"><iframe class='youtube-player' width='640' height='360' src='https:\/\/www.youtube.com\/embed\/mFN1lYQ7M4M?version=3&#038;rel=1&#038;showsearch=0&#038;showinfo=1&#038;iv_load_policy=1&#038;fs=1&#038;hl=en-US&#038;autohide=2&#038;wmode=transparent' allowfullscreen='true' style='border:0;' sandbox='allow-scripts allow-same-origin allow-popups allow-presentation'><\/iframe><\/span><\/p>\n<h1>A Typical Day for a Tech Writer at Linode<\/h1>\n<p>Find out what a typical day looks like for a tech writer at Linode, and how team processes have evolved over time (hint: they now do documentation releases on Fridays).<\/p>\n<p>Read the transcript of this video <a href=\"https:\/\/redmonk.com\/videos\/a-typical-day-for-a-tech-writer-at-linode\">here<\/a>.<\/p>\n<p><span class=\"embed-youtube\" style=\"text-align:center; display: block;\"><iframe class='youtube-player' width='640' height='360' src='https:\/\/www.youtube.com\/embed\/3B-C_3dU6-s?version=3&#038;rel=1&#038;showsearch=0&#038;showinfo=1&#038;iv_load_policy=1&#038;fs=1&#038;hl=en-US&#038;autohide=2&#038;wmode=transparent' allowfullscreen='true' style='border:0;' sandbox='allow-scripts allow-same-origin allow-popups allow-presentation'><\/iframe><\/span><\/p>\n<h1>Hiring and Tech Writers<\/h1>\n<p>Andy shares tips for hiring technical writers and (conversely) for finding a job in a tech writing\/tech comm field.<\/p>\n<p>Read the transcript of this video <a href=\"https:\/\/redmonk.com\/videos\/hiring-and-tech-writers\">here<\/a>.<\/p>\n<p><span class=\"embed-youtube\" style=\"text-align:center; display: block;\"><iframe class='youtube-player' width='640' height='360' src='https:\/\/www.youtube.com\/embed\/RRxpGvwHt0A?version=3&#038;rel=1&#038;showsearch=0&#038;showinfo=1&#038;iv_load_policy=1&#038;fs=1&#038;hl=en-US&#038;autohide=2&#038;wmode=transparent' allowfullscreen='true' style='border:0;' sandbox='allow-scripts allow-same-origin allow-popups allow-presentation'><\/iframe><\/span><\/p>\n<p>&nbsp;<\/p>\n<p><strong>Disclosure<\/strong>: Linode is a RedMonk client; however, this post and the cited videos are independent pieces of work and were not commissioned by any entity.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>A few weeks ago I had the chance to sit down with Andy Stevens, Technical Content Manager at Linode, to film a RedMonk Conversation video on Documenting the Alternative Cloud. If you are interested in tech comm and\/or documentation, I recommend checking out that video (and\/or its transcript), where we cover topics like docs-as-code, documentation<\/p>\n","protected":false},"author":47,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"spay_email":"","footnotes":"","jetpack_publicize_message":"","jetpack_is_tweetstorm":false},"categories":[23,4,83],"tags":[44,86,85,5,9],"class_list":["post-372","post","type-post","status-publish","format-standard","hentry","category-interview","category-tech-comm","category-video-recap","tag-documentation","tag-hiring","tag-linode","tag-tech-comm","tag-technical-communication"],"jetpack_featured_media_url":"","jetpack_publicize_connections":[],"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/redmonk.com\/kfitzpatrick\/wp-json\/wp\/v2\/posts\/372","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/redmonk.com\/kfitzpatrick\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/redmonk.com\/kfitzpatrick\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/redmonk.com\/kfitzpatrick\/wp-json\/wp\/v2\/users\/47"}],"replies":[{"embeddable":true,"href":"https:\/\/redmonk.com\/kfitzpatrick\/wp-json\/wp\/v2\/comments?post=372"}],"version-history":[{"count":0,"href":"https:\/\/redmonk.com\/kfitzpatrick\/wp-json\/wp\/v2\/posts\/372\/revisions"}],"wp:attachment":[{"href":"https:\/\/redmonk.com\/kfitzpatrick\/wp-json\/wp\/v2\/media?parent=372"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/redmonk.com\/kfitzpatrick\/wp-json\/wp\/v2\/categories?post=372"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/redmonk.com\/kfitzpatrick\/wp-json\/wp\/v2\/tags?post=372"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}