{"id":8628,"date":"2022-08-10T15:30:42","date_gmt":"2022-08-10T10:00:42","guid":{"rendered":"https:\/\/razorpay.com\/blog\/?p=8628"},"modified":"2025-02-14T16:35:39","modified_gmt":"2025-02-14T11:05:39","slug":"razorpay-docs-as-a-product","status":"publish","type":"post","link":"https:\/\/razorpay.com\/blog\/razorpay-docs-as-a-product\/","title":{"rendered":"Razorpay Docs as a Product"},"content":{"rendered":"<p><span style=\"font-weight: 400;\">Gone are the days when product documentation was confined to just creating user guides or \u201chelp\u201d articles to provide details about how to use a certain product. Product Documentation today is a lot more than a \u201cgood-to-have\u201d document to \u201cmust-have\u201d <\/span><b>assets<\/b><span style=\"font-weight: 400;\">.\u00a0<\/span><\/p>\n<p><span style=\"font-weight: 400;\">The organisations that have realised the power of content have excelled and continue to lead the market. Examples? Microsft, Google, Apple, Stripe, Atlassian Firebase, and so on, to name a few. These companies have put in a significant amount of effort and investment to build and maintain their documentation and reaped the benefits.<\/span><\/p>\n<h1><b>What is Razorpay Docs<\/b><\/h1>\n<p><a href=\"https:\/\/razorpay.com\/docs\/\"><span style=\"font-weight: 400;\">Razorpay Docs<\/span><\/a><span style=\"font-weight: 400;\"> is a vast source of information on every product or feature that Razorpay offers, where and how to use them, how to integrate them and how to use the Razorpay APIs.\u00a0<\/span><\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-8629 size-large\" src=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/blog-content\/uploads\/2022\/08\/Blog1-1024x457.png\" alt=\".....\" width=\"1024\" height=\"457\" srcset=\"https:\/\/blog.razorpay.in\/wp-content\/uploads\/2022\/08\/Blog1-1024x457.png 1024w, https:\/\/blog.razorpay.in\/wp-content\/uploads\/2022\/08\/Blog1-300x134.png 300w, https:\/\/blog.razorpay.in\/wp-content\/uploads\/2022\/08\/Blog1-768x343.png 768w, https:\/\/blog.razorpay.in\/wp-content\/uploads\/2022\/08\/Blog1-1536x686.png 1536w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-8630 size-large\" src=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/blog-content\/uploads\/2022\/08\/Blog2-1024x472.png\" alt=\".....\" width=\"1024\" height=\"472\" srcset=\"https:\/\/blog.razorpay.in\/wp-content\/uploads\/2022\/08\/Blog2-1024x472.png 1024w, https:\/\/blog.razorpay.in\/wp-content\/uploads\/2022\/08\/Blog2-300x138.png 300w, https:\/\/blog.razorpay.in\/wp-content\/uploads\/2022\/08\/Blog2-768x354.png 768w, https:\/\/blog.razorpay.in\/wp-content\/uploads\/2022\/08\/Blog2-1536x708.png 1536w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<p><span style=\"font-weight: 400;\">Razorpay Docs can be primarily divided into 3 segments:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Product Documentation<\/b><span style=\"font-weight: 400;\">: Explains all the <a href=\"https:\/\/razorpay.com\/newsroom\/our-products\/\">Razorpay products<\/a>, features, benefits, and how to use them<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>API Documentation<\/b><span style=\"font-weight: 400;\">: Explains all the Razorpay APIs with code samples and request\/response parameter descriptions<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Integration Documentation<\/b><span style=\"font-weight: 400;\">: End-to-end, step-by-step integration flow with code samples and integration videos<\/span><\/li>\n<\/ul>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-8631 size-large\" src=\"https:\/\/d6xcmfyh68wv8.cloudfront.net\/blog-content\/uploads\/2022\/08\/Blog3-1024x483.png\" alt=\"....\" width=\"1024\" height=\"483\" srcset=\"https:\/\/blog.razorpay.in\/wp-content\/uploads\/2022\/08\/Blog3-1024x483.png 1024w, https:\/\/blog.razorpay.in\/wp-content\/uploads\/2022\/08\/Blog3-300x141.png 300w, https:\/\/blog.razorpay.in\/wp-content\/uploads\/2022\/08\/Blog3-768x362.png 768w, https:\/\/blog.razorpay.in\/wp-content\/uploads\/2022\/08\/Blog3-1536x724.png 1536w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/p>\n<p><strong>Razorpay Docs comprises concepts, use cases, how-to tasks, workflow diagrams, screenshots, code samples, plenty of How-to videos (150+) and integration videos (~30), FAQs, and a Glossary.\u00a0<\/strong><\/p>\n<h3><b>Who Uses Razorpay Docs<\/b><\/h3>\n<p><span style=\"font-weight: 400;\">Razorpay Docs user is every individual who comes to the Razorpay Docs site to understand more about Razorpay products. We have segmented our customers into the following types:<\/span><\/p>\n<p><b>External<\/b><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Existing\/New Razorpay Merchants<\/b><span style=\"font-weight: 400;\"> trying to understand more about Razorpay products, concepts, and dashboard \u201chow-to\u2019s\u201d.\u00a0<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Merchant Developers<\/b><span style=\"font-weight: 400;\"> trying to integrate Razorpay products or use Razorpay APIs.<\/span><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">There are also <\/span><b>Razorpay Merchant\u2019s customers<\/b><span style=\"font-weight: 400;\"> who make payments using Razorpay <a href=\"https:\/\/razorpay.com\/payment-gateway\/\">Payment Gateway<\/a>\/Razorpay products and visit Razorpay Docs for information related to <\/span><a href=\"https:\/\/razorpay.com\/docs\/payments\/customers\/customer-refunds\"><span style=\"font-weight: 400;\">refunds<\/span><\/a><span style=\"font-weight: 400;\">.<\/span><\/p>\n<p><b>Internal (Razorpay Folks)<\/b><\/p>\n<ul>\n<li aria-level=\"1\"><b>Support and Integrations Team<\/b><\/li>\n<\/ul>\n<ul>\n<li aria-level=\"1\"><b>Product<\/b><\/li>\n<\/ul>\n<ul>\n<li aria-level=\"1\"><b>Engineering<\/b><\/li>\n<\/ul>\n<ul>\n<li aria-level=\"1\"><b>Sales\/Presales<\/b><\/li>\n<\/ul>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Everyone else at Razorpay<\/b><span style=\"font-weight: 400;\"> accessing Razorpay Docs to know more about Razorpay products, APIs, and integrations.<\/span><\/li>\n<\/ul>\n<h1><b>Razorpay Docs &#8211; The Product<\/b><\/h1>\n<p><span style=\"font-weight: 400;\">We look at Razorpay Docs as a product because:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">It requires <\/span><b>continuous improvement<\/b><span style=\"font-weight: 400;\">, including fixes and enhancements.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">It helps <\/span><b>reduce support costs<\/b><span style=\"font-weight: 400;\"> by providing self-serve solutions through self-read articles and videos.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">It <\/span><b>brings in more users to Razorpay<\/b><span style=\"font-weight: 400;\"> by creating awareness and providing information about Razorpay products and offerings.<\/span><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Razorpay Docs is a publicly available website that does not require any subscription or log-in. Anyone who wants to know about Razorpay can access it.\u00a0<\/span><\/p>\n<p><span style=\"font-weight: 400;\">In the Product Life Cycle, Razorpay Docs is currently at the <\/span><b>Growth<\/b><span style=\"font-weight: 400;\"> stage. These days, users are more comfortable finding information on the internet, be it Google, YouTube, or self-learning forums and platforms. <\/span><\/p>\n<p><span style=\"font-weight: 400;\">With more innovation and sophistication seeping in, we expect the need for this product to grow multi-fold, which makes it one of the driving factors for making the user experience smoother and better.<\/span><\/p>\n<h1><b>Who Manages Razorpay Docs<\/b><\/h1>\n<p><span style=\"font-weight: 400;\">There are different stakeholders of Razorpay Docs &#8211; Tech Writing, Product, and Engineering.<\/span><\/p>\n<h3><b>Tech Writing<\/b><\/h3>\n<p><span style=\"font-weight: 400;\">The Tech Writing team is the primary owner and is responsible for every word you see on Razorpay Docs. They are the content curators, editors, and proofreaders who work with the Razorpay Product Managers to ensure every information and detail about the Razorpay products are accurately captured and presented to the users.\u00a0<\/span><\/p>\n<h3><b>Product<\/b><\/h3>\n<p><span style=\"font-weight: 400;\">The Docs Product Manager works with the designers, technical writers, and engineers to determine the features to build and deliver on the Docs platform.<\/span><\/p>\n<h3><b>Engineering<\/b><\/h3>\n<p><span style=\"font-weight: 400;\">The Engineering Manager works with the engineers, testers, technical writers and Docs Product Manager to bring in the Docs platform capabilities.<\/span><\/p>\n<h1><b>Docs Strategy and Roadmap<\/b><\/h1>\n<p><span style=\"font-weight: 400;\">Razorpay Docs&#8217; strategy has revolved around writing simple, easy-to-understand articles that can be easily discovered and consumed.\u00a0<\/span><\/p>\n<p><b>Razorpay Docs Vision<\/b><span style=\"font-weight: 400;\">\u00a0<\/span><\/p>\n<p><strong>Razorpay Docs &#8211; Single source of information for all that is Razorpay. Create comprehensive, easy-to-understand Razorpay Docs, which our users love and trust. Help users find answers to all questions related to Razorpay.<\/strong><\/p>\n<p><span style=\"font-weight: 400;\">At the beginning of every financial year, the Technical Writing, Product, and Engineering come together to set the Docs strategy in alignment with the company\u2019s goals and theme for the year. This year, our focus is on user experience.\u00a0<\/span><\/p>\n<p><span style=\"font-weight: 400;\">In addition to the regular updates, we do to the Razorpay docs to keep our content up-to-date, we identify a few projects in alignment with our organisation and function goals.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">We set goals at the onset of the financial year and track and measure the progress every quarter. We have several metrics such as User Satisfaction scores on Razorpay Docs using surveys, Google Analytics data to measure the traffic on the Razorpay Docs articles, and Razorpay Docs SEO.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">This year, we have identified a few projects, such as:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">API Docs Revamping<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Simplifying Integrations Docs<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">New features and capabilities on the Razorpay Docs platform<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">The embedded User Feedback module<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">New Razorpay Docs design with a central navigation system and enhanced look and feel<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Improved Search Capabilities<\/span><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Apart from these, we are also evaluating a Docs ChatBot and building a Developer Community for Razorpay.<\/span><\/p>\n<h1><b>Research, Design, Engineering, and Implementation<\/b><\/h1>\n<p><span style=\"font-weight: 400;\">As per our Docs roadmap, we pick up projects for every quarter. A few of these projects may be completely content-driven, a few may be design-driven or tech-driven, or a combination of design, content, and tech.\u00a0\u00a0<\/span><\/p>\n<h2><b>Project Definition and Scope<\/b><\/h2>\n<p><span style=\"font-weight: 400;\">We define the project&#8217;s purpose and what needs to be added or improved. Based on the project scope, the teams own the projects. Many of these projects are co-owned by Product, Engineering,, and Technical Writing.<\/span><\/p>\n<h2><b>Data-Driven<\/b><\/h2>\n<p><span style=\"font-weight: 400;\">Every initiative is data-driven to understand why it is essential to pick up the project, what problems we are trying to solve, and the expected outcome.\u00a0<\/span><\/p>\n<p><span style=\"font-weight: 400;\">In content, not everything can be measured. For example, <\/span><i><span style=\"font-weight: 400;\">how do you measure the quality of articles? <\/span><\/i><span style=\"font-weight: 400;\">We have identified these parameters to measure the quality of our docs &#8211; <\/span><b>Complete<\/b><span style=\"font-weight: 400;\">, <\/span><b>Accurate,<\/b><span style=\"font-weight: 400;\"> and <\/span><b>Easy-to-Understand<\/b><span style=\"font-weight: 400;\">. While one can measure the completeness and accuracy of an article, it is difficult to measure the third parameter &#8211; Easy to Understand. <\/span><i><span style=\"font-weight: 400;\">What is easy to one may be difficult for others!<\/span><\/i><\/p>\n<p><strong>We use survey data on Razorpay Docs, conduct user interviews, and track user behaviour on the Razorpay Docs site to get insights about these parameters. We measure this month-on-month and, based on the findings finetune our docs strategy and focus areas.<\/strong><\/p>\n<h2><b>Processes We Follow<\/b><\/h2>\n<p><span style=\"font-weight: 400;\">We have streamlined processes and tools such as Asana to track our projects.\u00a0<\/span><\/p>\n<p><span style=\"font-weight: 400;\">A few of these projects are content-heavy, where templates are decided after market study and competitor analysis. For example, when we revamped our product documents, we analysed our competitors and conducted thorough <a href=\"https:\/\/razorpay.com\/learn\/what-is-market-research\/\">market research<\/a> before deciding on our articles&#8217; structure.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Some projects require input from Design and UX teams. For instance, we found that we had diagrams on Razorpay docs, which were inconsistent. The colours and styles were mixed up. We worked with the Design team to put a framework for the diagrams\u2019 designs and standardised all our diagrams.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">The project related to revamping the Razorpay Docs website required efforts from Design, Product, Engineering, and Tech Writing to bring the new website live.<\/span><\/p>\n<p><b>Process in a Nutshell<\/b><\/p>\n<ol>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">The Tech Writing, Product, and Design team conduct user research and user interviews, record user behaviours on the Razorpay docs site, and recommends improvements<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">The Design and TW teams suggest design improvements and make content changes<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">The Engineering team works on the designs and implements the new designs<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">We measure the impact to validate our designs and content changes<\/span><\/li>\n<\/ol>\n<p><span style=\"font-weight: 400;\">For example, after we started publishing our revamped product documents, we could find a 5-7% improvement in the User Satisfaction scores in Razorpay Docs surveys. This validated that the users liked the changes we brought in.<\/span><\/p>\n<h1><b>What Razorpay Docs Achieved<\/b><\/h1>\n<p><span style=\"font-weight: 400;\">With the approach mentioned above, we could significantly improve Razorpay Docs. Last year, we took up several new projects.<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">We ran multiple docs initiatives projects such as Docs Revamping, Adding Sample Codes in Multiple SDK Server Languages such as PHP, NodeJS, Python, Ruby, Java, and Go, and developed 150+ Dashboard videos. <\/span><b>We recorded a 13% improvement in the user satisfaction scores on Razorpay Docs<\/b><span style=\"font-weight: 400;\">.\u00a0<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">We built 30 integration videos and <\/span><b>reduced the integration tickets by more than 50%<\/b><span style=\"font-weight: 400;\">.<\/span><\/li>\n<\/ul>\n<p><strong>More importantly, we have established that Docs should be treated as a critical offering and more of a Product that requires meticulous feature planning and continuous incremental improvement.<\/strong><\/p>\n<h1><b>Where is Razorpay Docs<\/b><\/h1>\n<p><span style=\"font-weight: 400;\">We started in 2016 with some 53 articles and have <\/span><b>grown 28 times with over 1500 articles <\/b><span style=\"font-weight: 400;\">by 2022. Razorpay Docs was built on a philosophy of providing simple, easy-to-understand content that can help users get self-started with Razorpay.\u00a0<\/span><\/p>\n<p><span style=\"font-weight: 400;\">We started with a rock-solid base with a handful of highly talented Technical Writers who had clear objectives. We have grown as a team and brought in streamlined processes, better tools, and exhaustive training sessions to train the new team members. We executed critical projects to establish Razorpay Docs as a serious piece of well-maintained knowledge source.\u00a0<\/span><\/p>\n<p><strong>We keep evaluating Razorpay Docs to see where we stand compared to the best in the industry. With our eyes set on our goals, brilliant minds at work, and best-in-class work culture, we aspire to get the #1 spot very soon. Wait and watch!<\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Razorpay Docs &#8211; Single source of information for all that is Razorpay. Read more to find out! <\/p>\n","protected":false},"author":95,"featured_media":8634,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"footnotes":""},"categories":[315],"tags":[316],"class_list":{"0":"post-8628","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","7":"category-razorpay-docs","8":"tag-razorpay-docs"},"_links":{"self":[{"href":"https:\/\/razorpay.com\/blog\/wp-json\/wp\/v2\/posts\/8628","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/razorpay.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/razorpay.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/razorpay.com\/blog\/wp-json\/wp\/v2\/users\/95"}],"replies":[{"embeddable":true,"href":"https:\/\/razorpay.com\/blog\/wp-json\/wp\/v2\/comments?post=8628"}],"version-history":[{"count":1,"href":"https:\/\/razorpay.com\/blog\/wp-json\/wp\/v2\/posts\/8628\/revisions"}],"predecessor-version":[{"id":20580,"href":"https:\/\/razorpay.com\/blog\/wp-json\/wp\/v2\/posts\/8628\/revisions\/20580"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/razorpay.com\/blog\/wp-json\/wp\/v2\/media\/8634"}],"wp:attachment":[{"href":"https:\/\/razorpay.com\/blog\/wp-json\/wp\/v2\/media?parent=8628"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/razorpay.com\/blog\/wp-json\/wp\/v2\/categories?post=8628"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/razorpay.com\/blog\/wp-json\/wp\/v2\/tags?post=8628"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}