É, uma coisa boa do código é que ele sempre pode ser modificado, para melhor ou para pior (e nós sempre fazemos de tudo para que seja para melhor!) Por exemplo, o arquivo wp-admin/includes/template.php, no WordPress 2.6 começava da seguinte forma:
//
// Big Mess
//
// Big Mess
//
// Ugly recursive category stuff.
Hoje em dia, o comentário é:
/**
* Template WordPress Administration API.
*
* A Big Mess. Also some neat functions that are nicely written.
*
* @package WordPress
* @subpackage Administration
*/
* Template WordPress Administration API.
*
* A Big Mess. Also some neat functions that are nicely written.
*
* @package WordPress
* @subpackage Administration
*/
// Ugly recursive category stuff.
Além disso, a maiora das funções nesse arquivo começou a ganhar alguma documentação do PHPDOC… 