{"id":7486,"date":"2023-02-10T02:34:43","date_gmt":"2023-02-09T21:04:43","guid":{"rendered":"https:\/\/razorpay.com\/learn\/?p=7486"},"modified":"2023-02-10T02:37:30","modified_gmt":"2023-02-09T21:07:30","slug":"user-feedback","status":"publish","type":"post","link":"https:\/\/razorpay.com\/learn\/user-feedback\/","title":{"rendered":"Why user feedback on documentation is important"},"content":{"rendered":"<p><span style=\"font-weight: 400;\">All the hard work we do is to deliver an awesome user experience.\u00a0 Be it a product or service, we want to hear from our customers if they like what we do.\u00a0<\/span><\/p>\n<h2><b>Why user feedback is important<\/b><\/h2>\n<p><span style=\"font-weight: 400;\">User feedback is absolutely essential for a documentation site. Most major tech companies \u2013 be it Microsoft, Google, Apple, Salesforce, or ServiceNow \u2013 have invested in building the finest documentation sites for their products and offerings. <\/span><span style=\"font-weight: 400;\">In fact, Stripe\u2019s knowledge base has been a key factor in its growth to an <\/span><a href=\"https:\/\/www.owler.com\/company\/stripe\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">estimated revenue of $540M and 1,000 employees<\/span><\/a><span style=\"font-weight: 400;\">.<\/span><span style=\"font-weight: 400;\"> In order to build the best documentation site, it is essential that users are a part of the journey.\u00a0<\/span><\/p>\n<p><img decoding=\"async\" class=\"aligncenter wp-image-7487 size-full\" src=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/blogsc1.png\" alt=\"User Feedback \" width=\"1222\" height=\"616\" srcset=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/blogsc1.png 1222w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/blogsc1-300x151.png 300w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/blogsc1-1024x516.png 1024w\" sizes=\"(max-width: 1222px) 100vw, 1222px\" \/><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Publicly available documentation sites are the first touch point for users to learn about an organisation and its offerings. These <\/span><b>documentation portals create the first impression<\/b><span style=\"font-weight: 400;\"> on the users.\u00a0<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">User feedback provides the <\/span><b>right direction to the teams <\/b><span style=\"font-weight: 400;\">who develop these sites. It helps them understand what content to deliver and how. Design, layout and user experience on documentation are the other important facets, which help in building a seamless docs experience.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><i><span style=\"font-weight: 400;\">Are you planning to make significant changes to your docs?<\/span><\/i><span style=\"font-weight: 400;\"> Say a complete design change or home page redesign or any other major change, it is always a good idea to roll it out to a few users, get their feedback, fine-tune your strategies and launch it to a larger audience.\u00a0<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Asking users for feedback also indicates how important user feedback is and shows that <\/span><b>we care<\/b><span style=\"font-weight: 400;\">!<\/span><\/li>\n<\/ul>\n<h2><b>How to collect user feedback<\/b><\/h2>\n<p><span style=\"font-weight: 400;\">There are a few methods that organisations employ to connect with users and gather feedback.\u00a0<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>User Interviews: <\/b><span style=\"font-weight: 400;\">The best way to collect user feedback is to talk to users directly. Frame your questions for each user persona and ask specific questions about their experience. For example, while talking to a developer using your docs for integrations, ask questions like:\u00a0<\/span>\n<ul>\n<li><span style=\"font-weight: 400;\">Were you able to complete the integration using the docs?<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Was the information accurate and complete?<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Was it easy to understand?<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Would additional aid have made the experience better? <\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>The drawback of this approach is it may become difficult to connect with users for feedback. Also, the interviewer may influence the user to provide a specific type of feedback. But, if done with integrity, this is the best approach to receiving feedback.<\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Feedback Forms: <\/b><span style=\"font-weight: 400;\">Many companies provide a Feedback Form on the docs site to collect detailed user feedback. This is a good way to collect detailed written feedback. But, at times users may not want to spend time filling out feedback details in these forms.<\/span><\/li>\n<\/ul>\n<p><img decoding=\"async\" class=\"aligncenter wp-image-7488 size-full\" src=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/Blogsc2.png\" alt=\"User Feedback \" width=\"1092\" height=\"672\" srcset=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/Blogsc2.png 1092w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/Blogsc2-300x185.png 300w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/Blogsc2-1024x630.png 1024w\" sizes=\"(max-width: 1092px) 100vw, 1092px\" \/><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Embedded Feedback Module:<\/b><span style=\"font-weight: 400;\"> The most recent trend is that the feedback module is embedded within the docs article where the users can provide feedback on the specific article. This approach is useful as the feedback is more specific and at a more granular level.\u00a0 For example, if a user has found some information incorrect, they can highlight that in the feedback section. The content team can work on such feedback and take corrective action.<\/span><\/li>\n<\/ul>\n<p><img decoding=\"async\" class=\"aligncenter wp-image-7489 size-full\" src=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/BlogSC3.png\" alt=\"User Feedback\" width=\"1128\" height=\"790\" srcset=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/BlogSC3.png 1128w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/BlogSC3-300x210.png 300w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/BlogSC3-1024x717.png 1024w\" sizes=\"(max-width: 1128px) 100vw, 1128px\" \/><\/p>\n<p><img decoding=\"async\" class=\"aligncenter wp-image-7490 size-full\" src=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/BlogSC4.png\" alt=\"User Feedback \" width=\"2602\" height=\"1144\" srcset=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/BlogSC4.png 2602w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/BlogSC4-300x132.png 300w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/BlogSC4-1024x450.png 1024w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/BlogSC4-1536x675.png 1536w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/BlogSC4-2048x900.png 2048w\" sizes=\"(max-width: 2602px) 100vw, 2602px\" \/><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Surveys:<\/b><span style=\"font-weight: 400;\"> Organisations often conduct surveys with their users to understand how their documents are perceived. These surveys are a good way to collect feedback as these can be shared with a larger set of users and provide an overall score on docs. At the same time, if the surveys are not targeted at the right set of users, they may provide inconclusive results.<\/span><\/li>\n<\/ul>\n<p><img decoding=\"async\" class=\"aligncenter wp-image-7491 size-full\" src=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/BlogSC5.png\" alt=\"\" width=\"998\" height=\"622\" srcset=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/BlogSC5.png 998w, https:\/\/d6xcmfyh68wv8.cloudfront.net\/learn-content\/uploads\/2023\/02\/BlogSC5-300x187.png 300w\" sizes=\"(max-width: 998px) 100vw, 998px\" \/><\/p>\n<h2><b>What next?<\/b><\/h2>\n<p><span style=\"font-weight: 400;\">Well, collecting user feedback is the first step in getting closer to the user and understanding their needs and wants.\u00a0<\/span><\/p>\n<ol>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Evaluate and act: <\/b><span style=\"font-weight: 400;\">After user feedback is collected, the next step is to evaluate the feedback and decide what needs to be incorporated. Act upon the user feedback and make appropriate changes.\u00a0<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Measure:<\/b><span style=\"font-weight: 400;\"> Collect data about how the changes are positively impacting the user experience.\u00a0<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Continue the process: <\/b><span style=\"font-weight: 400;\">Collecting user feedback and taking corrective action should be a continuous process and part of the documentation practices of an organisation.\u00a0<\/span><\/li>\n<\/ol>\n<h2><b>Wrapping Up<\/b><\/h2>\n<p><span style=\"font-weight: 400;\">Users have changed. They have become smarter and more aware of what is around. They want to be involved in the processes that build systems for them. Understanding users with user research is the first step towards building a seamless user experience. Collecting user feedback after the systems are built is also essential to cater to the changing needs and wants of the users as the ecosystems and the users continuously evolve. By responding to user feedback, you will never miss the opportunity to connect with them and make them part of the process.<\/span><\/p>\n<p><b><i>You will not only be able to deliver what users want but also develop a rapport and trust with them, and all of this is precious!\u00a0<\/i><\/b><\/p>\n","protected":false},"excerpt":{"rendered":"<p>All the hard work we do is to deliver an awesome user experience.\u00a0 Be it a product or service, we want to hear from our customers if they like what we do.\u00a0 Why user feedback is important User feedback is absolutely essential for a documentation site. Most major tech companies \u2013 be it Microsoft, Google,<\/p>\n","protected":false},"author":151156526,"featured_media":7492,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3606],"tags":[3613],"class_list":{"0":"post-7486","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","7":"category-tech-writing","8":"tag-technical-writing"},"_links":{"self":[{"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/posts\/7486","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=7486"}],"version-history":[{"count":3,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/posts\/7486\/revisions"}],"predecessor-version":[{"id":7495,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/posts\/7486\/revisions\/7495"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/media\/7492"}],"wp:attachment":[{"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/media?parent=7486"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/categories?post=7486"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/learn.razorpay.in\/learn\/wp-json\/wp\/v2\/tags?post=7486"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}