[toast0]

> People tend to think that documentation is someone else's responsibility, and it just isn't so.

What is everyone's responsibility is no one's responsibility.

I've been at places with good documentation and at places with bad documentation. The places with good documentation have someone (or maybe a team) with responsibility for documenation. It could be a developer, it's better IMHO if it's a technical writer. They don't need to write all the docs, but they're in charge of editing and organization, and checking to make sure docs are current and assigning people to update them/provide information so they can be updated.

If your org lacks a documentarian, you'll get chaos documentation, which tends towards poor documentation; this is a choice. If your org has a documentarian, but they don't have time to do it, your org has chosen other priorities over documentation. If your org doesn't include documentation in evaluations, it's not an org priority, and that's a choice, too. I've been at places with a self-appointed documentarian, and that can work too, as long as they can cajole others into doing the tasks that they assign.

[koliber]

> What is everyone's responsibility is no one's responsibility.

On teams that I run there are many things that are everyone's responsibility. Here are some of them:

- Everyone is responsible for showing up on time

- Everyone is responsible for being respectful

- Everyone is responsible for maintaining documentation

I would not say that saying that everyone is responsible for something automatically makes it that no one will do it. Managers and peers need to work on supporting these responsibilities.

I agree that documentarians do pick up a lot of the slack, and one or more are needed to make documentation useful. However, it is not solely their responsibility to maintain documentation. Everyone is a domain expert in some area, and they need to own the relevant documentation.

[jpc0]

> - Everyone is responsible for showing up on time > - Everyone is responsible for being respectful

These two are usually an HR issue, the third isn’t. So unless your org makes lack of managing documentation an HR issue like the other two I don’t see the relevance.

[koliber]

All three are company and team culture issues. If you delegate all culture responsibility to HR you'll end up with a hot mess. Culture needs to be fostered on every level.

[jpc0]

If you do not have backing from HR and senior management the issue will not change even if you tried.

Action without consequence causes these problems. If an employee is allowed to continually be late and rude it really does not matter in any way whatsoever if everyone shuns that employee culturally because the implicit statement is that that behaviour is acceptable but unwanted.

That is the exact situation you get into with lack of documentation, if a single employee never does correct documentation but there is no real repercussions it does not matter whether the “culture” is documentation, you have agreed by contract at that point documentation is not a requirement.

If you make it a matter of “Do the documentation correctly or we will be having talks to remove you” that clearly indicates it is not just lip service but is actually enforced culture.

Thinking the carrot will always work is part of the “documentation culture”. Make it a hard requirement or don’t do it at all.

[koliber]

Motivation, education, and enforcements are key.

While support from HR and senior management is helpful, I've found that most of the work happens at lower levels. In the end, it comes down to working directly with people to help them do documentation well. In engineering departments I've led, I did not need permission or enforcement to do good documentation from company execs or HR.

The "stick" that HR provides is a tool of last resort. At the same time, companies are different and what works in one might not work in another.

[jpc0]

You don’t need permission but you need authority. Maybe you are US centric in a US state with weak employee protections so you can make those calls. In other jurisdictions it is a significant amount of paperwork and procedure to get rid of even an underperforming employee.