Change Details

We still use doxygen to generate our php documentation. But let's be honest. It's terrible... As we have further improved our documentation quality and consistency, our coding style etc, CI of our code, our generated documentation has been rather neglected so far, and none more than our [[ https://doc.wikimedia.org/mediawiki-core/master/php/ | MediaWiki Core documentation ]]. doxygen is ancient, and terrible as a reader experience. It also doesn't mark deprecated functions etc. We should consider alternate options like: * Apigen: [[ http://docs.aws.amazon.com/aws-sdk-php/v3/api/ | AWS example ]] * PHPdox: [[ http://phpdox.de/demo/PHPUnit/index.xhtml | phpdoc example ]] * PHPDocumenter: [[ http://demo.phpdoc.org/Clean/ | Example ]]