{"id":23523,"date":"2021-03-02T23:32:56","date_gmt":"2021-03-02T15:32:56","guid":{"rendered":"https:\/\/www.hongkiat.com\/blog\/?p=23523"},"modified":"2021-03-02T15:42:42","modified_gmt":"2021-03-02T07:42:42","slug":"why-documentation-essential","status":"publish","type":"post","link":"https:\/\/www.hongkiat.com\/blog\/why-documentation-essential\/","title":{"rendered":"The Importance of Documentation for Web Developers"},"content":{"rendered":"<p>In the development realm of mobile, web, and desktop apps or JavaScript libraries, documentation plays an important role in determining the app\u2019s success. But if you have ever done documentation, you\u2019d agree with me that it is pretty much the least favorite thing for developers to do.<\/p>\n<p>Unlike writing code (which is what developers signed up to do), documentation has to be easily digested by <em>everyone<\/em>. Technically, we have to translate a machine language (code) into a language that is understandable to humans, which is tougher than it sounds.<\/p>\n<p>Although it can be a real burdensome, writing the documentation is important and will deliver advantages for your users, your colleagues, and especially yourself.<\/p>\n<div class=\"ref-block ref-block--post\" id=\"ref-post-1\">\n\t\t\t\t\t<a href=\"https:\/\/www.hongkiat.com\/blog\/programming-myth\/\" class=\"ref-block__link\" title=\"Read More: Learning Programming: 10 Misconceptions That Are Not True\" rel=\"bookmark\"><span class=\"screen-reader-text\">Learning Programming: 10 Misconceptions That Are Not True<\/span><\/a>\n<div class=\"ref-block__thumbnail img-thumb img-thumb--jumbo\" data-img='{ \"src\" : \"https:\/\/assets.hongkiat.com\/uploads\/thumbs\/250x160\/programming-myth.jpg\" }'>\n\t\t\t\t\t\t\t<noscript>\n<style>.no-js #ref-block-post-18138 .ref-block__thumbnail { background-image: url(\"https:\/\/assets.hongkiat.com\/uploads\/thumbs\/250x160\/programming-myth.jpg\"); }<\/style>\n<\/noscript>\n\t\t\t\t\t\t<\/div>\n<div class=\"ref-block__summary\">\n<h4 class=\"ref-title\">Learning Programming: 10 Misconceptions That Are Not True<\/h4>\n<p class=\"ref-description\">\n\t\t\t\t\t\tThere are plenty of misconceptions and myths surrounding the art of programming. Many people view it as a...\t\t\t\t\t\t<span>Read more<\/span><\/p>\n<\/div>\n<\/div>\n<h2>Good Documentation Helps Users<\/h2>\n<p>Documentation helps the reader <strong>understand how a code works<\/strong>, obviously. But many developers make the mistake of assuming that the users of the software will be proficient.<\/p>\n<p>Hence, the documentation may be thin material, skipping a lot of the essentials it should have contained from the beginning. If you are savvy in the language, you can figure things out on your own initiative; if you are not, then you are lost.<\/p>\n<p>Documentation intended for users usually consists of practical use or the \u201chow-to\u201d. The rule of thumb when creating documentation for general users is that <strong>it should be clear-cut<\/strong>. Using human-friendly words is preferable to technical terms or jargon. Real use examples will also be greatly appreciated.<\/p>\n<p>A good layout design would also really help users scan through each section of the documentation without eye-strain. A few good examples (aka my favorites) are documentation for <a rel=\"nofollow noopener\" target=\"_blank\" href=\"https:\/\/getbootstrap.com\/docs\/3.4\/css\/\">Bootstrap<\/a> and <a rel=\"nofollow noopener\" target=\"_blank\" href=\"https:\/\/codex.wordpress.org\/First_Steps_With_WordPress\">WordPress<\/a>\u2018 \u201cFirst Steps With WordPress\u201d.<\/p>\n<h2>It helps fellow developers<\/h2>\n<p>Each developer will have his own coding style. But, when it comes to working in a team, we will often have to share codes with other teammates. So it is essential to <strong>have a consensus on a standard<\/strong> to keep everyone on the same page. A properly written documentation would be the reference the team needs<\/p>\n<p>But unlike end-user documentation, this documentation typically describes <strong>technical procedures<\/strong> like the code-naming convention, showing how particular pages should be constructed, and how the API works along with the code examples. Often we would also have to write the documentation inline with the code (known as the <em>comments<\/em>) to describe what the code is doing.<\/p>\n<p>In addition, in the case where you have <strong>new members joining<\/strong> your team later, this documentation could be a time-effective way to train them, so you don\u2019t have to give them a 1-on-1 run down on the code.<\/p>\n<div class=\"ref-block ref-block--post\" id=\"ref-post-2\">\n\t\t\t\t\t<a href=\"https:\/\/www.hongkiat.com\/blog\/developer-habits\/\" class=\"ref-block__link\" title=\"Read More: 10 Programming Habits Developers Should Adopt\" rel=\"bookmark\"><span class=\"screen-reader-text\">10 Programming Habits Developers Should Adopt<\/span><\/a>\n<div class=\"ref-block__thumbnail img-thumb img-thumb--jumbo\" data-img='{ \"src\" : \"https:\/\/assets.hongkiat.com\/uploads\/thumbs\/250x160\/developer-habits.jpg\" }'>\n\t\t\t\t\t\t\t<noscript>\n<style>.no-js #ref-block-post-19516 .ref-block__thumbnail { background-image: url(\"https:\/\/assets.hongkiat.com\/uploads\/thumbs\/250x160\/developer-habits.jpg\"); }<\/style>\n<\/noscript>\n\t\t\t\t\t\t<\/div>\n<div class=\"ref-block__summary\">\n<h4 class=\"ref-title\">10 Programming Habits Developers Should Adopt<\/h4>\n<p class=\"ref-description\">\n\t\t\t\t\t\tThese outcomes can bring down our confidence but in fact, they can be solved with proper development practices....\t\t\t\t\t\t<span>Read more<\/span><\/p>\n<\/div>\n<\/div>\n<h2>It also helps the coder himself<\/h2>\n<p>The funny thing about coding is that sometimes <strong>even the developers themselves do not comprehend the code that they have written<\/strong>. This is particularly true in cases where the codes have been left untouched for months or even years.<\/p>\n<p>A sudden need to revisit the codes for one reason or another would leave one wondering what was going on in their minds when they wrote these codes. Don\u2019t be surprised: I\u2019ve been in this situation before. <strong>This is <em>precisely<\/em> when I <em>wished<\/em> I had documented my code properly<\/strong>.<\/p>\n<p>By documenting your codes, you will be able to get to the bottom of your codes quickly and without frustration, saving you a lot of your time that can be spent on getting the changes done.<\/p>\n<h2>What makes for good documentation?<\/h2>\n<p>There are several factors that help in building a good piece of documentation. Some of the most important ones are as follows:<\/p>\n<h3>1. Never assume<\/h3>\n<p>Don\u2019t assume that your users know what <em>you<\/em> know as well as what <em>they<\/em> want to know. It is always better <strong>to start from the very beginning<\/strong> regardless of the users\u2019 proficiency level.<\/p>\n<p>If you built a jQuery plugin, for example, you may take inspiration from <a href=\"https:\/\/kenwheeler.github.io\/slick\/\">SlickJS<\/a>\u2018s documentation. It shows how to structure the HTML, where to put the CSS and the JavaScript, how to initialize the jQuery plugin at its most basic level, and even shows the complete final markup after adding all these stuff, which is something obvious.<\/p>\n<figure><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/assets.hongkiat.com\/uploads\/why-documentation-essential\/doc-example.jpg\" alt=\"doc examples\" width=\"547\" height=\"293\"><\/figure>\n<p>The bottom line is that the documentation is written with the thought process of a user, not a developer. Approaching your own documentation this way will give you a better perspective in organizing your own piece.<\/p>\n<h3>2. Follow the standard<\/h3>\n<p>In adding documentation that goes inline with the code, <strong>use the standard expected of the  language<\/strong>. It is always a good idea to describe each function, the variables, as well as the value returned by the function. Here is an example of good inline documentation for PHP.<\/p>\n<pre>\r\n\/**\r\n * Adds custom classes to the array of body classes.\r\n *\r\n * @param array $classes Classes for the body element.\r\n * @return array\r\n *\/\r\nfunction body_classes( $classes ) {\r\n\t\/\/ Adds a class of group-blog to blogs with more than 1 published author.\r\n\tif ( is_multi_author() ) {\r\n\t\t$classes[] = 'group-blog';\r\n\t}\r\n\r\n\treturn $classes;\r\n}\r\nadd_filter( 'body_class', 'body_classes' );\r\n<\/pre>\n<p>The following are a few references for formatting inline documentation with best practices in PHP, JavaScript and CSS:<\/p>\n<ul>\n<li><strong>PHP<\/strong>: <a rel=\"nofollow noopener\" target=\"_blank\" href=\"https:\/\/make.wordpress.org\/core\/handbook\/best-practices\/inline-documentation-standards\/php\/\">PHP Documentation Standard for WordPress<\/a><\/li>\n<li><strong>JavaScript<\/strong>: <a rel=\"nofollow noopener\" target=\"_blank\" href=\"https:\/\/jsdoc.app\/\">UseJSDoc<\/a><\/li>\n<li><strong>CSS<\/strong>: <a rel=\"nofollow noopener\" target=\"_blank\" href=\"https:\/\/github.com\/tkadauke\/css_doc\">CSSDoc<\/a><\/li>\n<\/ul>\n<p>If you are using SublimeText I would suggest to install <a rel=\"nofollow noopener\" target=\"_blank\" href=\"https:\/\/github.com\/spadgos\/sublime-jsdocs\">DocBlockr<\/a> that will cleverly pre-populate your code with inline documentation.<\/p>\n<div class=\"ref-block ref-block--post\" id=\"ref-post-3\">\n\t\t\t\t\t<a href=\"https:\/\/www.hongkiat.com\/blog\/wordpress-coding-standard\/\" class=\"ref-block__link\" title=\"Read More: WordPress Coding Standards: A Guide for Developers\" rel=\"bookmark\"><span class=\"screen-reader-text\">WordPress Coding Standards: A Guide for Developers<\/span><\/a>\n<div class=\"ref-block__thumbnail img-thumb img-thumb--jumbo\" data-img='{ \"src\" : \"https:\/\/assets.hongkiat.com\/uploads\/thumbs\/250x160\/wordpress-coding-standard.jpg\" }'>\n\t\t\t\t\t\t\t<noscript>\n<style>.no-js #ref-block-post-23292 .ref-block__thumbnail { background-image: url(\"https:\/\/assets.hongkiat.com\/uploads\/thumbs\/250x160\/wordpress-coding-standard.jpg\"); }<\/style>\n<\/noscript>\n\t\t\t\t\t\t<\/div>\n<div class=\"ref-block__summary\">\n<h4 class=\"ref-title\">WordPress Coding Standards: A Guide for Developers<\/h4>\n<p class=\"ref-description\">\n\t\t\t\t\t\tThe reason that we have coding standards at all (not just for WordPress) is to create a familiar...\t\t\t\t\t\t<span>Read more<\/span><\/p>\n<\/div>\n<\/div>\n<h3>3. Graphical elements<\/h3>\n<p>Use graphical elements, they speak better than text. These media come in useful, particularly if you build software with graphical interface. You can add pointing elements like arrows, circle, or <strong>anything that may help users to figure out where to go to accomplish the steps, without guesswork<\/strong>.<\/p>\n<p>The following is an example from the Tower app where you can draw inspiration from. They efficiently explain what how version control works in a pleasing way that makes it more understandable than using plain text command lines.<\/p>\n<p class=\"video-19by6\"><iframe loading=\"lazy\" width=\"600\" height=\"338\" src=\"https:\/\/www.youtube.com\/embed\/e8PGuOyZ3YU?rel=0&showinfo=0\" frameborder=\"0\" allowfullscreen><\/iframe><\/p>\n<h3>4. Sectioning<\/h3>\n<p>You may consider wrapping a few things in the documentation within bulleted lists and tables as this makes longer content easier to scan and read for users.<\/p>\n<p>Add a table of content and split the documentation in easily digestible sections, yet keeping each section relevant with what comes next. <strong>Keep it short and straightforward<\/strong>. Below is an example of nicely organized documentation in <a rel=\"nofollow noopener\" target=\"_blank\" href=\"https:\/\/developers.facebook.com\/docs\/sharing\/ios\">Facebook<\/a>. The table of contents takes us where we want to jump to in a click.<\/p>\n<figure><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/assets.hongkiat.com\/uploads\/why-documentation-essential\/doc-example-facebook.jpg\" alt=\"doc example facebook\" width=\"700\" height=\"378\"><\/figure>\n<h3>5. Revise and Update<\/h3>\n<p>Lastly, review the documentation for mistakes and revise when necessary or and whenever there are significant changes to the product, software, or library. Your documentation would be of no use to anyone if not regularly updated alongside your product.<\/p>","protected":false},"excerpt":{"rendered":"<p>In the development realm of mobile, web, and desktop apps or JavaScript libraries, documentation plays an important role in determining the app\u2019s success. But if you have ever done documentation, you\u2019d agree with me that it is pretty much the least favorite thing for developers to do. Unlike writing code (which is what developers signed&hellip;<\/p>\n","protected":false},"author":113,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[352],"tags":[511],"topic":[4520],"class_list":["entry-content","is-maxi"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v22.8 (Yoast SEO v27.4) - https:\/\/yoast.com\/product\/yoast-seo-premium-wordpress\/ -->\n<title>The Importance of Documentation for Web Developers - Hongkiat<\/title>\n<meta name=\"description\" content=\"In the development realm of mobile, web, and desktop apps or JavaScript libraries, documentation plays an important role in determining the app&#039;s success.\" \/>\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.hongkiat.com\/blog\/why-documentation-essential\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"The Importance of Documentation for Web Developers\" \/>\n<meta property=\"og:description\" content=\"In the development realm of mobile, web, and desktop apps or JavaScript libraries, documentation plays an important role in determining the app&#039;s success.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.hongkiat.com\/blog\/why-documentation-essential\/\" \/>\n<meta property=\"og:site_name\" content=\"Hongkiat\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/hongkiatcom\" \/>\n<meta property=\"article:published_time\" content=\"2021-03-02T15:32:56+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/assets.hongkiat.com\/uploads\/why-documentation-essential\/doc-example.jpg\" \/>\n<meta name=\"author\" content=\"Thoriq Firdaus\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@tfirdaus\" \/>\n<meta name=\"twitter:site\" content=\"@hongkiat\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Thoriq Firdaus\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/why-documentation-essential\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/why-documentation-essential\\\/\"},\"author\":{\"name\":\"Thoriq Firdaus\",\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/#\\\/schema\\\/person\\\/e7948c7a175d211496331e4b6ce55807\"},\"headline\":\"The Importance of Documentation for Web Developers\",\"datePublished\":\"2021-03-02T15:32:56+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/why-documentation-essential\\\/\"},\"wordCount\":1036,\"commentCount\":10,\"publisher\":{\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/why-documentation-essential\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/assets.hongkiat.com\\\/uploads\\\/why-documentation-essential\\\/doc-example.jpg\",\"keywords\":[\"Web Developers\"],\"articleSection\":[\"Web Design\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/why-documentation-essential\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/why-documentation-essential\\\/\",\"url\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/why-documentation-essential\\\/\",\"name\":\"The Importance of Documentation for Web Developers - Hongkiat\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/why-documentation-essential\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/why-documentation-essential\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/assets.hongkiat.com\\\/uploads\\\/why-documentation-essential\\\/doc-example.jpg\",\"datePublished\":\"2021-03-02T15:32:56+00:00\",\"description\":\"In the development realm of mobile, web, and desktop apps or JavaScript libraries, documentation plays an important role in determining the app's success.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/why-documentation-essential\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/why-documentation-essential\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/why-documentation-essential\\\/#primaryimage\",\"url\":\"https:\\\/\\\/assets.hongkiat.com\\\/uploads\\\/why-documentation-essential\\\/doc-example.jpg\",\"contentUrl\":\"https:\\\/\\\/assets.hongkiat.com\\\/uploads\\\/why-documentation-essential\\\/doc-example.jpg\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/why-documentation-essential\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"The Importance of Documentation for Web Developers\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/#website\",\"url\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/\",\"name\":\"Hongkiat\",\"description\":\"Tech and Design Tips\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/#organization\",\"name\":\"Hongkiat.com\",\"url\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/wp-content\\\/uploads\\\/hkdc-logo-rect-yoast.jpg\",\"contentUrl\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/wp-content\\\/uploads\\\/hkdc-logo-rect-yoast.jpg\",\"width\":1200,\"height\":799,\"caption\":\"Hongkiat.com\"},\"image\":{\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/www.facebook.com\\\/hongkiatcom\",\"https:\\\/\\\/x.com\\\/hongkiat\",\"https:\\\/\\\/www.pinterest.com\\\/hongkiat\\\/\"]},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/#\\\/schema\\\/person\\\/e7948c7a175d211496331e4b6ce55807\",\"name\":\"Thoriq Firdaus\",\"description\":\"Thoriq is a writer for Hongkiat.com with a passion for web design and development. He is the author of Responsive Web Design by Examples, where he covered his best approaches in developing responsive websites quickly with a framework.\",\"sameAs\":[\"https:\\\/\\\/thoriq.com\",\"https:\\\/\\\/x.com\\\/tfirdaus\"],\"jobTitle\":\"Web Developer\",\"url\":\"https:\\\/\\\/www.hongkiat.com\\\/blog\\\/author\\\/thoriq\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"The Importance of Documentation for Web Developers - Hongkiat","description":"In the development realm of mobile, web, and desktop apps or JavaScript libraries, documentation plays an important role in determining the app's success.","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.hongkiat.com\/blog\/why-documentation-essential\/","og_locale":"en_US","og_type":"article","og_title":"The Importance of Documentation for Web Developers","og_description":"In the development realm of mobile, web, and desktop apps or JavaScript libraries, documentation plays an important role in determining the app's success.","og_url":"https:\/\/www.hongkiat.com\/blog\/why-documentation-essential\/","og_site_name":"Hongkiat","article_publisher":"https:\/\/www.facebook.com\/hongkiatcom","article_published_time":"2021-03-02T15:32:56+00:00","og_image":[{"url":"https:\/\/assets.hongkiat.com\/uploads\/why-documentation-essential\/doc-example.jpg","type":"","width":"","height":""}],"author":"Thoriq Firdaus","twitter_card":"summary_large_image","twitter_creator":"@tfirdaus","twitter_site":"@hongkiat","twitter_misc":{"Written by":"Thoriq Firdaus","Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.hongkiat.com\/blog\/why-documentation-essential\/#article","isPartOf":{"@id":"https:\/\/www.hongkiat.com\/blog\/why-documentation-essential\/"},"author":{"name":"Thoriq Firdaus","@id":"https:\/\/www.hongkiat.com\/blog\/#\/schema\/person\/e7948c7a175d211496331e4b6ce55807"},"headline":"The Importance of Documentation for Web Developers","datePublished":"2021-03-02T15:32:56+00:00","mainEntityOfPage":{"@id":"https:\/\/www.hongkiat.com\/blog\/why-documentation-essential\/"},"wordCount":1036,"commentCount":10,"publisher":{"@id":"https:\/\/www.hongkiat.com\/blog\/#organization"},"image":{"@id":"https:\/\/www.hongkiat.com\/blog\/why-documentation-essential\/#primaryimage"},"thumbnailUrl":"https:\/\/assets.hongkiat.com\/uploads\/why-documentation-essential\/doc-example.jpg","keywords":["Web Developers"],"articleSection":["Web Design"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.hongkiat.com\/blog\/why-documentation-essential\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.hongkiat.com\/blog\/why-documentation-essential\/","url":"https:\/\/www.hongkiat.com\/blog\/why-documentation-essential\/","name":"The Importance of Documentation for Web Developers - Hongkiat","isPartOf":{"@id":"https:\/\/www.hongkiat.com\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.hongkiat.com\/blog\/why-documentation-essential\/#primaryimage"},"image":{"@id":"https:\/\/www.hongkiat.com\/blog\/why-documentation-essential\/#primaryimage"},"thumbnailUrl":"https:\/\/assets.hongkiat.com\/uploads\/why-documentation-essential\/doc-example.jpg","datePublished":"2021-03-02T15:32:56+00:00","description":"In the development realm of mobile, web, and desktop apps or JavaScript libraries, documentation plays an important role in determining the app's success.","breadcrumb":{"@id":"https:\/\/www.hongkiat.com\/blog\/why-documentation-essential\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.hongkiat.com\/blog\/why-documentation-essential\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.hongkiat.com\/blog\/why-documentation-essential\/#primaryimage","url":"https:\/\/assets.hongkiat.com\/uploads\/why-documentation-essential\/doc-example.jpg","contentUrl":"https:\/\/assets.hongkiat.com\/uploads\/why-documentation-essential\/doc-example.jpg"},{"@type":"BreadcrumbList","@id":"https:\/\/www.hongkiat.com\/blog\/why-documentation-essential\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.hongkiat.com\/blog\/"},{"@type":"ListItem","position":2,"name":"The Importance of Documentation for Web Developers"}]},{"@type":"WebSite","@id":"https:\/\/www.hongkiat.com\/blog\/#website","url":"https:\/\/www.hongkiat.com\/blog\/","name":"Hongkiat","description":"Tech and Design Tips","publisher":{"@id":"https:\/\/www.hongkiat.com\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.hongkiat.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.hongkiat.com\/blog\/#organization","name":"Hongkiat.com","url":"https:\/\/www.hongkiat.com\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.hongkiat.com\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/www.hongkiat.com\/blog\/wp-content\/uploads\/hkdc-logo-rect-yoast.jpg","contentUrl":"https:\/\/www.hongkiat.com\/blog\/wp-content\/uploads\/hkdc-logo-rect-yoast.jpg","width":1200,"height":799,"caption":"Hongkiat.com"},"image":{"@id":"https:\/\/www.hongkiat.com\/blog\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/hongkiatcom","https:\/\/x.com\/hongkiat","https:\/\/www.pinterest.com\/hongkiat\/"]},{"@type":"Person","@id":"https:\/\/www.hongkiat.com\/blog\/#\/schema\/person\/e7948c7a175d211496331e4b6ce55807","name":"Thoriq Firdaus","description":"Thoriq is a writer for Hongkiat.com with a passion for web design and development. He is the author of Responsive Web Design by Examples, where he covered his best approaches in developing responsive websites quickly with a framework.","sameAs":["https:\/\/thoriq.com","https:\/\/x.com\/tfirdaus"],"jobTitle":"Web Developer","url":"https:\/\/www.hongkiat.com\/blog\/author\/thoriq\/"}]}},"jetpack_featured_media_url":"https:\/\/","jetpack_shortlink":"https:\/\/wp.me\/p4uxU-67p","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.hongkiat.com\/blog\/wp-json\/wp\/v2\/posts\/23523","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.hongkiat.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.hongkiat.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.hongkiat.com\/blog\/wp-json\/wp\/v2\/users\/113"}],"replies":[{"embeddable":true,"href":"https:\/\/www.hongkiat.com\/blog\/wp-json\/wp\/v2\/comments?post=23523"}],"version-history":[{"count":3,"href":"https:\/\/www.hongkiat.com\/blog\/wp-json\/wp\/v2\/posts\/23523\/revisions"}],"predecessor-version":[{"id":53074,"href":"https:\/\/www.hongkiat.com\/blog\/wp-json\/wp\/v2\/posts\/23523\/revisions\/53074"}],"wp:attachment":[{"href":"https:\/\/www.hongkiat.com\/blog\/wp-json\/wp\/v2\/media?parent=23523"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.hongkiat.com\/blog\/wp-json\/wp\/v2\/categories?post=23523"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.hongkiat.com\/blog\/wp-json\/wp\/v2\/tags?post=23523"},{"taxonomy":"topic","embeddable":true,"href":"https:\/\/www.hongkiat.com\/blog\/wp-json\/wp\/v2\/topic?post=23523"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}