{"id":2468,"date":"2023-08-30T09:03:31","date_gmt":"2023-08-30T09:03:31","guid":{"rendered":"https:\/\/www.infobip.com\/developers\/?p=2468"},"modified":"2023-09-11T14:27:10","modified_gmt":"2023-09-11T14:27:10","slug":"why-docs-as-code-should-be-part-of-your-dev-cycle","status":"publish","type":"post","link":"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle","title":{"rendered":"Why Docs as Code Should Be Part of Your Dev Cycle"},"content":{"rendered":"\n

Many established methodologies help streamline software development. However, the same can\u2019t be said about documentation. Typically, a documentation cycle, as opposed to a developer one, is unnecessarily complicated<\/strong>, being a hybrid of different practices.<\/p>\n\n\n\n

It\u2019s a process that most often only a documentation team knows how to navigate, with developers trying to avoid being part of it at all costs. Nobody wants to learn new tools and processes for a collaboration that doesn\u2019t seem to bring much value.<\/p>\n\n\n\n

This article attempts to bridge the gap between documentation and development by showing the value of well-planned documentation and outlining how developers and technical content creators can collaborate under one process that is efficient for both teams.<\/p>\n\n\n\n

Because, let\u2019s face it, software documentation is important<\/strong>. It is often the very face of the product<\/strong>, like when it comes to an API reference. This is why documentation could and should be a part of a development cycle \u2014 and Docs as Code is the way forward.<\/p>\n\n\n\n

What Is a Docs as Code Approach?<\/h2>\n\n\n\n

As the name implies, the Docs as Code approach treats documentation as code, using the same tools and processes as software development <\/strong>to manage and publish documentation.<\/p>\n\n\n\n

Before we delve deeper, let\u2019s go through key aspects of a Docs as Code approach to get familiar with the concept.<\/p>\n\n\n\n

Key Aspects<\/h1>\n\n\n\n

The adoption of Docs as Code represents a paradigm shift in the way technical documentation is created and managed, making it an asset rather than a burden \u2014 a mindset many software companies develop around content.<\/p>\n\n\n\n

It empowers developers to easily update and iterate on documentation, ensures its accuracy and relevance, and provides users with quality self-serve access to information when they need it most.<\/p>\n\n\n\n

Many wins come with Docs as Code, but let\u2019s list those crucial for a developer cycle, the content itself and fostering collaboration between developers and content creators.<\/p>\n\n\n\n

Written in Plain-Text Format<\/h2>\n\n\n\n

The most important aspect of the Docs as Code philosophy is efficient collaboration between teams. To cater to this need, documentation is typically stored in a plain-text format, most likely markdown. <\/strong><\/p>\n\n\n\n

This facilitates accessing, managing and collaborating on any document. Plain-text format ensures you need no special equipment, software or licenses to work on a document. Anybody with access to the repository where the document is stored can go in and contribute.<\/p>\n\n\n\n

Styling is also abstracted from both the writing and the review process. Syntax review is typically automated by a linter and a grammar checker, such as a markdown linting expansion plugged into your Visual Studio Code editor.<\/strong> There\u2019s no need for a human reviewer to spend time reviewing syntax. Their sole concern is the content itself and the structure of the document.<\/p>\n\n\n\n

Decoupled Frontend and Backend<\/h2>\n\n\n\n

The decoupled frontend and backend architecture is a key element of the Docs as Code practices as it separates the concerns of content creation and presentation.<\/p>\n\n\n\n

This approach frees technical content creators from thinking about page design and styling <\/strong>of content elements (think warning notes, tips, tables, bullet points, etc.). They can focus solely on creating informative and well-structured content while collaborating with front-end developers or designers to provide an engaging and user-friendly presentation layer.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Content developers are free to deal with the most important aspects of content creation and management.<\/p>\n\n\n\n

Content Structure<\/h3>\n\n\n\n

This is how to present information on a page.<\/p>\n\n\n\n

    \n
  • Sections needed for different types of content, such as a tutorial, will always start with a description of what a user will end up with once they complete all the steps.<\/li>\n\n\n\n
  • The structure of sections, for instance, a Prerequisites section, can be just a bullet list, while an Introduction section needs at least one paragraph to be considered valid for its purpose.<\/li>\n\n\n\n
  • The style of section titles. Is it camel case or like a sentence? Do we want to use gerunds or infinitives \u2014 \u201cSending an SMS with Python\u201d or \u201cSend an SMS with Python\u201d?<\/li>\n<\/ul>\n\n\n\n

    Content Findability<\/h3>\n\n\n\n

    This is how to present information within the context of an entire documentation site.<\/strong><\/p>\n\n\n\n

      \n
    • Is the content easy to find by foraging through a documentation site, or is it impossible to find manually?<\/li>\n\n\n\n
    • How well does the search function work, and how do you optimize it for content findability? (Do we need better indexing, tags, filtering, etc.?)<\/li>\n<\/ul>\n\n\n\n

      Content Reusability<\/h3>\n\n\n\n

      This deals with which content can be reused across multiple guides and how we can best implement it in practice. It is especially important for companies that generate a lot of content that needs to be maintained and kept up to date <\/strong>with as little effort as possible.<\/p>\n\n\n\n

      Information Architecture<\/h3>\n\n\n\n

      This is how to organize content into content buckets (for instance, which articles we need in a Getting Started bucket).<\/p>\n\n\n\n

      User Journey<\/h3>\n\n\n\n

      This is how to navigate through content and link it in a logical way for a quality user experience.<\/p>\n\n\n\n

      As you can see, by adopting a decoupled frontend and backend approach, the technical content team can maximize their productivity and deliver high-quality content.<\/p>\n\n\n\n

      Stored in a Version Control System<\/h2>\n\n\n\n

      The Docs as Code approach embraces the practice of storing documentation in a version control system, leveraging a system the development team already uses.<\/p>\n\n\n\n

      It is important to highlight that the version control system needs to be git-based<\/strong>. A Docs as Code approach assumes that documentation should follow a similar workflow and versioning system as the codebase. By using a git-based product or a similar VCS, technical writers can branch, merge and track changes to the documentation just like developers do with their code.<\/p>\n\n\n\n

      This consistency in version control practices ensures that documentation evolves alongside the software, keeping it up-to-date and relevant.<\/p>\n\n\n\n

      Uses Automated Testing and Deployment Tools<\/h2>\n\n\n\n

      The Docs as Code approach uses automated testing and deployment tools to streamline a documentation development and publication process.<\/p>\n\n\n\n

      It adopts a standard deployment process and uses something easily manageable to publish the docs from the source files, like a static site generator. That, together with automation tools running checks without the need for a human to do it manually, allows a documentation team to adhere to the principles of CI\/CD, just like their developer colleagues.<\/strong><\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      Goes through a Peer Review<\/h2>\n\n\n\n

      Having docs peer review sitting at the same level as code peer review,<\/strong> we make sure documentation is not treated any differently from code, making it harder to omit in the entire developer cycle.<\/p>\n\n\n\n

      One of the key advantages of a Docs as Code peer review is its seamless ability to incorporate feedback from multiple reviewers. Typically, a standard documentation review involves another technical author performing an editorial review and a review from a subject-matter expert, often a developer who worked on the feature.<\/p>\n\n\n\n

      This is fine for an initial handover, but it doesn\u2019t provide an objective story. It\u2019s like asking a parent to describe their child objectively. They can\u2019t, because they created it, shaped it, put a lot of time and effort into its development and are very proud of it.<\/p>\n\n\n\n

      This is why inviting other stakeholders to the proverbial review table is important so they can pitch in their unique perspectives.<\/p>\n\n\n\n

      And just like that, a single-minded document suddenly becomes an exhaustive and user-inclusive experience. Moreover, such practice raises awareness. People now know where to look for more information to share with their customers. And since they\u2019ve been involved personally, they feel pride and ownership, so they\u2019re keener to share that knowledge.<\/p>\n\n\n\n

      A Docs as Code Approach in a Developer Cycle<\/h2>\n\n\n\n

      The main assumption of how a Docs as Code approach should be implemented in a developer cycle is that you\u2019d have one universal environment into which both docs and code are incorporated in a similar manner.<\/p>\n\n\n\n

      By implementing a shared environment for documentation and code, technical teams can streamline collaboration, improve communication and maintain consistency throughout the development cycle.<\/p>\n\n\n\n

      How to Fit Docs as Code in a Developer Cycle?<\/h2>\n\n\n\n

      It requires careful planning and coordination between technical writers and development teams. It warrants a lot of openness and transparency so that all stakeholders can follow the most efficient process and practices, which depend greatly on the company\u2019s resources.<\/p>\n\n\n\n

      When do we write docs? When do we review them? Let\u2019s see how you can strap the entire documentation cycle to a developer one.<\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      1. Analysis<\/strong><\/h3>\n\n\n\n

      When developers are in their planning phase, technical writers can already start planning as well. They would identify which existing documents need changes and see how much new content will be needed. At this stage, they can already give a rough estimate of the time they will need to create a complete set of documents needed for the feature in question.<\/p>\n\n\n\n

      By estimating the effort, the documentation team takes away the mysterious element of the \u201cit will be ready when it\u2019s ready\u201d attitude <\/strong>and can commit to concrete deadlines based on their own estimates.<\/p>\n\n\n\n

      This practice protects both teams, the authors and the developers. The writers would never face a short and inhumane deadline anymore just because somebody remembered about documentation a couple of days before release day.<\/p>\n\n\n\n

      2. Design<\/strong><\/h3>\n\n\n\n

      During a design phase, technical writers can already start thinking about their own design \u2014 how they want to present information, what\u2019s the ideal user journey, what type of content is needed, how to map it to the existing content.<\/p>\n\n\n\n

      3. Implementation<\/strong><\/h3>\n\n\n\n

      Once the feature is being implemented, technical authors can start writing. For obvious reasons, this phase will not align perfectly with the implementation one but rather start at the very end of it, most likely during the bug-bashing phase, in which the authors can participate themselves to get familiar with the feature.<\/p>\n\n\n\n

      4. Testing<\/strong><\/h3>\n\n\n\n

      Similar to developers, for technical writers, the testing phase is the time for last-minute improvements to their creations. That\u2019s exactly when they would start inviting stakeholders for peer review<\/strong> and go through a review cycle with them. Since we\u2019re propagating a Docs as Code approach, each document will have several reviewers and go through several review cycles simultaneously.<\/p>\n\n\n\n

      5. Release<\/strong><\/h3>\n\n\n\n

      Both documentation and code are released together on the same day. Since documentation hasn\u2019t been treated as an afterthought and technical writers were there every step of the cycle, documentation is well-planned, well-thought out, comprehensive and written with a user in mind.<\/strong><\/p>\n\n\n\n

      6. Maintenance<\/strong><\/h3>\n\n\n\n

      Again, documentation and code enter a maintenance phase together, and it looks similar for both. Anybody who spots an issue opens a ticket that\u2019s triaged by a team, prioritized and resolved.<\/strong> Likewise, anybody who sees an opportunity for an improvement opens a pull request and contributes to either code or documentation.<\/p>\n\n\n\n

      Key Takeaways<\/h2>\n\n\n\n

      Overall, adopting a Docs as Code approach and incorporating peer review as an integral part of the development cycle enhances the quality of technical documentation, improves collaboration between teams and ensures documentation is given the attention it deserves throughout the entire software development process.<\/p>\n","protected":false},"excerpt":{"rendered":"

      It enhances the quality of technical documentation, improves collaboration between teams and ensures documentation is given the attention it deserves.<\/p>\n","protected":false},"author":3,"featured_media":2475,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_import_markdown_pro_load_document_selector":0,"_import_markdown_pro_submit_text_textarea":"","footnotes":""},"categories":[28,254],"tags":[46,144,41],"coauthors":[134],"class_list":["post-2468","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-blog-post","category-engineering-practices","tag-developer-docs","tag-developer-ecosystem","tag-developer-practices"],"acf":[],"yoast_head":"\nWhy Docs as Code Should Be Part of Your Dev Cycle<\/title>\n<meta name=\"description\" content=\"Docs as Code enhances the quality of technical documentation, improves collaboration between teams and ensures streamlined documentation.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Why Docs as Code Should Be Part of Your Dev Cycle\" \/>\n<meta property=\"og:description\" content=\"Docs as Code enhances the quality of technical documentation, improves collaboration between teams and ensures streamlined documentation.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle\" \/>\n<meta property=\"og:site_name\" content=\"Infobip Developers Hub\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/infobip\/\" \/>\n<meta property=\"article:published_time\" content=\"2023-08-30T09:03:31+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2023-09-11T14:27:10+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.infobip.com\/developers\/wp-content\/uploads\/2023\/08\/hand-holding-wooden-puzzle-with-file-icon-2022-09-15-02-22-47-utc-scaled.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"2560\" \/>\n\t<meta property=\"og:image:height\" content=\"1706\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Joanna Suau\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@JoannaSuau\" \/>\n<meta name=\"twitter:site\" content=\"@InfobipDev\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Joanna Suau\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle\"},\"author\":{\"name\":\"Joanna Suau\",\"@id\":\"https:\/\/www.infobip.com\/developers\/#\/schema\/person\/707842627f046bb5722c37a9fdc85d62\"},\"headline\":\"Why Docs as Code Should Be Part of Your Dev Cycle\",\"datePublished\":\"2023-08-30T09:03:31+00:00\",\"dateModified\":\"2023-09-11T14:27:10+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle\"},\"wordCount\":1819,\"publisher\":{\"@id\":\"https:\/\/www.infobip.com\/developers\/#organization\"},\"image\":{\"@id\":\"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.infobip.com\/developers\/wp-content\/uploads\/2023\/08\/hand-holding-wooden-puzzle-with-file-icon-2022-09-15-02-22-47-utc-scaled.jpg\",\"keywords\":[\"developer docs\",\"developer ecosystem\",\"developer practices\"],\"articleSection\":[\"Blog Post\",\"Engineering Practices\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle\",\"url\":\"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle\",\"name\":\"Why Docs as Code Should Be Part of Your Dev Cycle\",\"isPartOf\":{\"@id\":\"https:\/\/www.infobip.com\/developers\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle#primaryimage\"},\"image\":{\"@id\":\"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.infobip.com\/developers\/wp-content\/uploads\/2023\/08\/hand-holding-wooden-puzzle-with-file-icon-2022-09-15-02-22-47-utc-scaled.jpg\",\"datePublished\":\"2023-08-30T09:03:31+00:00\",\"dateModified\":\"2023-09-11T14:27:10+00:00\",\"description\":\"Docs as Code enhances the quality of technical documentation, improves collaboration between teams and ensures streamlined documentation.\",\"breadcrumb\":{\"@id\":\"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle#primaryimage\",\"url\":\"https:\/\/www.infobip.com\/developers\/wp-content\/uploads\/2023\/08\/hand-holding-wooden-puzzle-with-file-icon-2022-09-15-02-22-47-utc-scaled.jpg\",\"contentUrl\":\"https:\/\/www.infobip.com\/developers\/wp-content\/uploads\/2023\/08\/hand-holding-wooden-puzzle-with-file-icon-2022-09-15-02-22-47-utc-scaled.jpg\",\"width\":2560,\"height\":1706},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.infobip.com\/developers\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Why Docs as Code Should Be Part of Your Dev Cycle\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.infobip.com\/developers\/#website\",\"url\":\"https:\/\/www.infobip.com\/developers\/\",\"name\":\"Infobip Developers Hub\",\"description\":\"Build meaningful customer relationships across any channel\",\"publisher\":{\"@id\":\"https:\/\/www.infobip.com\/developers\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.infobip.com\/developers\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.infobip.com\/developers\/#organization\",\"name\":\"Infobip Developers Hub\",\"url\":\"https:\/\/www.infobip.com\/developers\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.infobip.com\/developers\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.infobip.com\/developers\/wp-content\/uploads\/2023\/03\/Infobip_logo_favicon.png\",\"contentUrl\":\"https:\/\/www.infobip.com\/developers\/wp-content\/uploads\/2023\/03\/Infobip_logo_favicon.png\",\"width\":696,\"height\":696,\"caption\":\"Infobip Developers Hub\"},\"image\":{\"@id\":\"https:\/\/www.infobip.com\/developers\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/infobip\/\",\"https:\/\/x.com\/InfobipDev\",\"https:\/\/www.youtube.com\/channel\/UCUPSTy53VecI5GIir3J3ZbQ\",\"https:\/\/github.com\/infobip-community\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.infobip.com\/developers\/#\/schema\/person\/707842627f046bb5722c37a9fdc85d62\",\"name\":\"Joanna Suau\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.infobip.com\/developers\/#\/schema\/person\/image\/cccb05b0dfa8fde5d00a09f4047f929e\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/b632afa61f1a27c1a0d823a9ec17eeb047cf476c570012dd90ba88a1bb9b1585?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/b632afa61f1a27c1a0d823a9ec17eeb047cf476c570012dd90ba88a1bb9b1585?s=96&d=mm&r=g\",\"caption\":\"Joanna Suau\"},\"description\":\"Joanna is a Developer Educator at Infobip, working in the Developer Relations team.\",\"sameAs\":[\"https:\/\/medium.com\/@joanna.suau\",\"https:\/\/www.linkedin.com\/in\/joannasuau\/\",\"https:\/\/x.com\/JoannaSuau\"],\"url\":\"https:\/\/www.infobip.com\/developers\/blog\/author\/joanna\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Why Docs as Code Should Be Part of Your Dev Cycle","description":"Docs as Code enhances the quality of technical documentation, improves collaboration between teams and ensures streamlined documentation.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle","og_locale":"en_US","og_type":"article","og_title":"Why Docs as Code Should Be Part of Your Dev Cycle","og_description":"Docs as Code enhances the quality of technical documentation, improves collaboration between teams and ensures streamlined documentation.","og_url":"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle","og_site_name":"Infobip Developers Hub","article_publisher":"https:\/\/www.facebook.com\/infobip\/","article_published_time":"2023-08-30T09:03:31+00:00","article_modified_time":"2023-09-11T14:27:10+00:00","og_image":[{"width":2560,"height":1706,"url":"https:\/\/www.infobip.com\/developers\/wp-content\/uploads\/2023\/08\/hand-holding-wooden-puzzle-with-file-icon-2022-09-15-02-22-47-utc-scaled.jpg","type":"image\/jpeg"}],"author":"Joanna Suau","twitter_card":"summary_large_image","twitter_creator":"@JoannaSuau","twitter_site":"@InfobipDev","twitter_misc":{"Written by":"Joanna Suau"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle#article","isPartOf":{"@id":"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle"},"author":{"name":"Joanna Suau","@id":"https:\/\/www.infobip.com\/developers\/#\/schema\/person\/707842627f046bb5722c37a9fdc85d62"},"headline":"Why Docs as Code Should Be Part of Your Dev Cycle","datePublished":"2023-08-30T09:03:31+00:00","dateModified":"2023-09-11T14:27:10+00:00","mainEntityOfPage":{"@id":"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle"},"wordCount":1819,"publisher":{"@id":"https:\/\/www.infobip.com\/developers\/#organization"},"image":{"@id":"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle#primaryimage"},"thumbnailUrl":"https:\/\/www.infobip.com\/developers\/wp-content\/uploads\/2023\/08\/hand-holding-wooden-puzzle-with-file-icon-2022-09-15-02-22-47-utc-scaled.jpg","keywords":["developer docs","developer ecosystem","developer practices"],"articleSection":["Blog Post","Engineering Practices"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle","url":"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle","name":"Why Docs as Code Should Be Part of Your Dev Cycle","isPartOf":{"@id":"https:\/\/www.infobip.com\/developers\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle#primaryimage"},"image":{"@id":"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle#primaryimage"},"thumbnailUrl":"https:\/\/www.infobip.com\/developers\/wp-content\/uploads\/2023\/08\/hand-holding-wooden-puzzle-with-file-icon-2022-09-15-02-22-47-utc-scaled.jpg","datePublished":"2023-08-30T09:03:31+00:00","dateModified":"2023-09-11T14:27:10+00:00","description":"Docs as Code enhances the quality of technical documentation, improves collaboration between teams and ensures streamlined documentation.","breadcrumb":{"@id":"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle#primaryimage","url":"https:\/\/www.infobip.com\/developers\/wp-content\/uploads\/2023\/08\/hand-holding-wooden-puzzle-with-file-icon-2022-09-15-02-22-47-utc-scaled.jpg","contentUrl":"https:\/\/www.infobip.com\/developers\/wp-content\/uploads\/2023\/08\/hand-holding-wooden-puzzle-with-file-icon-2022-09-15-02-22-47-utc-scaled.jpg","width":2560,"height":1706},{"@type":"BreadcrumbList","@id":"https:\/\/www.infobip.com\/developers\/blog\/why-docs-as-code-should-be-part-of-your-dev-cycle#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.infobip.com\/developers\/"},{"@type":"ListItem","position":2,"name":"Why Docs as Code Should Be Part of Your Dev Cycle"}]},{"@type":"WebSite","@id":"https:\/\/www.infobip.com\/developers\/#website","url":"https:\/\/www.infobip.com\/developers\/","name":"Infobip Developers Hub","description":"Build meaningful customer relationships across any channel","publisher":{"@id":"https:\/\/www.infobip.com\/developers\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.infobip.com\/developers\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.infobip.com\/developers\/#organization","name":"Infobip Developers Hub","url":"https:\/\/www.infobip.com\/developers\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.infobip.com\/developers\/#\/schema\/logo\/image\/","url":"https:\/\/www.infobip.com\/developers\/wp-content\/uploads\/2023\/03\/Infobip_logo_favicon.png","contentUrl":"https:\/\/www.infobip.com\/developers\/wp-content\/uploads\/2023\/03\/Infobip_logo_favicon.png","width":696,"height":696,"caption":"Infobip Developers Hub"},"image":{"@id":"https:\/\/www.infobip.com\/developers\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/infobip\/","https:\/\/x.com\/InfobipDev","https:\/\/www.youtube.com\/channel\/UCUPSTy53VecI5GIir3J3ZbQ","https:\/\/github.com\/infobip-community"]},{"@type":"Person","@id":"https:\/\/www.infobip.com\/developers\/#\/schema\/person\/707842627f046bb5722c37a9fdc85d62","name":"Joanna Suau","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.infobip.com\/developers\/#\/schema\/person\/image\/cccb05b0dfa8fde5d00a09f4047f929e","url":"https:\/\/secure.gravatar.com\/avatar\/b632afa61f1a27c1a0d823a9ec17eeb047cf476c570012dd90ba88a1bb9b1585?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/b632afa61f1a27c1a0d823a9ec17eeb047cf476c570012dd90ba88a1bb9b1585?s=96&d=mm&r=g","caption":"Joanna Suau"},"description":"Joanna is a Developer Educator at Infobip, working in the Developer Relations team.","sameAs":["https:\/\/medium.com\/@joanna.suau","https:\/\/www.linkedin.com\/in\/joannasuau\/","https:\/\/x.com\/JoannaSuau"],"url":"https:\/\/www.infobip.com\/developers\/blog\/author\/joanna"}]}},"_links":{"self":[{"href":"https:\/\/www.infobip.com\/developers\/wp-json\/wp\/v2\/posts\/2468","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.infobip.com\/developers\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.infobip.com\/developers\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.infobip.com\/developers\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/www.infobip.com\/developers\/wp-json\/wp\/v2\/comments?post=2468"}],"version-history":[{"count":2,"href":"https:\/\/www.infobip.com\/developers\/wp-json\/wp\/v2\/posts\/2468\/revisions"}],"predecessor-version":[{"id":2476,"href":"https:\/\/www.infobip.com\/developers\/wp-json\/wp\/v2\/posts\/2468\/revisions\/2476"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.infobip.com\/developers\/wp-json\/wp\/v2\/media\/2475"}],"wp:attachment":[{"href":"https:\/\/www.infobip.com\/developers\/wp-json\/wp\/v2\/media?parent=2468"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.infobip.com\/developers\/wp-json\/wp\/v2\/categories?post=2468"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.infobip.com\/developers\/wp-json\/wp\/v2\/tags?post=2468"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/www.infobip.com\/developers\/wp-json\/wp\/v2\/coauthors?post=2468"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}