3 ms·
Managers who know what they're paid for also want code with a bus factor of more than 1, just like in other engineering disciplines. Having code well documented
by red_admiral 2y ago
Managers who know what they're paid for also want code with a bus factor of more than 1, just like in other engineering disciplines. Having code well documented is a feature in that sense; like unit tests it won't fix all problems but it goes a long way.
Speaking of tests, I've many times learnt more about how some code is supposed to work from the tests than from the documentation. Yet another reason to test everything you can.
- bb88 2y agoUnit tests often double as documentation. They show the expected behavior of a function. And if you take the time to write a series of high level cases, they can show the full expected behavior of a process. E.g: "Don't accept another request on the same object while we have another request on that object in the queue." A unit test is great, but I've seen people delete unit tests rather than try to understand what's going on.