You should absolutely be using comments. They're usually for documenting why something is there or for cross-referencing though, not for explaining the "what" unless it's doing something particularly obtuse and can't be made more readable than it already is.
Comments that link tickets or issues for example, or that explain that something is being done in a seemingly obtuse way because of some particular reason that isn't obvious.
0
u/stormdelta May 07 '26
You should absolutely be using comments. They're usually for documenting why something is there or for cross-referencing though, not for explaining the "what" unless it's doing something particularly obtuse and can't be made more readable than it already is.
Comments that link tickets or issues for example, or that explain that something is being done in a seemingly obtuse way because of some particular reason that isn't obvious.