Hacker News new | ask | show | jobs
by mikkergp 1303 days ago
Documentation has limits. It’s not like you come out of med school ready to be a doctor. There’s certain types of knowledge most easily modeled by the search engine in your head. Heck the information may even be written down! But in a multi systems failure which page of documentation from the 18 different involved services do you read to figure out how to bring it back up?

Do you think someone brand new to a team with documentation in hand will be as effective as someone who’s been there a year?

1 comments

> Do you think someone brand new to a team with documentation in hand will be as effective as someone who’s been there a year?

Isn't that the purpose of good documentation?

Imagine a plane pilot with lot of experience taking a new job, does they need one year to train before taking passengers on flight?

I guess are we talking the pilot or mechanic? And is the mechanic working on a plane that is expected to function completely differently year to year?

I mean if I’m running sql then yes I expect someone with experience in sql to be able to onboard quickly to be able to execute sql queries.