{"id":6710,"date":"2022-09-02T15:12:16","date_gmt":"2022-09-02T09:42:16","guid":{"rendered":"https:\/\/razorpay.com\/learn\/?p=6710"},"modified":"2024-09-11T12:44:40","modified_gmt":"2024-09-11T07:14:40","slug":"writing-tech-documentation-do-your-research","status":"publish","type":"post","link":"https:\/\/razorpay.com\/learn\/writing-tech-documentation-do-your-research\/","title":{"rendered":"Writing Tech Documentation? Do Your Research!"},"content":{"rendered":"<p><span style=\"font-weight: 400;\">Technical documentation is an essential tool for any software company. Why? Companies rely heavily on documentation to educate their customers and reduce support tickets. Take the example of Razorpay Docs. In the last 90 days, over 1.8 million users (source: Google Analytics) visited our documentation to find answers to their questions!<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Given its importance, Tech Writers at Razorpay take the utmost care to create and publish accurate and complete documentation. And all of this is possible thanks to our in-depth research and analysis process.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">One of the biggest mistakes any writer can make is not putting in enough effort while researching content &#8211; be it for a blog or a technical document. After all, what is the point of writing if one is unsure of the content\u2019s accuracy and completeness? Therefore, research and analysis is the first step of the document development life cycle.<\/span><\/p>\n<p><img decoding=\"async\" class=\"wp-image-6711 size-large\" src=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2022\/09\/Diagram-1024x533.png\" alt=\"...\" width=\"1024\" height=\"533\" srcset=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2022\/09\/Diagram-1024x533.png 1024w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2022\/09\/Diagram-300x156.png 300w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2022\/09\/Diagram-1536x800.png 1536w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<h2><span style=\"font-weight: 400;\">An Ideal Research Process<\/span><\/h2>\n<p><span style=\"font-weight: 400;\">As per the Document Development Life Cycle, the tech writer should conduct in-depth research before beginning to write. Given below are some of the best practices that can be followed by writers in the pre-writing, drafting, and post-writing phases:<\/span><\/p>\n<h3><span style=\"font-weight: 400;\">Pre-writing Phase<\/span><\/h3>\n<ul>\n<li aria-level=\"1\"><b>Product Concept Note &amp; Design Specification Analysis<\/b><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Usually, the documentation process begins when the Product Manager communicates the documentation requirements to the tech writer. Product managers should share the concept note containing complete information about the new product\/feature to be documented, along with the proposed designs, and provide a complete walkthrough of the product. The tech writer should then read the concept note and come prepared for the session with a set of questions.<\/span><b><\/b><\/p>\n<ul>\n<li aria-level=\"1\"><b>Competitor Documentation Analysis<\/b><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">The tech writer needs to analyse the topic from different perspectives. For example, they can visit the competitors\u2019 sites to learn about their products and their approach to documentation. This could help them to understand how the competitor is pitching their product and what consumer asks they are catering to.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Based on this research, the tech writer should create a research document containing the competitor analysis and a proposed outline of changes to the documentation. This can help the tech writer visually map the documentation changes before creating the first draft.<\/span><\/p>\n<h3><span style=\"font-weight: 400;\">Drafting-Phase<\/span><\/h3>\n<ul>\n<li aria-level=\"1\"><b>Hands-On Software Testing<\/b><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Apart from writing skills, the most important quality a tech writer can possess is user empathy. We write documentation for users, so it is necessary to put ourselves in their shoes. One of the ways we can do this is by performing user-acceptance testing of the software before and during the writing process.\u00a0<\/span><\/p>\n<p><span style=\"font-weight: 400;\">This helps us experience the product from the user\u2019s perspective, provide clear instructions, and add relevant FAQs. It also allows us to share user-side feedback with the product manager and the Tech team. Not only products, but the tech writer should also test APIs and webhooks to ensure that the user gets accurate and complete information.<\/span><\/p>\n<h3><span style=\"font-weight: 400;\">Post-writing Phase<\/span><\/h3>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Feedback Analysis<\/b><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Research does not end once the draft is published. Even after the documentation goes live, the writer should monitor the feedback. This can be done by having a feedback mechanism in place and by conducting user interviews.<\/span><\/p>\n<figure id=\"attachment_6712\" aria-describedby=\"caption-attachment-6712\" style=\"width: 1024px\" class=\"wp-caption aligncenter\"><img decoding=\"async\" class=\"wp-image-6712 size-large\" src=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2022\/09\/Screenshot-2022-09-02-at-11.16.46-AM-1024x572.png\" alt=\"Razorpay\u2019s feedback mechanism within the documentation\" width=\"1024\" height=\"572\" srcset=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2022\/09\/Screenshot-2022-09-02-at-11.16.46-AM-1024x572.png 1024w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2022\/09\/Screenshot-2022-09-02-at-11.16.46-AM-300x168.png 300w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2022\/09\/Screenshot-2022-09-02-at-11.16.46-AM.png 1250w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><figcaption id=\"caption-attachment-6712\" class=\"wp-caption-text\">Razorpay\u2019s feedback mechanism within the documentation<\/figcaption><\/figure>\n<p><span style=\"font-weight: 400;\">The writer should also stay in touch with the Product Manager to know about any product updates and makes necessary changes.<\/span><\/p>\n<p>Related Read: <a href=\"\u201chttps:\/\/razorpay.com\/learn\/the-role-of-an-editor\/\u201d\">What Is the Role of an Editor? Duties &amp; Responsibilities<\/a><\/p>\n<h2><span style=\"font-weight: 400;\">Advantages\u00a0<\/span><\/h2>\n<h3><span style=\"font-weight: 400;\">Having an extensive research process ensures that:<\/span><\/h3>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Accurate and reliable information is shared with users. This builds trust among users about Razorpay products and increases adoption.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">The visual mapping process helps to tie related information together. Therefore, users get all the information in a single place.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Troubleshooting information is identified and added to the documentation. By trying the software out, the Tech Writer can determine what kind of errors can crop up and how users can overcome them.<\/span><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Research is integral for tech writing. With a well-defined research process, Tech writing teams can ensure that the information provided to the users is detailed, accurate, and reliable. While the above-mentioned points do not form an exhaustive list, they provide good reference points to help tech writers get started with the research and move a step towards building world-class documentation.<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Tech Writers at Razorpay take the utmost care to create and publish accurate and complete documentation. Wonder why? Read more to find out! <\/p>\n","protected":false},"author":151156543,"featured_media":6718,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3507],"tags":[3604],"class_list":{"0":"post-6710","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","7":"category-business-growth","8":"tag-razorpay-documentation"},"_links":{"self":[{"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/posts\/6710","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\/151156543"}],"replies":[{"embeddable":true,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/comments?post=6710"}],"version-history":[{"count":3,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/posts\/6710\/revisions"}],"predecessor-version":[{"id":13259,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/posts\/6710\/revisions\/13259"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/media\/6718"}],"wp:attachment":[{"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/media?parent=6710"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/categories?post=6710"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/tags?post=6710"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}