News for hackers. Stuff that matters.
Re:Software engineering topics I changed my mind on by jbay808 on Sunday January 24, 2021 @01:22AM (#25889808)
A place I used to work had engineers documenting their work essentially in the form of a blog. It was actually really a useful habit, and reviewing the project blogs once each week made it really easy for me to find cases when I could help a colleague who was working on something I'd had experience with before.
Re:Software engineering topics I changed my mind on by anaerobicover on Sunday January 24, 2021 @01:39PM (#25894479)
I'd venture that the parent was talking about engineers "documenting" their work for managers, whereas I think you mean documentation for other engineers. Very different audiences and thus different things to say. (And widely different lifespans for the information.)

The latter no doubt is hugely useful (I'm on a long slow effort myself to get my co-workers to document their work more robustly). But writing status reports for managers/PMs on a weekly basis is, in my not so humble opinion, a complete waste of time for the company, and a sign of poor organization.

Re:Software engineering topics I changed my mind on by rektide on Sunday January 24, 2021 @02:11PM (#25894787)
I was hoping both purposes would be served, at this mandatory level.

I would adore any engineer who writes more blog posts walking through what they're up to more technically.

How do you feel about every-day stand ups as a means for managers/PMs to check in on employees? My own impression has been that this is at least 50%+ of the reason for stand up, and to me, I'd far prefer periodic write-ins, rather than ephemeral, undetailed, synchronous communication.