My article for PHP Advent 2009, the first in this year's offerings, has been published: http://phpadvent.org/2009/comprehensible-code-by-paul-jones. Summary: "Reading code is hard work. Here are some reasons why, along with some tips on how to make it easier for other developers to understand your code." If you would like to comment on it, please do so here. Thanks!