4 ms·
Over time the first thing I've come to desire more than 'intrinsic' readability when joining a new project is a decent, up to date, hyperlinked glossary with al
by crdoconnor 9y ago
Over time the first thing I've come to desire more than 'intrinsic' readability when joining a new project is a decent, up to date, hyperlinked glossary with all of the relevant acronyms and terms that will be used in the code. I've had variations on this conversation many times before:
* New coworker (me): What's an XYZ? (some core thing in the system)
* Coworker 1: An XYZ is [blah blah blah].
* Coworker 2: Actually, an XYZ may not be [blah blah] it could be [blah].
* Coworker 1: No! That's not right!
* Me: ugh...