{"id":12639,"date":"2023-03-02T13:53:06","date_gmt":"2023-03-02T13:53:06","guid":{"rendered":"http:\/\/TheNextWeb=1394464"},"modified":"2023-03-02T13:53:06","modified_gmt":"2023-03-02T13:53:06","slug":"bad-news-junior-developers-you-will-be-judged-by-your-documentation","status":"publish","type":"post","link":"https:\/\/www.londonchiropracter.com\/?p=12639","title":{"rendered":"Bad news, junior developers: You will be judged by your documentation"},"content":{"rendered":"\n
<\/div>\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

Even when developers<\/a> 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

Coding is a way of life. It\u2019s as simple as that.<\/p>\n

\n
<\/p>\n

Don’t miss TNW’s first conference in Val\u00e8ncia in less than 4 weeks!<\/h4>\n

The heart of tech is coming to the heart of the Mediterranean – March 30 – 31<\/p>\n

<\/a><\/div>\n<\/div>\n

There\u2019s just one little problem: Coding<\/a> is not the only part of software development.<\/p>\n

You\u2019ll also have to work with a team, sit in meetings, write emails, and write documentation for your code.<\/p>\n

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

The deciding factor between a career that has a lasting impact on your company and one that doesn\u2019t is just one thing: your documentation<\/a>.<\/p>\n

In two years, nobody will understand your source code<\/h2>\n

Languages and frameworks come and go.<\/p>\n

Just a few years ago, Python2 was the status quo of back-end programming and data science. Then Python3 came, and everything that was in Python2 was out of date and didn\u2019t work with any new code.<\/p>\n

There always will be some language, some framework, some technology that will do the task at hand better and faster.<\/p>\n

Or maybe it\u2019s just trendier.<\/p>\n

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

They\u2019ll rewrite your code.<\/p>\n

Or forget about it completely.<\/p>\n

Your code doesn\u2019t exist in a vacuum<\/h2>\n

Even if your code is in a fairly popular language, nobody will understand it by reading just that code.<\/p>\n

Maybe you\u2019re writing part of the front-end of an application. But without at least some knowledge about what the backend does, nobody will understand the code in-depth.<\/p>\n

And, as many devs can testify, in-depth understanding is crucial for maintaining code.<\/p>\n

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

Team members come and go \u2014 even you<\/h2>\n

Documentation is the best friend of on-boarding.<\/p>\n

Think about it: How many new hires has your team had in the past couple of years?<\/p>\n

And how many existing team members have had the time and patience to explain every piece of code to these new hires?<\/p>\n

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

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

Documentation scales. And saves time.<\/p>\n

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

Either way, when you\u2019re not there anymore, your documentation will work for you.<\/p>\n

Your documentation is your legacy.<\/p>\n

Managers won\u2019t look at your source code anyway<\/h2>\n

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

Most managers know this. That\u2019s why they don\u2019t read source code.<\/p>\n

It\u2019s not laziness. It\u2019s effectiveness.<\/p>\n

Managers need to decide which resources to use on which project, which team member to shift where, and so on. Business decisions.<\/p>\n

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

You can\u2019t manage code if you don\u2019t understand anything at all. So managers read the code documentation.<\/p>\n

Besides, if you consistently produce great documentation for your code, your manager might notice.<\/p>\n

And give you a promotion.<\/p>\n

How to make documenting enjoyable<\/h2>\n

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

Documentation is that pain in the rear end that comes when you should feel satisfied because you\u2019ve just written amazing code.<\/p>\n

You can make it less painful, though.<\/p>\n

Use Continuous Documentation<\/a> and write up your docs while you\u2019re coding. Use smart tools<\/a> to write and maintain your documentation.<\/p>\n

Only a small proportion of devs are doing this. But that proportion is getting bigger fast.<\/p>\n

More and more devs are realizing that they need to upgrade their documentation. It\u2019s a necessary evil.<\/p>\n

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

Famous last words
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

If it were just about writing amazing code, it would be a straight road.<\/p>\n

Documentation makes the road to achieving success harder because it\u2019s a task that many devs don\u2019t enjoy.<\/p>\n

Cut it into little pieces, and document every change as soon as you make it.<\/p>\n

Your career<\/a> will thank you.<\/p>\n

Source<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

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…<\/p>\n","protected":false},"author":1,"featured_media":12640,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[],"_links":{"self":[{"href":"https:\/\/www.londonchiropracter.com\/index.php?rest_route=\/wp\/v2\/posts\/12639"}],"collection":[{"href":"https:\/\/www.londonchiropracter.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.londonchiropracter.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.londonchiropracter.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.londonchiropracter.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=12639"}],"version-history":[{"count":0,"href":"https:\/\/www.londonchiropracter.com\/index.php?rest_route=\/wp\/v2\/posts\/12639\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.londonchiropracter.com\/index.php?rest_route=\/wp\/v2\/media\/12640"}],"wp:attachment":[{"href":"https:\/\/www.londonchiropracter.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=12639"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.londonchiropracter.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=12639"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.londonchiropracter.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=12639"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}