{"id":1588,"date":"2024-03-25T18:02:48","date_gmt":"2024-03-25T18:02:48","guid":{"rendered":"https:\/\/woohoostudio.com\/?p=1588"},"modified":"2024-03-26T13:37:23","modified_gmt":"2024-03-26T13:37:23","slug":"what-does-a-technical-writer-do","status":"publish","type":"post","link":"https:\/\/woohoostudio.com\/es\/what-does-a-technical-writer-do\/","title":{"rendered":"What does a technical writer do?"},"content":{"rendered":"<p><span style=\"font-weight: 400;\">What a technical writer actually writes about really depends on the products and services they are hired to describe, but usually the list includes more than just user manuals. Technical documents they must produce can include:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">User manuals for end-users<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">User and maintenance manuals for technicians<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Manufacturing documents &#8211; Standard Operating Procedures, safety data sheets, quality standards and procedures<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Scientific documents &#8211; research papers, grant proposals and lab reports<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Software documents &#8211; API specifications, software specifications, cybersecurity specifications, release notes<\/span><\/li>\n<\/ul>\n<p><img loading=\"lazy\" decoding=\"async\" id=\"longdesc-return-1599\" class=\"alignleft wp-image-1599 size-medium\" tabindex=\"-1\" src=\"https:\/\/woohoostudio.com\/wp-content\/uploads\/2024\/03\/computersme-1-300x201.jpg\" alt=\"computer technician\" width=\"300\" height=\"201\" longdesc=\"https:\/\/woohoostudio.com?longdesc=1599&amp;referrer=1588\" srcset=\"https:\/\/woohoostudio.com\/wp-content\/uploads\/2024\/03\/computersme-1-300x201.jpg 300w, https:\/\/woohoostudio.com\/wp-content\/uploads\/2024\/03\/computersme-1-18x12.jpg 18w, https:\/\/woohoostudio.com\/wp-content\/uploads\/2024\/03\/computersme-1-480x321.jpg 480w, https:\/\/woohoostudio.com\/wp-content\/uploads\/2024\/03\/computersme-1.jpg 598w\" sizes=\"auto, (max-width: 300px) 100vw, 300px\" \/><\/p>\n<p><span style=\"font-weight: 400;\">When I first started as a technical writer, I did not know what it was. I was hired to write because I am also a translator, and the company\u2019s recruiters assumed (rightly) that I could write coherent, grammatically-correct documents. But people can be hired from different backgrounds: Quality assurance folks, programmers, scientists, clerks, journalists, or even students straight out of college. Depending on the industry and subject matter, companies who hire writers may have more specialized requirements:<\/span><\/p>\n<p>&nbsp;<\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Software companies &#8211; may require fluency in certain programming languages, development lifecycles, UX\/UI competencies<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Manufacturing &#8211; quality control and safety methods, regulatory compliance requirements<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Sciences &#8211; expertise and knowledge in their particular area, research methodologies, ethical and legal standards<\/span><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">More importantly, a good technical writer has certain soft skills that sometimes cannot be learned in school or over a few months of training.<img loading=\"lazy\" decoding=\"async\" id=\"longdesc-return-1598\" class=\"alignright wp-image-1598 size-full\" tabindex=\"-1\" src=\"https:\/\/woohoostudio.com\/wp-content\/uploads\/2024\/03\/qatechnician-1.jpg\" alt=\"QA technician talking to technical writer\" width=\"940\" height=\"630\" longdesc=\"https:\/\/woohoostudio.com?longdesc=1598&amp;referrer=1588\" srcset=\"https:\/\/woohoostudio.com\/wp-content\/uploads\/2024\/03\/qatechnician-1.jpg 940w, https:\/\/woohoostudio.com\/wp-content\/uploads\/2024\/03\/qatechnician-1-300x201.jpg 300w, https:\/\/woohoostudio.com\/wp-content\/uploads\/2024\/03\/qatechnician-1-768x515.jpg 768w, https:\/\/woohoostudio.com\/wp-content\/uploads\/2024\/03\/qatechnician-1-18x12.jpg 18w, https:\/\/woohoostudio.com\/wp-content\/uploads\/2024\/03\/qatechnician-1-480x322.jpg 480w\" sizes=\"auto, (max-width: 940px) 100vw, 940px\" \/> <\/span><\/p>\n<p><span style=\"font-weight: 400;\">On a day-to-day basis a technical writer needs to:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Talk to Subject Matter Experts (SMEs) to get current, accurate and detailed information &#8211; this requires being able to listen carefully, empathy, and curiosity for asking the right questions.<\/span><\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Collaborate with different departments &#8211; besides empathy, it takes teamwork and dedication as a team to ensure the end product and its documentation are of the best quality.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Write in language that is easy for the audience to understand &#8211; user manuals for non-technical readers needs to be in 8th grade English (for the U.S.), whereas technical manuals need to be coherent for the technicians who are analyzing or installing equipment. For this, empathy and common sense is important.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Grammatically correct documentation &#8211; yes, you could use Grammarly or other services, but those tools are not 100% accurate, and they might not understand the context. There is no substitute for really understanding your subject as a writer.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Use documentation tools effectively &#8211; As a technical writer, you can\u2019t be a technophobe. Instead you need to embrace new technology and tools that can facilitate the documentation process, such as reusing information for many documents, getting peer\/SME reviews and approvals, and other efficiencies. An open mind and curiosity to try new tools and methods always helps a writer and the rest of the team to make great documents.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Work on your own &#8211; Once you have all the information you&#8217;ve gathered from SME&#8217;s and your teams, you must be self-motivated to produce high quality work, as well as organized and emotionally able to handle tight deadlines.<\/span><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Technical writing is a fascinating career, if you like to learn new things and write. It can also be a great career for an introvert who likes to work in small teams, because once you get information from SME\u2019s and understand the product\/service, you spend a lot of time writing on your own. If you have the soft skills listed here, you can be successful.<\/span><\/p>","protected":false},"excerpt":{"rendered":"<p>What a technical writer actually writes about really depends on the products and services they are hired to describe, but usually the list includes more than just user manuals. More importantly, a good technical writer has certain soft skills that sometimes cannot be learned in school or over a few months of training.<\/p>","protected":false},"author":1,"featured_media":1590,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"_kad_post_classname":"","footnotes":""},"categories":[6,64],"tags":[],"class_list":["post-1588","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-articles","category-services"],"_links":{"self":[{"href":"https:\/\/woohoostudio.com\/es\/wp-json\/wp\/v2\/posts\/1588","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/woohoostudio.com\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/woohoostudio.com\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/woohoostudio.com\/es\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/woohoostudio.com\/es\/wp-json\/wp\/v2\/comments?post=1588"}],"version-history":[{"count":3,"href":"https:\/\/woohoostudio.com\/es\/wp-json\/wp\/v2\/posts\/1588\/revisions"}],"predecessor-version":[{"id":1600,"href":"https:\/\/woohoostudio.com\/es\/wp-json\/wp\/v2\/posts\/1588\/revisions\/1600"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/woohoostudio.com\/es\/wp-json\/wp\/v2\/media\/1590"}],"wp:attachment":[{"href":"https:\/\/woohoostudio.com\/es\/wp-json\/wp\/v2\/media?parent=1588"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/woohoostudio.com\/es\/wp-json\/wp\/v2\/categories?post=1588"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/woohoostudio.com\/es\/wp-json\/wp\/v2\/tags?post=1588"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}