{"id":9458,"date":"2023-11-17T16:02:00","date_gmt":"2023-11-17T10:32:00","guid":{"rendered":"https:\/\/razorpay.com\/learn\/?p=9458"},"modified":"2023-11-17T16:05:16","modified_gmt":"2023-11-17T10:35:16","slug":"documenting-for-different-media","status":"publish","type":"post","link":"https:\/\/razorpay.com\/learn\/documenting-for-different-media\/","title":{"rendered":"Documenting for Different Media"},"content":{"rendered":"<p><span style=\"font-weight: 400;\">Recently, I bought a DIY Foosball for my 6-year-old kid. The game kit had a 60-page booklet explaining every piece and 35 steps to set it up. I would have given up if I had to follow these steps on the web!<\/span><\/p>\n<p><span style=\"font-weight: 400;\"><img decoding=\"async\" class=\"wp-image-9466 alignleft\" src=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_3.png\" alt=\"\" width=\"310\" height=\"362\" srcset=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_3.png 984w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_3-257x300.png 257w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_3-878x1024.png 878w\" sizes=\"(max-width: 310px) 100vw, 310px\" \/><img decoding=\"async\" class=\"alignnone wp-image-9467\" src=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_4.png\" alt=\"\" width=\"372\" height=\"369\" srcset=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_4.png 1246w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_4-300x298.png 300w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_4-1024x1017.png 1024w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_4-150x150.png 150w\" sizes=\"(max-width: 372px) 100vw, 372px\" \/>The above example points to a vital consideration while documenting content &#8211; the medium. Will the content be published in print, online or on a hand-held device such as mobile or tablet?<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Documents, such as Installation Guides, User Guides, Help, and FAQs for different products and offerings, are published on different mediums. Say, for example:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">The small booklet with a mobile device is a Get Started guide printed manual.\u00a0<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">The information about how to change the wallpaper of your mobile device is an integrated FAQ document on mobile.\u00a0<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">The information on the web about \u201cHow to integrate Razorpay Payment Gateway on a Woocommerce website\u201d is an integration guide available on<\/span><a href=\"https:\/\/razorpay.com\/docs\/#home-payments\"><span style=\"font-weight: 400;\"> Razorpay\u2019s documentation website<\/span><\/a><span style=\"font-weight: 400;\">.<\/span><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">But how do tech communicators decide when to use which medium? This blog explores the critical aspects tech writers and content strategists should consider while choosing the medium. The blog further discusses how writing content for print differs from mobile or web writing.\u00a0\u00a0<\/span><\/p>\n<h3><span style=\"font-weight: 400;\">Factors that Decide Medium of Technical Documentation<\/span><\/h3>\n<h4><span style=\"font-weight: 400;\">Kind of Product or Offering<\/span><\/h4>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">For physical products, creating technical content in print makes more sense. However, this is not a thumb rule. The tech writers should evaluate the other factors, too, before deciding the most appropriate medium.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">For complex products that require pages of explanation and understanding, content in print is more useful as the users must do a deep study and grasp the concepts well before using the product. Reading on print is a better experience than on the web as it is easier to concentrate (no distraction from pop-ups and advertisements) and less strain on the eyes\u2014for example, Server Installation and Configuration Guide.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">For products that require complex diagrams or multiple steps, which run through pages, it is easier to follow diagrams, maps and complicated steps in print than on the web.<\/span><\/li>\n<\/ul>\n<h4><span style=\"font-weight: 400;\">User Journey Impacted<\/span><\/h4>\n<p><span style=\"font-weight: 400;\">The tech writers should understand the user journey and the possible scenarios when they refer to the technical documentation.\u00a0<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Say, for example, while using an application such as Google Docs on a laptop, whenever a user requires help with adding tables, the help is displayed as a pop-up on top of the user\u2019s document. A help within context is much more helpful.<\/span><\/p>\n<p><span style=\"font-weight: 400;\"><img decoding=\"async\" class=\"wp-image-9464 aligncenter\" src=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_1.png\" alt=\"\" width=\"258\" height=\"396\" srcset=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_1.png 700w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_1-196x300.png 196w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_1-667x1024.png 667w\" sizes=\"(max-width: 258px) 100vw, 258px\" \/>Let me explain this with one more example. I bought a pair of earpods and referred to the set-up guide, a small leaflet with the earpod box. It was a quick 2-step setup, easy and simple. Providing this information in print makes perfect sense as I was getting started with the physical device.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">While using the device, I encountered a couple of issues, like the voice of the left earpod not being in sync with the right earpod. I referred to FAQs on the company website. It is difficult to list the 30+ errors in print as that would have made the troubleshooting guide voluminous, and the company would have to spend more on bigger packaging to house a bigger guide! And that\u2019s not a good business decision, isn\u2019t it? Hence, the decision-makers understood the user journey well and presented information as and when the users required it &#8211; Get Started in print and Troubleshooting on the web. Perfect!<\/span><\/p>\n<p><span style=\"font-weight: 400;\">The help for mobile devices is available mostly under a menu called Help. The users can refer to the Help on their mobile devices and self-serve.<\/span><\/p>\n<blockquote><p><span style=\"font-weight: 400;\">Other factors like how often the content needs to be revised, content maintenance, language support, and scalability based on the number of product offerings and geographies supported are the other crucial points to consider when deciding the content medium.\u00a0<\/span><\/p><\/blockquote>\n<p><span style=\"font-weight: 400;\">Generating content in print means printing expenses, storage of these guides and packaging of these guides. On the other hand, generating content on the web implies the infrastructure cost required to host the content. When content goes online, availability and data security are also essential aspects, all of which come with a cost.<\/span><\/p>\n<h3><span style=\"font-weight: 400;\">Writing for Print Vs. Online Vs. Mobile<\/span><\/h3>\n<p><span style=\"font-weight: 400;\">When Tech Writers write, they must be mindful of where the content will be published.<\/span><\/p>\n<h4><span style=\"font-weight: 400;\">Format<\/span><\/h4>\n<p><span style=\"font-weight: 400;\">The formatting and layout of a guide vary largely based on the medium where it will be published.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">A guide on print requires a cover page, page margins, table of contents, page numbering, and several other formatting pieces so that the pages can be printed and pinned together as a book.\u00a0<\/span><\/p>\n<p><span style=\"font-weight: 400;\">A guide on the web is more of separated pages with some consistency and an easy way to move between the Previous and Next pages. Instead of a table of contents, there will be a navigation mechanism and Search to find information.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">While writing for mobile devices, tech writers should use a simple layout with an easy flow of information. Most often, a different content design is used for mobile. Content overflowing is a common issue while displaying content on mobile devices. Thorough testing should be done on various mobile device screen resolutions to ensure the content is aesthetically presented.<\/span><\/p>\n<p><span style=\"font-weight: 400;\"><img decoding=\"async\" class=\"wp-image-9468 aligncenter\" src=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_5.png\" alt=\"\" width=\"264\" height=\"416\" srcset=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_5.png 764w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_5-190x300.png 190w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_5-650x1024.png 650w\" sizes=\"(max-width: 264px) 100vw, 264px\" \/>A few organisations may be required to display content on multiple mediums. Several tools, such as Adobe RoboHelp, allow content to be displayed on the web with HTML or CHM outputs or in print with PDF output. They often create responsive content, which can autofit itself based on the screen resolution.\u00a0\u00a0<\/span><\/p>\n<h4><span style=\"font-weight: 400;\">Content Type<\/span><\/h4>\n<p><span style=\"font-weight: 400;\">When tech writers create content in print, they use text, images and diagrams to explain their concepts. Adding references means listing down the related topics. Hyperlinks and bookmarks are not going to work in print.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Web content types, such as text, images, diagrams, gifs, videos and interactive content, can be more varied. References and bookmarks are vastly used as the users can quickly jump between web pages.<\/span><\/p>\n<p><span style=\"font-weight: 400;\"><img decoding=\"async\" class=\"wp-image-9465 aligncenter\" src=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_2.png\" alt=\"\" width=\"516\" height=\"512\" srcset=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_2.png 1510w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_2-300x298.png 300w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_2-1024x1016.png 1024w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/11\/writing_diff_media_2-150x150.png 150w\" sizes=\"(max-width: 516px) 100vw, 516px\" \/>The content needs to be crisper while writing help for mobile due to the small real estate available on the mobile screen. Also, some terminologies, such as Tap instead of Click, need to be mobile-specific. The content should be condensed with fewer steps, shorter headings and minimal images.<\/span><\/p>\n<h3><span style=\"font-weight: 400;\">Conclusion<\/span><\/h3>\n<p><span style=\"font-weight: 400;\">Organisations need to choose the medium to publish product and technical content wisely. They often use a combination of these or all of these based on the products they offer and their audience. The tech writers must employ concepts like <\/span><a href=\"https:\/\/en.wikipedia.org\/wiki\/Single-source_publishing\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">single-sourcing <\/span><\/a><span style=\"font-weight: 400;\">and tools that support content reuse to publish content on multiple mediums. Whatever mediums the tech writers choose to publish their content, they must also consider the maintainability and scalability of the content as organisations grow and products become more complex.<\/span><\/p>\n<h3><span style=\"font-weight: 400;\">References<\/span><\/h3>\n<p><a href=\"https:\/\/www.nngroup.com\/articles\/writing-style-for-print-vs-web\/\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">https:\/\/www.nngroup.com\/articles\/writing-style-for-print-vs-web\/<\/span><\/a><\/p>\n<p><a href=\"https:\/\/medium.com\/swlh\/how-to-optimize-your-writing-for-mobile-devices-8bd549d243bf\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">https:\/\/medium.com\/swlh\/how-to-optimize-your-writing-for-mobile-devices-8bd549d243bf<\/span><\/a><\/p>\n<p><a href=\"https:\/\/visual.ly\/community\/Infographics\/education\/writing-mobile-devices\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">https:\/\/visual.ly\/community\/Infographics\/education\/writing-mobile-devices<\/span><\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Recently, I bought a DIY Foosball for my 6-year-old kid. The game kit had a 60-page booklet explaining every piece and 35 steps to set it up. I would have given up if I had to follow these steps on the web! The above example points to a vital consideration while documenting content &#8211; the<\/p>\n","protected":false},"author":151156526,"featured_media":9469,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3606],"tags":[],"class_list":{"0":"post-9458","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","7":"category-tech-writing"},"_links":{"self":[{"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/posts\/9458","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=9458"}],"version-history":[{"count":3,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/posts\/9458\/revisions"}],"predecessor-version":[{"id":9473,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/posts\/9458\/revisions\/9473"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/media\/9469"}],"wp:attachment":[{"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/media?parent=9458"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/categories?post=9458"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/tags?post=9458"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}