I keep seeing teams celebrate the person who can untangle a nasty bug in an afternoon, and sure, that saves the week. But sometimes it also means the fix lives in one head and nobody else learns how the system failed.
Has anyone found a good balance between rewarding fast debugging and making sure the reasoning gets shared instead of disappearing into Slack and memory?
the hero debugger thing is real, and it gets weird fast when only one person knows how the system broke.
what’s worked for me is making the fix come with a tiny bug diary in the PR. not a big writeup, just: what broke, what clue pointed to it, how they proved it, and what stops it happening again. it takes like 5 minutes and saves everyone from spelunking through Slack later.
I usually title it something boring on purpose, like:
How I knew it was X
future me is not going to remember the clever version anyway.
:: Copyright KIRUPA 2024 //--