PHP Documentor 3 VS fig-standards

Also note that the tools ecosystem (IDEs and static analyzers such as PHPStan and Psalm) generally support more detailed types than you'll find in the RFC or the "official" PHPDocumentor project documentation, and they're continually evolving.

When running this command in your console, Artisan will create a new Controller in the app/Http/Controllers folder with some predefined methods, all these methods are related to API resources, all methods generated by the command have comments in the PHP DOCS standard (See More), with a brief description of each one's functionality.

PHPDoc

The original implementation, if I'm not wrong, was created by phpDocumentor, then it merged its codebase with a competing tool and now many programs contribute with their own annotations and formats.

Another future project would be to see if it could be integrated in https://www.phpdoc.org/

These are PHPDoc annotations. In addition to their original purpose of documenting code for humans, they're used by a range of other tools and IDEs to aid with things like type detection and other code enrichment.

I think the original tool that implemented those annotations was phpDocumentor (if it wasn't the first, it was certainly among the pioneers), inspired by Javadoc. The original purpose was to generate documentation but, as it got popular, IDEs followed suit and started using annotations to provide code intelligence features. As of today, it's also used by code quality tools to identify potential bugs.

And the github repo: - github.com/phpDocumentor/phpDocumentor/

The namespaces and class names must follow this example.

I would familiarize yourself with the following PHP standards: https://www.php-fig.org

The PHP Standard Recommendation, or PSR for short, from the aforementioned PHP-FIG.

That's what happens if you use a PSR-4 autoloader and not utilise PSR-4 in your project structure 👀 So either use PSR-0 or properly use PSR-4.

PHP really "got it's act together" in my view when packagist and composer (which are PHP's equivalent of npm) became mainstream and with the release of the PSR community standards. We were admittedly a little behind the curve with regards to package managers but with standardised formats and not having to copy and paste zip file libraries anymore, PHP received a new lease of life.