Manager READMEs: A minefield in the making
These documents are ostensibly meant to humanize, but ultimately backfire.
For as much as I want to take Twitter breaks, let’s be honest: I’m not. I’m going to fall sleep with my phone clutched in my right hand and wake up shining blue light into my precious orbs first thing. So, yes, I saw you manager-types. I saw you sharing your READMEs with delight - a cheeky throwback to how you used to operate as a developer. Get it? It’s technical documentation, but instead of for an API or open-source project it’s for me.