{"id":6818,"date":"2022-10-03T13:42:11","date_gmt":"2022-10-03T08:12:11","guid":{"rendered":"https:\/\/razorpay.com\/learn\/?p=6818"},"modified":"2022-10-04T14:56:19","modified_gmt":"2022-10-04T09:26:19","slug":"tech-writer-as-a-job-role","status":"publish","type":"post","link":"https:\/\/razorpay.com\/learn\/tech-writer-as-a-job-role\/","title":{"rendered":"Technical Writer as a Job Role"},"content":{"rendered":"<p><span style=\"font-weight: 400;\">Are you a Tech Writer, and upon declaring your profession, receive confused reactions from people? Well, you are not alone! Strangely enough, many do not know about Tech Writers and what they do. This blog is to clear the air and help people understand the job role of a Technical Writer in detail.\u00a0<\/span><\/p>\n<p><span style=\"font-weight: 400;\">\u00a0A Tech Writer has to don several hats, which is why perhaps Tech Writers are also called Technical Authors, Technical Communicators, Information Developers, and Technical Documentors. <\/span><\/p>\n<p><span style=\"font-weight: 400;\">Listed below are some of the contributions Tech Writers make to an organisation.<\/span><\/p>\n<h2><span style=\"font-weight: 400;\">Tech Writers as Content Curators<\/span><\/h2>\n<p><em><span style=\"font-weight: 400;\">Tech Writers are content curators who write about the products and services an organisation offers its users. Following are some of the key deliverables:<\/span><\/em><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Product Documents:<\/b><span style=\"font-weight: 400;\"> Concepts and features.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Procedures: <\/b><span style=\"font-weight: 400;\">How-to perform actions.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>API Documentation:<\/b><span style=\"font-weight: 400;\"> APIs and parameters with code samples.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Installation and Configuration Guides:<\/b><span style=\"font-weight: 400;\"> Steps to install and configure products.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>User Guides:<\/b><span style=\"font-weight: 400;\"> Different types of User Guides targeting specific types of users. For example, User Guide for End Users and User Guide for Advanced Users.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Admin Guide:<\/b><span style=\"font-weight: 400;\"> Guides meant for the Administrators with advanced features and permissions.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Error Docs: <\/b><span style=\"font-weight: 400;\">Guides explaining the Error Codes and how to fix them.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>FAQ: <\/b><span style=\"font-weight: 400;\">FAQs to provide quick help to users.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Knowledge Base: <\/b><span style=\"font-weight: 400;\">KB used by external users and internal Support teams.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Integration Guides:<\/b><span style=\"font-weight: 400;\"> Steps to integrate third-party products.<\/span><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">In many organisations, Tech Writers also help with UX writing, where they provide the content to be displayed on the Product screens. For example, Labels, Screen Titles, Tooltips, Success\/Failure messages, and Error Messages.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">A Tech Writing team has an elaborate review process to ensure the content&#8217;s accuracy and completeness. There is also a reviewer, proofreader, or editor who performs quality checks to bring clean content to users.<\/span><\/p>\n<h2><span style=\"font-weight: 400;\">Tech Writers as Testers<\/span><\/h2>\n<p><span style=\"font-weight: 400;\">Tech Writers often need to test the product to verify the features and perform the actions within the system to capture the behavior and document the appropriate steps. They access the products and services in a test environment before the new feature goes live. And this is where Tech Writers act as Testers, testing the product and reporting any deviations to the Engineering team.\u00a0<\/span><\/p>\n<h2><span style=\"font-weight: 400;\">Tech Writers as Users<\/span><\/h2>\n<p><span style=\"font-weight: 400;\">Tech Writers are often the first users of a new product or feature. The Tech Writers are not Developers or Product Managers, so their behavior and actions are much similar to how users will use the feature. The Tech Writers check the User Experience, interactivity, ease of use, and design and can provide valuable insights to the Product team.<\/span><\/p>\n<h2><span style=\"font-weight: 400;\">Tech Writers Vs. Instructional Designers<\/span><\/h2>\n<p><span style=\"font-weight: 400;\"><strong>Tech Writers<\/strong> are not Instructional Designers, as the job role is pretty different. However, Tech Writers often double up as Instructional Designers in many organisations.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">So, what do Instructional Designers do?<\/span><\/p>\n<p><span style=\"font-weight: 400;\"><strong>Instructional Designers<\/strong> create training videos and tutorials, which may be a Product Demo with screen recordings or animated videos with fancy images and voiceovers. Usually, Instructional Designers are part of the Learning &amp; Development team. However, the reporting and alignment depend upon the organisation&#8217;s structure.<\/span><\/p>\n<h3><span style=\"font-weight: 400;\">When to hire instructional designers<\/span><\/h3>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">If the videos require animations and designs, for such requirements, Instructional Designers are hired as these require different skills like Designing and Animation. Or, if you have a design team who can provide the designs and animations and collaborate with Tech Writers, that works too.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">If the organisation requires developing and maintaining a large number of videos on an ongoing basis for training, user demos, and marketing needs, you must hire Instructional Designers.<\/span><\/li>\n<\/ul>\n<h2><span style=\"font-weight: 400;\">Difference between Tech Writers Vs. Content Writers<\/span><\/h2>\n<p><span style=\"font-weight: 400;\">People often confuse Content Writers with Technical Writers and think their job role is the same but with different names. That\u2019s not true. Tech Writers and Content Writers exist as separate entities in an organisation and have specific responsibilities.<\/span><\/p>\n<p><b>Content Writers<\/b><span style=\"font-weight: 400;\"> create content for the Marketing team where they write Blogs, Flyers, Brochures, and website content mainly to create awareness about the products and services. They aim to bring more traffic to the company website, get more enrollments and registrations, and increase sales. They adopt a friendly tone while writing and use a lot of colourful imagery, GIFs, memes, and video clips to get the users&#8217; attention. They are the content creators for the company website and social media channels like LinkedIn, Twitter, and Facebook.<\/span><\/p>\n<p><b>Tech Writers,<\/b><span style=\"font-weight: 400;\"> on the other hand, use a more formal or semi-formal tone. The objective is to provide complete and accurate information about the products and services offered by the organisation. They create content that users can refer to understand and use the products well. These documents and articles are self-serve tools for the users. They provide aid to the Customer Support team while responding to user queries. Tech Writers use screenshots, short How-to and Product videos, and process diagrams to make their articles richer and easier to read.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Tech and Content Writers require similar skill sets like excellent communication and writing skills, the ability to comprehend complex concepts, and research skills. Additionally, Tech Writers require skills to understand codes and document them. While writing integration guides, they need to do hands-on testing on the products, installation, and configurations before they write.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">With this blog, we hope that people will no longer mix up a Tech Writer with an Instructional Designer or Content Writer and appreciate the value the Technical Communicators bring to an organisation.<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Are you a Tech Writer, and upon declaring your profession, receive confused reactions from people? Well, you are not alone! Strangely enough, many do not know about Tech Writers and what they do. This blog is to clear the air and help people understand the job role of a Technical Writer in detail.\u00a0 \u00a0A Tech<\/p>\n","protected":false},"author":151156526,"featured_media":6819,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3606],"tags":[3607],"class_list":{"0":"post-6818","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","7":"category-tech-writing","8":"tag-docs"},"_links":{"self":[{"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/posts\/6818","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/users\/151156526"}],"replies":[{"embeddable":true,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/comments?post=6818"}],"version-history":[{"count":3,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/posts\/6818\/revisions"}],"predecessor-version":[{"id":6825,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/posts\/6818\/revisions\/6825"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/media\/6819"}],"wp:attachment":[{"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/media?parent=6818"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/categories?post=6818"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/tags?post=6818"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}