Programming practices vary over time and depend on the preferences of those writing the code. There are some, myself included, who believe the naming convention

Programming practices vary over time and depend on the preferences of those writing the code. There are some, myself included, who believe the naming conventions and organization of the code should be meaningful to make it easier for other developers to read the code. Typically, if code is complex, a comment might be justified, though it often indicates that the code needs to be simplified. Typically, if I write a comment, it will mostly be something along the lines of why we took this approach or any dependencies that aren't obvious. That said, documentation comments (e.g. classes and methods) are useful for automated tools that help developers see API specs or automated swagger/openid UIs.