[kogepathic]

> "A senior developer shouldn't need documentation. The knowledge should be in your head."

What?! This guy isn't fit to be principal developer.

Sure, the knowledge should be in your head, but it should also be documented in case you get hit by a bus or go on vacation.

Does no one senior ever stop to think about business continuity? What happens when you onboard someone new? A senior developer is just supposed to drop all their work and get the new person up to speed for a month?

I find that companies with a bad documentation culture see it as a cost center ("this takes so much time") whereas companies with good documentation culture realize that even if it takes time, the benefits far outweigh the costs.

[Amokrane]

Completely agree. On a side note, the one answer that I always get from management when I suggest that we should write more documentation is: "Well, writing documentation could be useful but maintaining it is hard. So I don't think it's a good idea".

As you said, this should be part of the culture. Documentation should be seen as an artifact that is equally as important as the software deliverable itself.

[kogepathic]

> "Well, writing documentation could be useful but maintaining it is hard. So I don't think it's a good idea"

Your management does not understand the value of good documentation.

Flip the industry:

"Well, airplanes are useful for transportation, but maintaining the documentation takes too much time. So we should skip writing the maintenance documentation and just let the mechanics figure it out themselves every time they need to replace a part" (assuming the plane doesn't fall apart mid-flight)

If you framed it as such, they would see that their counter-argument against documentation is silly. Now, they could argue that your software isn't life critical and people won't die if it fails, but personally I think that's beside the point. It's a business decision the aviation industry has made to document things thoroughly and it's paid off in spades for them.

Of course you have to invest time and effort into documentation, but you maintain it the same way you maintain your software or your tests.

It sounds like your management doesn't realize that although documentation has a visible cost (people's time) it also has many invisible savings: to quickly reference in emergency situations, employee illness/vacation/departure/onboarding, supporting legacy versions.

tl;dr - your management sees documentation as a cost center

[eosrei]

Explaining Bus Factor can be helpful in getting their attention. "Sure, documentation is a cost center. You know what's a bigger cost center? Not having it."

https://en.wikipedia.org/wiki/Bus_factor