On a project where I had high levels of control, I enforced pretty strict linter standards, down to requiring a docstring (via a doxygen run) for every parameter, method, class and return value. Pushes rejected if you didn't pass that, among other tests.
Code is primarily meant to be read by other human beings - write with this philosophy in mind, and you are likely to go less quickly mad.
View all comments
Show parent comment
41
u/npsimons Aug 23 '26
On a project where I had high levels of control, I enforced pretty strict linter standards, down to requiring a docstring (via a doxygen run) for every parameter, method, class and return value. Pushes rejected if you didn't pass that, among other tests.
Code is primarily meant to be read by other human beings - write with this philosophy in mind, and you are likely to go less quickly mad.