Ask HN: Is it normal to not have comments in a company's code?
A month ago I started a SDE internship at a medium company, this is my first time working with code at a company.
When I look at existing company code, nothing has any kind of comments, it makes it really hard to understand the code because of all the internal tools and acronyms that are not explained anywhere.
And, in my PR reviews I am told to delete my comments to my code before I push it, even for the initial self project that they set me to do and which will only be used by me and my manager.
Is it normal to not use comments in a company?
(
7 comments
| 2 points
| on HN
)
Also consider if there's a better alternative to comments within your language's tooling - for instance, many languages now support generating human-readable documentation from metadata in source files (JavaDoc, ex_doc, YARD, etc)
Do they claim they've written code before but it goes to another school?
I don't know who came up with the policy, but it's someone high up because it's company-wide. It's based on the Uncle Bob recommendations, ostensibly. Shrug
Now, it would be good for you to understand if there's a rationale behind this (which would still be a major red flag), or if it's only a loose practice no one tried/succeeded to change.