On Comments in Code

Re:On Comments in Code by pc86 on Tuesday June 15, 2021 @03:08PM (#27520055)

If it's impossible to make "what" clear through the code itself.

[ Parent | on HN ]

Re:On Comments in Code by iudqnolq on Tuesday June 15, 2021 @06:03PM (#27522110)

With a public API it's important to distinguish "currently true from reading the code" and "promised to stay true through minor updates". What comments are useful for that

[ Parent | on HN ]

Re:On Comments in Code by gbear605 on Tuesday June 15, 2021 @05:52PM (#27521981)

If a method is part of an API that might be used by developers external to your team, they don’t want to be looking through your code to figure out how to use your methods.

[ Parent | on HN ]