Does documenting feel productive?

It is definitely necessary, especially in companies where there is a medium-high rotation of personnel.

I have been in places where some workers felt untouchable because they possessed knowledge that no one else had, while at the same time complaining that they always had to go through them to make certain developments.

It's a matter of time but there's a big component of discipline and having the routine to do it. Even though we all know that when time is running out, the first thing that is removed from planning is documentation.

Perhaps it is a mistake to think that the one who does the development should document it, since not everyone has the same communication skills or the will to do it and it should be delegated to a specific profile within the team.

There is definitely value in writing documentation. Documentation about the implementation is mostly: "I might forget how this works, so I'm writing my notes here so I can see it later."

There is more documentation such as:

• An overview / tour of the codebase for newcomers or people that haven't used a particular area.
• Why a particular implementation was chosen.
• Tons of non-technical documentation about the project, why some decisions were made, design documentation, tons of stuff in general.

It's all useful.

Why is it bothersome? In my opinion:

1. Because it would be better if it wasn't needed. As mentioned, a lot of it is comments for stuff that wouldn't be immediately obvious without it.
2. Because we don't want to write long documents for why X was done and to document what we're doing. We just want to do the work.
3. It needs constant maintenance... Outdated documentation could be worse than no documentation, because it can be confusing and misleading.

I'm curious to see other answers, as these are just my personal experiences.

I think there is a total value in writing the documentation but I just don’t like doing it.