News for hackers. Stuff that matters.
Re:Ask HN: Is it normal to not have comments in a company's ... by al2o3cr on Wednesday July 13, 2022 @01:22PM (#32085823)

    all the internal tools and acronyms that are not explained anywhere
YMMV, but comments are not usually the best place for this kind of background information as you have to FIND the source file they're in before you can read them. Many teams will keep an external "glossary" of common acronyms and tools in an external data store (wiki / Confluence / etc). If your company doesn't have one, consider _starting_ one as you already need to ask what all those things are anyways and can collect the answers.

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)

There are no comments on this comment yet.