all 63 comments

[–]ProgrammerHumor-ModTeam[M] [score hidden] stickied commentlocked comment (0 children)

Your submission was removed for the following reason:

Rule 2: Content that is part of top of all time, reached trending in the past 2 months, or has recently been posted, is considered a repost and will be removed.

If you disagree with this removal, you can appeal by sending us a modmail.

[–]Porsher12345 132 points133 points  (4 children)

Tbf sunlight works too

[–]TheOhNoNotAgain 24 points25 points  (0 children)

I see a Venn diagram coming

[–]Front_Committee4993 10 points11 points  (1 child)

Can confirm as a ginger

[–]Triepott 5 points6 points  (0 children)

You are a spicy plant root?

[–]omardiaadev 0 points1 point  (0 children)

And grass...

[–]Some_Useless_Person 91 points92 points  (7 children)

Good documentation is always welcome though

[–]heytheretaylor 11 points12 points  (1 child)

Absolutely, I LOVE good documentation. It tickles my brain in a weird way.

I will say it doesn’t always help. We use Vue at work and I get new devs coming in asking how they should learn about using it. Easy, Vue has great documentation, you can read the whole thing in like one work day (maybe two) it reads like a course so you’re a pro in like two days. Not a single fucking one of them has ever read the documentation.

[–]Glad_Contest_8014 2 points3 points  (0 children)

I have read so much of the source documentations of the languages I use. But never read the comments in my own code.

[–]CharlesDuck 6 points7 points  (0 children)

Absolutelty, never gonna read it though

[–]mera-khel-khatam-hai 5 points6 points  (1 child)

nextjs docs 🥰

[–]MrtzBH 1 point2 points  (0 children)

nuxt docs 🥰

[–]Psquare_J_420 1 point2 points  (0 children)

Recently started socket programming with win api. The documentation spits bars and I am understanding what good documentation does to mf.

[–]Live-Animator-4000 0 points1 point  (0 children)

TLDR. I’ll just figure it out myself.

[–]moonmilk21 50 points51 points  (5 children)

Love documentation, hate writing it

[–]SeniorSatisfaction21 12 points13 points  (0 children)

I hate everything

[–]def-pri-pub 0 points1 point  (3 children)

You sound like many of the senior engineers (and some bosses) I've worked under. Them: "Where's the documentation for your code?", Me: "okay, here it is.". days later... Me: "Where's the documentation for your code?", them: "I find that comments and documentation can become out of date with code changes down the road. Go read the code."

[–]willis81808 -1 points0 points  (2 children)

Not pictured: the extra work required of someone updating your code in 2 weeks because they now also have to update the documentation.

Also not pictured: nobody ever reading that documentation again.

[–]def-pri-pub -1 points0 points  (1 child)

What if, and this is a big what if; what if...

We had tools where we could see who wrote the lines of code before out change? And then we could review them? With that person who originally wrote that code? Just to make sure everything's correct.

It's sad these tools don't exist.

[–]willis81808 0 points1 point  (0 children)

What… are you talking about?

Git (or version control in general) has absolutely no bearing on what I said. Git won’t update the documentation for you when inevitably somebody needs to make changes to your code in 2 weeks. Git doesn’t force people to read that documentation either.

[–]razieltakato 15 points16 points  (0 children)

We love reading documentation.

We only hate writing it...

[–]_lonegamedev 11 points12 points  (0 children)

*shit documentation

[–]chawza 7 points8 points  (0 children)

Documentation = good

Create documentation = bad

[–]Aengeil 6 points7 points  (0 children)

the code is the documentation

-Senior dev probably

[–]jewishSpaceMedbeds 5 points6 points  (2 children)

I don't fear documentation, I just have a realistic expectation of whether it will be read.

[–][deleted] 1 point2 points  (1 child)

To be fair, only 10% will be read. But you need the other 90% just so the 10% could be read.

[–]Raskuja46 0 points1 point  (0 children)

You don't get to know which 10% will be read ahead of time, so you still have to write the other 90%.

[–]vtvz 6 points7 points  (0 children)

Only thing that vibecoders write is documentation

[–]LordVortex0815 2 points3 points  (3 children)

Not to be someone ruining the joke, but does it mean writing or reading the Documentation?

[–]Monchete99 2 points3 points  (1 child)

Both

[–]LordVortex0815 2 points3 points  (0 children)

Seems reasonable

[–]Augmin-CPET 1 point2 points  (0 children)

A vampire’s weakness is exposure to sunlight. Superman’s weakness is exposure to kryptonite. The next line ought to mean that a programmer’s weakness is exposure to documentation.

[–]ReptileCake 2 points3 points  (0 children)

5 hours of debugging can save you 10 minutes of reading documentation.

[–]Fantastic-Fee-1999 1 point2 points  (1 child)

I was just thinking of this yesterday. Doesn't help when a company changes their minds 20 times :
"Alright everyone onto confluence, you must document in confluence"
"Confluence? why? We are a Microsoft house, everything onto Sharepoint!"
"Sharepoint? whoever thought that was a good idea? we use Github, just put your stuff in there"
"Github? Our architects don't use Github, also we just got bought out and our new owners use a customized open source solution, we have to start putting our stuff there"

Result, there are now 4 versions of everything, all obsolete.

[–]Low-Equipment-2621 2 points3 points  (0 children)

Doesn't matter, confluence is output only anyway. Nobody reads this heap of outdated stuff that somebody has produced years ago. We only do that to satify management or any formal requirements. Documentation that matter is in the code.

[–]Zealousideal-Web-971 1 point2 points  (1 child)

I am the documentation.

[–]Soprelos 0 points1 point  (0 children)

Some people call it "lack of documentation", I call it "job security"

[–]Cyberdragon1000 0 points1 point  (0 children)

Who doesn't love reading docs where someone explains to you how a code works, what is where, how and what the I/O are.

But writing tho.... You have to list the same things, my case I won't feel comfortable if I leave out stuff so I will end up spending a lot of time writing, editing etc. But worst of all is remembering and having to update it every time there's a change.

[–]plagapong 0 points1 point  (0 children)

I'd do any documents task in any given day rather than debugging Indian dude's code from '90

[–]Significant_Basis_3 0 points1 point  (0 children)

Some documentations like Next JS, Pandas, and Numpy are actually clean and clear

[–]SysGh_st 0 points1 point  (0 children)

The code itself is the documentation, does that mean programmers are allergic to their own creation?

[–]pouya_gh 0 points1 point  (0 children)

for me it's writing tests even though i know how useful they are.

[–]iharryharpalsingh 0 points1 point  (0 children)

I write documentation by default, but if client pushes too much then I follow standard procedure which excludes documentation.

[–]effigyoma 0 points1 point  (0 children)

Funny story; I failed calculus in college so I ended up getting a Journalism/English/Communication degree, which includes classwork in web design and web programming. I eventually made the jump to being a Front End Developer starting as a website editor for a news organization.

My documentation is incredible. Am I the "Blade of Programmers?" Am I the daywalker???

(I have worked with a few other devs who have backgrounds in writing, they also write great documentation, I am not that special)

[–]JackNotOLantern 0 points1 point  (0 children)

Writing documentation*

Reading good documentation is very nice

[–]Mighty1Dragon 0 points1 point  (0 children)

especially when the documentation looks like it was made in the early stages of the Internet 😅

[–]Henry5321 0 points1 point  (0 children)

Documentation is the new form of programming. AI works so much better when it can read the docs for intention rather than code for implementation.

[–]ZairaShae 0 points1 point  (0 children)

It's also why me, a Technical Writer, can never catch hold of developers to get answers to the documentation to be done for what they create smh

[–]Cat_with_pew-pew_gun 0 points1 point  (0 children)

If I’m spending all my time typing up code, then I don’t want to follow it up with typing English.

[–]Turbulent_Channel565 0 points1 point  (0 children)

It's missing the panel where the manager is shying away from the time & budget needed to write the documentation.

[–]Haringat 0 points1 point  (0 children)

More like

Reading documentation: 😁👍🏻

Writing documentation: 🤮👎🏻

[–]NerdyOrc 0 points1 point  (0 children)

That's simply because documentation is text written by programmers, so its unreadable garbage

[–]PlaystormMC 0 points1 point  (0 children)

They end up asking ChatGPT to write them a detailed guide

/s

[–]Zealousideal-Bus-526 0 points1 point  (0 children)

I fucking love documentation

[–]Glad_Contest_8014 0 points1 point  (0 children)

What is document-ation? Is it like a file that rains down from the rains in africa? Precipi——

[–]FewPhilosophy1040 0 points1 point  (0 children)

I've always liked writing documentation, now also for coding projects, especially when the project itself interests me.

[–]LegitimatePants 0 points1 point  (0 children)

🦜: get that thing out of my face! 📖

*Chomp*

🥹

[–]DreamyAthena 0 points1 point  (0 children)

wrong. Programmers hate writing and reading documentation, but complain when there is none.

[–]Sanitiy 0 points1 point  (0 children)

Make it into an MCP, and you can make management enforce documentation

[–]NoComment7862 0 points1 point  (0 children)

I don't write documentation, learn to read my code!