Comment by coolcase
A good documenter is the novice who just learned. (Maybe the expert should vet it for accuracy)
A good documenter is the novice who just learned. (Maybe the expert should vet it for accuracy)
I took contact with an existing code base about a year ago.
Tbh I would have been better at explaining it after 6 months than I am now. I've already worked with it enough that I've internalized some basics and I'm sure I'll forget to mention them when explaining to a hypothetical new guy.
(author here) Absolutely agree. Another commenter mentioned that sometimes the best mentor is someone slightly better than you, and not some seasoned veteran. You want someone knowledgeable enough to give good (and correct) advice, but not so knowledgeable that they struggle to be comprehensible.