{"id":558583,"date":"2023-03-02T16:53:06","date_gmt":"2023-03-02T13:53:06","guid":{"rendered":"https:\/\/en.buradabiliyorum.com\/you-will-be-judged-by-your-documentation\/"},"modified":"2023-03-02T16:53:06","modified_gmt":"2023-03-02T13:53:06","slug":"you-will-be-judged-by-your-documentation","status":"publish","type":"post","link":"https:\/\/buradabiliyorum.com\/en\/you-will-be-judged-by-your-documentation\/","title":{"rendered":"#You will be judged by your documentation"},"content":{"rendered":"<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_84 counter-hierarchy ez-toc-counter ez-toc-custom ez-toc-container-direction\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Table of Contents<\/p>\n<label for=\"ez-toc-cssicon-toggle-item-6a2a300360e02\" class=\"ez-toc-cssicon-toggle-label\"><span class=\"\"><span class=\"eztoc-hide\" style=\"display:none;\">Toggle<\/span><span class=\"ez-toc-icon-toggle-span\"><svg style=\"fill: #dd3333;color:#dd3333\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewBox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #dd3333;color:#dd3333\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewBox=\"0 0 24 24\" version=\"1.2\" baseProfile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/span><\/label><input type=\"checkbox\"  id=\"ez-toc-cssicon-toggle-item-6a2a300360e02\" checked aria-label=\"Toggle\" \/><nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-1'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/buradabiliyorum.com\/en\/you-will-be-judged-by-your-documentation\/#%E2%80%9CYou_will_be_judged_by_your_documentation%E2%80%9D\" >&#8220;You will be judged by your documentation&#8221;<\/a><ul class='ez-toc-list-level-4' ><li class='ez-toc-heading-level-4'><ul class='ez-toc-list-level-4' ><li class='ez-toc-heading-level-4'><ul class='ez-toc-list-level-4' ><li class='ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/buradabiliyorum.com\/en\/you-will-be-judged-by-your-documentation\/#Dont_miss_TNWs_first_conference_in_Valencia_in_less_than_4_weeks\" >Don&#8217;t miss TNW&#8217;s first conference in Val\u00e8ncia in less than 4 weeks!<\/a><\/li><\/ul><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/buradabiliyorum.com\/en\/you-will-be-judged-by-your-documentation\/#In_two_years_nobody_will_understand_your_source_code\" >In two years, nobody will understand your source code<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/buradabiliyorum.com\/en\/you-will-be-judged-by-your-documentation\/#Your_code_doesnt_exist_in_a_vacuum\" >Your code doesn\u2019t exist in a vacuum<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/buradabiliyorum.com\/en\/you-will-be-judged-by-your-documentation\/#Team_members_come_and_go_%E2%80%94_even_you\" >Team members come and go \u2014 even you<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/buradabiliyorum.com\/en\/you-will-be-judged-by-your-documentation\/#Managers_wont_look_at_your_source_code_anyway\" >Managers won\u2019t look at your source code anyway<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-7\" href=\"https:\/\/buradabiliyorum.com\/en\/you-will-be-judged-by-your-documentation\/#How_to_make_documenting_enjoyable\" >How to make documenting enjoyable<\/a><\/li><\/ul><\/li><\/ul><\/nav><\/div>\n<h1><span class=\"ez-toc-section\" id=\"%E2%80%9CYou_will_be_judged_by_your_documentation%E2%80%9D\"><\/span>&#8220;You will be judged by your documentation&#8221;<span class=\"ez-toc-section-end\"><\/span><\/h1>\n<p><img decoding=\"async\" src=\"https:\/\/img-cdn.tnwcdn.com\/image?fit=796%2C417&amp;url=https%3A%2F%2Fcdn0.tnwcdn.com%2Fwp-content%2Fblogs.dir%2F1%2Ffiles%2F2023%2F02%2FAdd-a-heading-1-2.jpg&amp;signature=bb74e2345255dd72ad01f37b2dbe109a\" \/><\/p>\n<div id=\"article-main-content\">\n                            Developers become developers because they like to code. Many have taken up coding as teens after school, or during after-hours after their cubicle job. They realize how much power they can get from their IDE and their command line, and they get addicted to it.<\/p>\n<p>Even when developers land that dream job where they can code all day, many keep their side projects going in the evenings and during after-hours. I personally know developers who keep coding on the train after they leave their office \u2014 because what else is one going to do on a train?<\/p>\n<p>Coding is a way of life. It\u2019s as simple as that.<\/p>\n<p>There\u2019s just one little problem: Coding is not the only part of software development.<\/p>\n<div class=\"inarticle-wrapper channel-cta\">\n<div class=\"ica-text\">\n<h4><span class=\"ez-toc-section\" id=\"Dont_miss_TNWs_first_conference_in_Valencia_in_less_than_4_weeks\"><\/span>Don&#8217;t miss TNW&#8217;s first conference in Val\u00e8ncia in less than 4 weeks!<span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>The heart of tech is coming to the heart of the Mediterranean &#8211; March 30 &#8211; 31<\/p>\n<\/div>\n<\/div>\n<p>You\u2019ll also have to work with a team, sit in meetings, write emails, and write documentation for your code.<\/p>\n<p>And in the long run, what will make or break your career won\u2019t be the emails you wrote or the meetings or the contributions you made during meetings. It won\u2019t even be the code you wrote, believe it or not.<\/p>\n<p>The deciding factor between a career that has a lasting impact on your company and one that doesn\u2019t is just one thing: <a rel=\"nofollow noopener\" target=\"_blank\" href=\"https:\/\/larshaendler.medium.com\/junior-developers-underrate-the-importance-of-documentation-28030300354f\">your documentation<\/a>.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"In_two_years_nobody_will_understand_your_source_code\"><\/span>In two years, nobody will understand your source code<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Languages and frameworks come and go.<\/p>\n<p>Just a few years ago, Python2 was the status quo of back-end programming and data <a href=\"https:\/\/buradabiliyorum.com\/en\/category\/sciencee\/\" data-internallinksmanager029f6b8e52c=\"5\" title=\"Science\" target=\"_blank\" rel=\"noopener\">science<\/a>. Then Python3 came, and everything that was in Python2 was out of date and didn\u2019t work with any new code.<\/p>\n<p>There always will be some language, some framework, some <a href=\"https:\/\/buradabiliyorum.com\/en\/category\/technology\/\" data-internallinksmanager029f6b8e52c=\"4\" title=\"Technology\" target=\"_blank\" rel=\"noopener\">technology<\/a> that will do the task at hand better and faster.<\/p>\n<p>Or maybe it\u2019s just trendier.<\/p>\n<p>Either way, many junior developers \u2014 and those tend to be the majority of new hires \u2014 won\u2019t bother with the old languages any more.<\/p>\n<p>They\u2019ll rewrite your code.<\/p>\n<p>Or forget about it completely.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Your_code_doesnt_exist_in_a_vacuum\"><\/span>Your code doesn\u2019t exist in a vacuum<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Even if your code is in a fairly popular language, nobody will understand it by reading just that code.<\/p>\n<p>Maybe you\u2019re writing part of the front-end of an <a href=\"https:\/\/buradabiliyorum.com\/en\/category\/download-scripts-themes-apps\/\" data-internallinksmanager029f6b8e52c=\"9\" title=\"Download Scripts &amp; Themes &amp; Apps\" target=\"_blank\" rel=\"noopener\">app<\/a>lication. But without at least some knowledge about what the backend does, nobody will understand the code in-depth.<\/p>\n<p>And, as many devs can testify, in-depth understanding is crucial for maintaining code.<\/p>\n<p>You can\u2019t just add a front-end feature without thinking about back-end support for it. Or add a feature that looks nice in your app but which, at its core, nobody cares about.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Team_members_come_and_go_%E2%80%94_even_you\"><\/span>Team members come and go \u2014 even you<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Documentation is the best friend of on-boarding.<\/p>\n<p>Think about it: How many new hires has your team had in the past couple of years?<\/p>\n<p>And how many existing team members have had the time and patience to explain every piece of code to these new hires?<\/p>\n<p>Developers need to ship. Most devs just don\u2019t have the time to invest a couple of months to get a new team member up to speed. Your manager doesn\u2019t care about your mentoring abilities. They want to see results in the form of code.<\/p>\n<p>Documentation is the solution. All that you can explain you can also write down. Once written, it can help one new hire. Or two. Or a hundred.<\/p>\n<p>Documentation scales. And saves time.<\/p>\n<p>Besides, one day you won\u2019t be around to mentor new hires. Maybe you\u2019ll move on to a higher position. Or you\u2019ll change companies. Or you\u2019ll be on sick leave when something happens.<\/p>\n<p>Either way, when you\u2019re not there anymore, your documentation will work for you.<\/p>\n<p>Your documentation is your legacy.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Managers_wont_look_at_your_source_code_anyway\"><\/span>Managers won\u2019t look at your source code anyway<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Developers who code for a living won\u2019t understand your code in-depth from reading it. Your manager won\u2019t understand anything at all.<\/p>\n<p>Most managers know this. That\u2019s why they don\u2019t read source code.<\/p>\n<p>It\u2019s not laziness. It\u2019s effectiveness.<\/p>\n<p>Managers need to decide which resources to use on which project, which team member to shift where, and so on. Business decisions.<\/p>\n<p>At the core of it, though, they\u2019re managing the people that make code. They\u2019re managing code at a very high level.<\/p>\n<p>You can\u2019t manage code if you don\u2019t understand anything at all. So managers read the code documentation.<\/p>\n<p>Besides, if you consistently produce great documentation for your code, your manager might notice.<\/p>\n<p>And give you a promotion.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"How_to_make_documenting_enjoyable\"><\/span>How to make documenting enjoyable<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Yeah, all the above reasons are good reasons to write better documentation. But developers don\u2019t want to write like they\u2019re Stephen King. They want to code like they\u2019re Bill Gates.<\/p>\n<p>Documentation is that pain in the rear end that comes when you should feel satisfied because you\u2019ve just written amazing code.<\/p>\n<p>You can make it less painful, though.<\/p>\n<p>Use <a rel=\"nofollow noopener\" target=\"_blank\" href=\"https:\/\/www.infoq.com\/articles\/continuous-documentation\/\">Continuous Documentation<\/a> and write up your docs while you\u2019re coding. Use <a rel=\"nofollow noopener\" target=\"_blank\" href=\"https:\/\/medium.com\/geekculture\/why-todays-code-documentation-is-a-heap-of-garbage-c66ac8aa6cb6\">smart tools<\/a> to write and maintain your documentation.<\/p>\n<p>Only a small proportion of devs are doing this. But that proportion is getting bigger fast.<\/p>\n<p>More and more devs are realizing that they need to upgrade their documentation. It\u2019s a necessary evil.<\/p>\n<p>Continuous Documentation, or the habit of contributing to your documentation whenever you make a change \u2014 however small \u2014 makes the pill easier to swallow.<\/p>\n<p>Famous last words<br \/>The route to making a lasting impact in the world of software is curvy and bent, and you\u2019ll need a share of luck as well.<\/p>\n<p>If it were just about writing amazing code, it would be a straight road.<\/p>\n<p>Documentation makes the road to achieving success harder because it\u2019s a task that many devs don\u2019t enjoy.<\/p>\n<p>Cut it into little pieces, and document every change as soon as you make it.<\/p>\n<p>Your career will thank you.\n                        <\/p><\/div>\n<blockquote><p><strong><span style=\"color: #ff6600;\">If you liked the article, do not forget to share it with your friends. Follow us on\u00a0<span style=\"color: #ff0000;\"><a style=\"color: #ff0000;\" href=\"https:\/\/news.google.com\/publications\/CAAqBwgKMLG0nwswvr63Aw\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Google News<\/a><\/span>\u00a0too, click on the star and choose us from your favorites.<\/span><\/strong><\/p><\/blockquote>\n<blockquote>\n<p style=\"text-align: center;\">For forums sites go to <span style=\"color: #ff9900;\"><a style=\"color: #ff9900;\" href=\"https:\/\/forum.buradabiliyorum.com\/\" target=\"_blank\" rel=\"noopener\">Forum.BuradaBiliyorum.Com<\/a><\/span><\/strong>\n<\/p><\/blockquote>\n<blockquote>\n<p style=\"text-align: center;\"><strong>If you want to read more like this article, you can visit our <span style=\"color: #ff9900;\"><a style=\"color: #ff9900;\" href=\"https:\/\/en.buradabiliyorum.com\/technology\/\" target=\"_blank\" rel=\"noopener\">Technology category.<\/a><\/span><\/strong><\/p>\n<\/blockquote>\n<p><span style=\"color: black;\"><a style=\"color: #ff9900;\" href=\"https:\/\/thenextweb.com\/news\/bad-news-junior-developers-you-will-be-judged-by-your-documentation\" target=\"_blank\" rel=\"noopener\">Source<\/a><\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>&#8220;You will be judged by your documentation&#8221; Developers become developers because they like to code. Many have taken up coding as teens after school, or during after-hours after their cubicle job. They realize how much power they can get from their IDE and their command line, and they get addicted to it. Even when developers&#8230;<\/p>\n","protected":false},"author":1,"featured_media":558584,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"fifu_image_url":"https:\/\/img-cdn.tnwcdn.com\/image\/tnw-blurple?filter_last=1&fit=1280,640&url=https:\/\/cdn0.tnwcdn.com\/wp-content\/blogs.dir\/1\/files\/2023\/02\/Add-a-heading-1-2.jpg&signature=3923cd980ae3c0aef33cd5caefbf8c37","fifu_image_alt":"","footnotes":""},"categories":[18],"tags":[],"class_list":["post-558583","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-technology"],"_links":{"self":[{"href":"https:\/\/buradabiliyorum.com\/en\/wp-json\/wp\/v2\/posts\/558583","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/buradabiliyorum.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/buradabiliyorum.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/buradabiliyorum.com\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/buradabiliyorum.com\/en\/wp-json\/wp\/v2\/comments?post=558583"}],"version-history":[{"count":0,"href":"https:\/\/buradabiliyorum.com\/en\/wp-json\/wp\/v2\/posts\/558583\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/buradabiliyorum.com\/en\/wp-json\/wp\/v2\/media\/558584"}],"wp:attachment":[{"href":"https:\/\/buradabiliyorum.com\/en\/wp-json\/wp\/v2\/media?parent=558583"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/buradabiliyorum.com\/en\/wp-json\/wp\/v2\/categories?post=558583"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/buradabiliyorum.com\/en\/wp-json\/wp\/v2\/tags?post=558583"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}