{"id":381,"date":"2021-07-11T14:01:04","date_gmt":"2021-07-11T18:01:04","guid":{"rendered":"https:\/\/redmonk.com\/kfitzpatrick\/?p=381"},"modified":"2021-08-17T10:54:04","modified_gmt":"2021-08-17T14:54:04","slug":"so-you-want-to-hire-and-retain-a-tech-writer-takeaways-from-the-2020-write-the-docs-salary-survey","status":"publish","type":"post","link":"https:\/\/redmonk.com\/kfitzpatrick\/2021\/07\/11\/so-you-want-to-hire-and-retain-a-tech-writer-takeaways-from-the-2020-write-the-docs-salary-survey\/","title":{"rendered":"So you want to hire (and retain) a tech writer? Takeaways from the 2020 Write the Docs Salary Survey"},"content":{"rendered":"<p>Recently social media has generated a number of excellent takes on the importance of good technical documentation. First, there\u2019s the (spot-on) argument that documentation should be considered part of the product.<\/p>\n<blockquote class=\"twitter-tweet\" data-width=\"500\" data-dnt=\"true\">\n<p lang=\"en\" dir=\"ltr\"><a href=\"https:\/\/twitter.com\/hashtag\/WriteTheDocs?src=hash&amp;ref_src=twsrc%5Etfw\">#WriteTheDocs<\/a>. Docs are part of the product.<\/p>\n<p>&mdash; Carolyn Shannon (@chicagomom) <a href=\"https:\/\/twitter.com\/chicagomom\/status\/1406695727716208640?ref_src=twsrc%5Etfw\">June 20, 2021<\/a><\/p><\/blockquote>\n<p><script async src=\"https:\/\/platform.twitter.com\/widgets.js\" charset=\"utf-8\"><\/script><\/p>\n<p>And then there\u2019s the phrase \u201cDocs or it didn\u2019t happen.\u201d<\/p>\n<blockquote class=\"twitter-tweet\" data-width=\"500\" data-dnt=\"true\">\n<p lang=\"en\" dir=\"ltr\">Docs or it didn&#39;t happen. <\/p>\n<p>Docs or people will end up wasting countless hours of their lives to figure out some triviality and hate your product for it.<\/p>\n<p>Docs or you don&#39;t ship it.<a href=\"https:\/\/twitter.com\/hashtag\/writethedocs?src=hash&amp;ref_src=twsrc%5Etfw\">#writethedocs<\/a> <a href=\"https:\/\/twitter.com\/hashtag\/techcomm?src=hash&amp;ref_src=twsrc%5Etfw\">#techcomm<\/a> <a href=\"https:\/\/t.co\/p3pz1UJWFJ\">https:\/\/t.co\/p3pz1UJWFJ<\/a><\/p>\n<p>&mdash; Troy Howard, in Solidarity\ud83d\udc99 \ud83c\uddfa\ud83c\udde6 (@thoward37) <a href=\"https:\/\/twitter.com\/thoward37\/status\/1404567431243210759?ref_src=twsrc%5Etfw\">June 14, 2021<\/a><\/p><\/blockquote>\n<p><script async src=\"https:\/\/platform.twitter.com\/widgets.js\" charset=\"utf-8\"><\/script><\/p>\n<p>And on to my favorite, courtesy of <a href=\"https:\/\/twitter.com\/bjohnso5y\">Brigid Johnson<\/a> at AWS: \u201cDocs are like gold.\u201d<\/p>\n<blockquote class=\"twitter-tweet\" data-width=\"500\" data-dnt=\"true\">\n<p lang=\"en\" dir=\"ltr\">Overheard in AWS &#8211; &quot;docs are like gold&quot; <a href=\"https:\/\/t.co\/TSrbsxswhu\">pic.twitter.com\/TSrbsxswhu<\/a><\/p>\n<p>&mdash; Brigid Johnson (@bjohnso5y) <a href=\"https:\/\/twitter.com\/bjohnso5y\/status\/1405260293786062848?ref_src=twsrc%5Etfw\">June 16, 2021<\/a><\/p><\/blockquote>\n<p><script async src=\"https:\/\/platform.twitter.com\/widgets.js\" charset=\"utf-8\"><\/script><\/p>\n<p>On a related note, we\u2019ve also seen a lot of companies&#8211;especially those that are engineering-centric companies like Spotify, and\/or companies that produce tech used to build other tech&#8211; looking to hire roles related to technical writing and documentation. Just to name a few (with the caveat that job posting links are ephemeral):<\/p>\n<ul>\n<li>GitHub is looking to fill positions such as <a href=\"https:\/\/boards.greenhouse.io\/github\/jobs\/2955642\">Senior Software Engineer<\/a> for its Octoservices team, which handles \u201cthe full stack of features and technologies that power Admin Experiences, Audit Logs, Migration, Learning Lab, Docs, and more tools and services that enable our millions of customers to use GitHub, increasing the impact of software solutions at a global scale.\u201d<\/li>\n<li>Google not only appears to be perpetually hiring tech writers, but also has a nice <a href=\"https:\/\/developers.google.com\/tech-writing\/becoming\">set of instructions<\/a> on how to become one.<\/li>\n<li>HashiCorp is hiring a  <a href=\"https:\/\/www.hashicorp.com\/job\/3196118\">Technical Product Manager, Practitioner Experience<\/a>, where a successful hire will \u201cDrive the development of a meaningful and intuitive practitioner experience across our project websites and documentation sites, focusing on our audiences that include developers, operators, systems administrators, etc.\u201d (n.b., I love the term \u201cpractitioner experience\u201d here).<\/li>\n<li>Red Hat is looking for tech writers for everything from <a href=\"https:\/\/global-redhat.icims.com\/jobs\/87646\/senior-technical-writer---middleware-runtimes\/job\">Middleware Runtimes<\/a> to <a href=\"https:\/\/global-redhat.icims.com\/jobs\/87783\/technical-writer---managed-services\/job\">Managed Services<\/a>.<\/li>\n<li>Spotify is looking for a  <a href=\"https:\/\/www.lifeatspotify.com\/jobs\/ux-writer-design-platform\">UX Writer<\/a> for its Platform team \u201cto create and maintain unified design language standards, guidelines, and other resources required for a cohesive and scalable user experience across mobile, speakers, and other devices.\u201d <\/li>\n<li>Twilio\u2014a company that RedMonk often cites for its exemplary technical documentation\u2014is looking for writing-based roles including <a href=\"https:\/\/boards.greenhouse.io\/twilio\/jobs\/3165642\">Content designer<\/a> and <a href=\"https:\/\/boards.greenhouse.io\/twilio\/jobs\/3187685\">Staff technical writers<\/a>, the latter of which is introduced as:<\/li>\n<\/ul>\n<blockquote><p>\n  The person in this role will assist in all aspects related to internal documentation, from the research and strategy phase to execution to ongoing maintenance of our supporting processes and docs.<\/p>\n<p>  Responsibilities can include anything from assisting in user research interviews to helping research content management solutions, but the daily tasks will relate to delivering internal documentation to support the R&amp;D department. This position is for an individual who can comfortably tackle long-term, complex technical writing projects in a self-directed manner. You should be as skilled at collaborating closely with SMEs and obtaining key information as you are with efficiently compiling that information and translating it into a language and format tailored to your specific audience(s). Reporting to the R&amp;D Enablement team, this position plays a key role in building Twilio\u2019s internal knowledge base.\n<\/p><\/blockquote>\n<p>And this is just a tiny sampling.<\/p>\n<p>For folks who understand the value of great documentation and the people who produce it, and who are looking to invest in hiring and retaining tech writing talent, I suggest taking a look at the recently published results of the <a href=\"https:\/\/www.writethedocs.org\/surveys\/salary-survey\/2020\/\">2020 Write the Docs Salary Survey<\/a>.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"http:\/\/redmonk.com\/kfitzpatrick\/files\/2021\/07\/WtD-Salary-Survey-2020-ToC.jpg\" alt=\"Screenshot of the top part of the table of contents for the Write the Docs Salary Survey 2020.\" width=\"994\" height=\"489\" class=\"aligncenter size-full wp-image-380\" srcset=\"https:\/\/redmonk.com\/kfitzpatrick\/files\/2021\/07\/WtD-Salary-Survey-2020-ToC.jpg 994w, https:\/\/redmonk.com\/kfitzpatrick\/files\/2021\/07\/WtD-Salary-Survey-2020-ToC-300x148.jpg 300w, https:\/\/redmonk.com\/kfitzpatrick\/files\/2021\/07\/WtD-Salary-Survey-2020-ToC-768x378.jpg 768w, https:\/\/redmonk.com\/kfitzpatrick\/files\/2021\/07\/WtD-Salary-Survey-2020-ToC-480x236.jpg 480w\" sizes=\"auto, (max-width: 994px) 100vw, 994px\" \/><\/p>\n<p><a href=\"https:\/\/www.writethedocs.org\/\">Write the Docs<\/a> (WTD) describes itself as \u201ca global community of people who care about documentation.\u201d In addition to salary surveys, the group&#8211;which does not charge a membership fee&#8211;organizes conferences, meetups, a Slack workspace, and a <a href=\"https:\/\/jobs.writethedocs.org\/\">jobs board<\/a>. WTD states the purpose of the <a href=\"https:\/\/www.writethedocs.org\/surveys\/salary-survey-sep-2020\/\">2020 Salary Survey<\/a> as follows:<\/p>\n<blockquote><p>\n  Our goal is to help people understand the pay scales and benefits in the software industry around documentation. This will help people get a better understanding of what an appropriate salary is, and then negotiate for a better one.\n<\/p><\/blockquote>\n<p>In publishing the 2020 Salary Survey results last month the group further noted that<\/p>\n<blockquote><p>\n  We loved seeing our community use the previous results to set expectations for wages, benefits, and overall relationship with work.\n<\/p><\/blockquote>\n<blockquote class=\"twitter-tweet\" data-width=\"500\" data-dnt=\"true\">\n<p lang=\"en\" dir=\"ltr\">We&#39;re excited (and a bit relieved) to share our 2020 Salary Survey results. We loved seeing our community use the previous results to set expectations for wages, benefits, and overall relationship with work. \ud83d\udc93<a href=\"https:\/\/t.co\/zBjm7U2SlJ\">https:\/\/t.co\/zBjm7U2SlJ<\/a> <a href=\"https:\/\/t.co\/bv5h7Nj50S\">pic.twitter.com\/bv5h7Nj50S<\/a><\/p>\n<p>&mdash; Write the Docs (@writethedocs) <a href=\"https:\/\/twitter.com\/writethedocs\/status\/1404883367301206029?ref_src=twsrc%5Etfw\">June 15, 2021<\/a><\/p><\/blockquote>\n<p><script async src=\"https:\/\/platform.twitter.com\/widgets.js\" charset=\"utf-8\"><\/script><\/p>\n<p>2020 is only the second year that WTD has conducted its salary survey after running its first in <a href=\"https:\/\/www.writethedocs.org\/surveys\/salary-survey\/2019\/\">2019<\/a>. While this means that the salary data is not as long-ranging as, say, the <a href=\"https:\/\/www.stc.org\/publications\/salary-database\/\">salary database<\/a> available through the <a href=\"https:\/\/www.stc.org\/\">Society for Technical Communication<\/a> (STC), the advantages of the WTD survey for teams looking to hire a tech writer (especially in software-related industries) are as follows:<\/p>\n<ul>\n<li>WTD survey results are freely and publicly available (where as the STC database is available to paid members or for an access fee).<\/li>\n<li>The WTD community (and the majority of <a href=\"https:\/\/www.writethedocs.org\/surveys\/salary-survey\/2020\/#industry\">survey respondents<\/a>) skews toward practitioners focused on software development and technology-related fields.<\/li>\n<li>Based on the changes between the 2019 and 2020 surveys, WTD sees the survey per se as a work in progress, adapting to meet community suggestions and world events (such as the COVID-19 pandemic).<\/li>\n<\/ul>\n<p>While I invite you to check out the full <a href=\"https:\/\/www.writethedocs.org\/surveys\/salary-survey\/2020\/\">WTD Salary Survey 2020 results<\/a> for yourself, I also offer the following as my top takeaways for folks looking to hire for tech writing related roles.<\/p>\n<h1>Not all folks who produce docs have tech writer titles<\/h1>\n<p>As noted in the sampling of job postings I list above, not all positions centered on producing documentation and other forms of technical communication (e.g., UX copy, knowledge bases, style guides) have \u201ctech writer\u201d in the title. One of the things that I love about the WTD community is that they embrace the term \u201cdocumentarians\u201d as a way to include practitioners who contribute to documentation but who may hold other job titles. And while survey results indicate that many respondents do have some form of \u201ctech writer\u201d in their official job titles, the variety of <a href=\"https:\/\/www.writethedocs.org\/surveys\/salary-survey\/2020\/#job-title\">Job Title<\/a> responses submitted offers insight into the different titles used. This variety can prove useful when articulating specific job postings and positions, but also in understanding the backgrounds of potential candidates.<\/p>\n<p>Also of interest: responses to the <a href=\"https:\/\/www.writethedocs.org\/surveys\/salary-survey\/2020\/#type-of-role\">Type of Role<\/a> questions, which break out how respondents see themselves functioning within their organization. While the majority of respondents went with the \u201cwriter, content creator, producer, or editor\u201d option, other responses included \u201cmanager,\u201d \u201cdeveloper,\u201d \u201ceducator,\u201d and \u201cadvocate.\u201d<\/p>\n<h1>Tech writers\/documentarians do more than \u201cwordsmith\u201d<\/h1>\n<p>One of the more interesting sections of the survey juxtaposes responses for <a href=\"https:\/\/www.writethedocs.org\/surveys\/salary-survey\/2020\/#proportion-of-role-officially-related-to-documentation\">Proportion of role officially related to documentation<\/a> to those for <a href=\"https:\/\/www.writethedocs.org\/surveys\/salary-survey\/2020\/#proportion-of-role-actually-related-to-documentation\">Proportion of role actually related to documentation<\/a>. There is a lot to glean from this regarding roles where folks take on documentation tasks unofficially (and I have certainly been there), as well as the potential disconnect between time expected to be dedicated to documentation and time that actually is. Part of this, of course, may simply be the usual workplace overhead that many of us experience: time answering email, sitting in meetings, or trying to get our various video conferencing software to work. And yet, I suspect this may also result from varying definitions of what counts as a \u201cdocumentation-related\u201d task.<\/p>\n<p>Writing, for instance, is often recognized as the most clear-cut documentation-related task. However, as noted in the sampling of job postings listed above, tech writing\/documentarian positions often go beyond simply <em>writing<\/em> documentation, including tasks such as user research, collaborating with SMEs, establishing user pathways among existing collateral, and even establishing documentation pipelines.<\/p>\n<p>Even within the task of writing, the skill of being able to string words together per se is not enough to ensure the production of great technical documentation. A few weeks ago I chatted with Andy Stevens, Technical Content Manager at Linode, about his advice on <a href=\"https:\/\/redmonk.com\/videos\/hiring-and-tech-writers\/\">Hiring and Tech writers<\/a>. One of his key suggestions:<\/p>\n<blockquote><p>\n  I think if you\u2019re looking to hire a technical writer, I think one of the biggest challenges is finding someone who brings something more than just writing proficiency to the job.\n<\/p><\/blockquote>\n<p>Other key components we discussed as <a href=\"https:\/\/redmonk.com\/kfitzpatrick\/2021\/06\/30\/documenting-the-alternative-cloud-a-conversation-with-linode\/\">essential to great documentation<\/a> include empathy and attention to the audience. However, it also became clear that as documentation processes evolve to align with those used in software development per se, documentarians are also expected to understand things like git, docs-as-code systems, automated testing tools, and static site generators.<\/p>\n<p>In other words, when creating and hiring for a tech writing role, it is important to understand and seek out all of the skills that go into producing and maintaining great documentation. And while writing skills are important, the work of creating documentation should never be reduced to  <em>just<\/em> writing (or, as a former colleague would call it when they really wanted to frame the technical writing I did as completely devoid of any actual technical component, \u201cjust wordsmithing\u201d).<\/p>\n<h1>Pay your tech writers\/documentarians well<\/h1>\n<p>The <a href=\"https:\/\/www.writethedocs.org\/surveys\/salary-survey\/2020\/#section-3-salary-information\">Salary<\/a> section of the survey provides regionally-specific median salary information for respondents. Given the pool size, this may be an area where other surveys and hiring tools prove more useful in gauging salary range. However, this section also provides information on other benefits, as well as various <a href=\"https:\/\/www.writethedocs.org\/surveys\/salary-survey\/2020\/#salary-satisfaction-employees\">salary and job satisfaction information<\/a> (I suggest that you get familiar with this section, because we are going to comb through it for the next few takeaways).<\/p>\n<p>Among respondents who were not satisfied with their salary, the #1 reason given was \u201csalary is too low\u201d; it is also worth noting that among respondents who noted that they were not satisfied with their job (vs. with their salary), the #1 reason given was \u201cRole is undervalued or underfunded.&#8221; I would love to see a separation between \u201cundervalued\u201d and \u201cunderfunded\u201d in the potential survey response options (and per my takeaways list, I have clearly separated the two, even though they are arguably related). But here the point I want to stress is that it takes a lot of skills to produce great documentation, employers should expect to pay for those skills accordingly, but not all employers do. Often this results in tech writers\/documentarians changing employers in order to access the compensation and benefits that are commensurate with their skills (and those required of their job); others opt for moving into other parts of an organization, often into more engineering-based roles that make use of some of the SME knowledge they have acquired while documenting all the things.<\/p>\n<p>One way to prevent this churn: pay your tech writers\/documentarians what they are worth. And then pay them more to make up for the fact that your org may be one among many that undervalues their worth.<\/p>\n<h1>Value your tech writers\/documentarians (and hire more of them)<\/h1>\n<p>Returning to the # 1 reason cited for job dissatisfaction among respondents: \u201cRole is undervalued or underfunded,\u201d I\u2019d like to focus on the undervalued part. While recognition of value is often tied to salary, it can also manifest in other areas: reasonable promotion paths (also an issue noted in survey responses), recognition of the work itself as valuable, recognition of expertise per se as valuable. If you have nine levels of job titles and a plethora of internal recognition mechanisms for software engineers but zero advancement paths or accolades for the folks who specialize in creating your documentation, it may be difficult to keep any tech writers\/documentarians you do hire.<\/p>\n<p>Another related way to recognize value (that perhaps gets at the intersection of respondents feeling undervalued and underfunded): appropriate funding for the work required. This can manifest as funding for tools and training (and \u201coutdated toolsets\u201d is another reason cited for job dissatisfaction in the survey), hours allocated to actual documentation projects, and headcount devoted to actual documentation tasks and the gluework that often goes with them.<\/p>\n<p>The headcount part can be especially telling (and while the survey does ask whether respondents work solo or on (a) team(s), teams mean only that they work with other colleagues, not that those colleagues are necessarily also working on documentation). Often teams or organizations will budget to hire one tech writer when the work expected is more than three could reasonably accomplish. Documentarians who have found themselves in such a situation can be wary of joining teams or organizations where they are the only tech writer, or where tech writing is a casual \u201cadd on\u201d to another role. If all the public facing documentation for your organization is generated by a single QA analyst in the \u201cspare\u201d time created via a 100-hour work week, folks may conclude that your org does not value documentation or documentarians (and fixing that will probably take more than one tech writer\/documentarian hire).<\/p>\n<p>Conversely, willingness to invest in multiple documentation roles can be read not only as dedication to great documentation, but also as a larger organizational recognition of value in tech writers and their expertise. (Side note: it also creates potential collaboration and mentoring opportunities, which makes hiring and nurturing less experienced applicants a more feasible option). And so one way to hire (and retain) better tech writers may be to prioritize hiring more of them.<\/p>\n<h1>The TL;DR<\/h1>\n<p>Consider the <a href=\"https:\/\/www.writethedocs.org\/surveys\/salary-survey\/2020\/\">2020 WTD Salary Survey<\/a> results as only one of the tools\/points of information available to anyone looking to hire a tech writer, but one that has a very precise respondent base and is reactive to evolving industry conditions. And while the survey is positioned primarily to help documentarians better understand and negotiate salary and working conditions, it also has a lot to tell us about how employers can shape job postings and actual tech writing-related positions to attract and retain tech writing talent.<\/p>\n<p>Or, if you want an even more summative and succinct directive, I offer this take from the excellent <a href=\"https:\/\/twitter.com\/radiomorillo\">Stephanie Morillo<\/a>:<br \/>\nhttps:\/\/twitter.com\/radiomorillo\/status\/1357465235603529737<\/p>\n<p><\/br><\/p>\n<p><strong>Disclosure<\/strong>: AWS, GitHub, Google Cloud, HashiCorp, Red Hat, and Twilio are RedMonk clients.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Recently social media has generated a number of excellent takes on the importance of good technical documentation. First, there\u2019s the (spot-on) argument that documentation should be considered part of the product. #WriteTheDocs. Docs are part of the product. &mdash; Carolyn Shannon (@chicagomom) June 20, 2021 And then there\u2019s the phrase \u201cDocs or it didn\u2019t happen.\u201d<\/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":[4],"tags":[44,86,5,89,64],"class_list":["post-381","post","type-post","status-publish","format-standard","hentry","category-tech-comm","tag-documentation","tag-hiring","tag-tech-comm","tag-tech-writing","tag-write-the-docs"],"jetpack_featured_media_url":"","jetpack_publicize_connections":[],"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/redmonk.com\/kfitzpatrick\/wp-json\/wp\/v2\/posts\/381","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=381"}],"version-history":[{"count":0,"href":"https:\/\/redmonk.com\/kfitzpatrick\/wp-json\/wp\/v2\/posts\/381\/revisions"}],"wp:attachment":[{"href":"https:\/\/redmonk.com\/kfitzpatrick\/wp-json\/wp\/v2\/media?parent=381"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/redmonk.com\/kfitzpatrick\/wp-json\/wp\/v2\/categories?post=381"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/redmonk.com\/kfitzpatrick\/wp-json\/wp\/v2\/tags?post=381"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}