DEV Community

Discussion on: Does documenting feel productive?

Collapse
 
ben profile image
Ben Halpern

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.

This is exactly what documentation is for.

I think good documentation can be inherently really really hard. Communication is tough, keeping things in sync is easier said than done, and hierarchy/reading order is just not easy to figure out when it's evolving at any time.

Unlike a self-containing blog post or book, docs can be random-access and getting it right is a skill that is hard to come by.

Collapse
 
codenamejason profile image
Jaxcoder • Edited

I don’t like those devs that keep everything to them. I try to share everything I know with everybody I work with on my immediate team so I always have back up for the company.

And yes getting it right it’s very difficult and a talent in itself.