I'm a professional PHP, Python and Javascript developer from the UK. I've worked with Django, Laravel, and React, among others. I also maintain a legacy Zend 1 application.
I think comments are generally useful, but should be a last resort for explaining how something works.
DocBlock-style comments, for instance, are a poor substitute for actual parameter and return types. Where possible one should always set explicit parameter and return types in preference to setting them in a DocBlock, as these will be enforced by the language and so can't get outdated without explicitly breaking the response. For languages that don't support these, there are often other solutions, such as Flow in Javascript.
Some comments have been hidden by the post's author - find out more
For further actions, you may consider blocking this person and/or reporting abuse
We're a place where coders share, stay up-to-date and grow their careers.
I think comments are generally useful, but should be a last resort for explaining how something works.
DocBlock-style comments, for instance, are a poor substitute for actual parameter and return types. Where possible one should always set explicit parameter and return types in preference to setting them in a DocBlock, as these will be enforced by the language and so can't get outdated without explicitly breaking the response. For languages that don't support these, there are often other solutions, such as Flow in Javascript.