3 ms·
My team comments way too much. I constantly see stuff like this def fetch_data(comment_id): Args: - comment_id: The id of the comment to fetch. Ret
by spencerchubb 2y ago
My team comments way too much. I constantly see stuff like this
def fetch_data(comment_id):
Args:
- comment_id: The id of the comment to fetch.
Returns: The comment data
# Fetch comment data
data = fetchCommentData()
- Minor49er 2y agoMine do this as well, but in PHP. They adopted docblocks over a decade ago and never defined any best practices or used any tools to check them, so comments don't even match the code half of the time. We're on PHP 8 now which can enforce types in the code itself but still have to include docblock types because that's how it has always been done, so the problem persists. It's maddening