IssueRaiser

I worked at a late-stage Rails-based startup that had "dont write comments" as an engineering principle!

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.

Posted by claytonjy on Jan 31, 2023, 9:15 PM

Tags

Related issues

Raise real-world problems, find people facing the same issue, and discuss solutions.2,500 issues0 comments

ux (Other)

I worked at a late-stage Rails-based startup that had "dont write comments" as an engineering principle!

claytonjyJan 31, 2023, 9:15 PM

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.

Comments (0)

No comments yet. Start the discussion.

Comment on this issue