logoalt Hacker News

sloakenlast Sunday at 1:33 PM3 repliesview on HN

This might not be the first to break, but it will eventually, and if corrected NOW will make things much smoother:

Your documentation of processes and procedures is NOT adequate.

'everyone used to know about are getting lost' - oh good thing your documentation makes this clear, because it is obviously their fault.

'New hires take forever to ramp up' - oh good thing you have complete ramp up plan and documentation, because it is obviously their fault.

'building on different assumptions' - oh good, your old assumptions are clearly documented, because it is obviously their fault.

So their is your self focus, please do good, and document well.


Replies

hrmtst93837yesterday at 12:07 PM

Docs help, but they don't save you from a team that treats Slack as the source of truth. At 50 people the bigger failure is ownership: nobody knows which page is current, nobody gets time to fix stale docs after the process changes, and after a few rounds of that the wiki becomes a museum piece new hires learn to ignore.

show 1 reply
hariprasadrlast Sunday at 4:04 PM

So, documentation is the solution? But do people have time to document everything?

show 7 replies
welcome_dragonlast Tuesday at 2:34 PM

Are you saying there's too much undocumented tribal knowledge? If so, I agree