31 ms·
> prepare good documentation It is difficult enough to overcome the curse of knowledge when writing documentation that a better path is to open up a pair-progr
by afarrell 5y ago
> prepare good documentation
It is difficult enough to overcome the curse of knowledge when writing documentation that a better path is to open up a pair-programming setup and co-write your documentation with an intern or new-joiner.
- musingsole 5y agoI used to argue this too...but too many will use it as an argument to shirk documentation tasks onto people who quite literally can't do the job because the person with the relevant knowledge feels too important to bother teaching anyone.
- afarrell 5y agoI have seen that failure mode as well. I cannot emphasise enough that it needs to be like pair-programming. Without the more senior person there, the more junior person will struggle to know how to get started and need to ask so many initially-ill-formed questions that it will be very slow going.