That's just lazy javadoc style. The worst kind of documentation, since it adds nothing over looking at code itself. At the very least, there should be examples

That's just lazy javadoc style. The worst kind of documentation, since it adds nothing over looking at code itself. At the very least, there should be examples of usage. I never did PHP, but they have one of the best documentation features: comments. It allows you to recognize if a function is a footgun: https://www.php.net/manual/en/function.utf8-decode.php https://www.php.net/manual/en/function.utf8-decode.php