back

by zoenolan·2y ago·view on hn ↗
I've used a newbie notes file for years. Mostly written but screenshots and video if they make sense. Preferably in something version controlled.

One of the first tasks of any new joiner is to update the notes with any errors or omissions. That should mean the notes are only as outdated as the last person to join. Which if you have a steady cadence of people joining shouldn't be too bad.

Having a buddy to answer any questions is good. Budget that taking 30% of that person's time at least initially.

1 comments
Makes sense. We have joiners once every 6 months and we tend to work on greenfield projects, so the docs get out of date pretty quick. I could try to emphasize more to the joiners to keep them up to date; unfortunately I'm not their line manager. Thanks!