3 ms·
I worked at a late-stage Rails-based startup that had "dont write comments" as an engineering principle! The python folks before me used this to avoid writing
by claytonjy 4y ago
I worked at a late-stage Rails-based startup that had "dont write comments" as an engineering principle!
The python folks before me used this to avoid writing docstrings for modules/classes/methods, so code could only be understood by reading the entirety of it. Throw in some deep class hierarchies and it was very hard to onboard there.
- makeitdouble 4y agoTBF, deep class hierarchies will hard to onboard whatever you do. If you're relying on comments to help with that, you'll have to share the same mindset as the person writing the comments, except there's probably multiple years of understanding gap between you and them.