PHP attributes are a useful documentation tool, but they are a terrible documentation strategy on their own. That is the short version. The appeal is obvious.
Source: [Dev.to](https://dev.to/saqueib/php-attributes-can-help-your-docs-but-they-wont-save-them-5bnn)