I would like to see some more usage of PHPDoc comments.
As a quick test I modified the Page class to include @property comments for all the magic properties, and it works great so far. My IDE now doesn't show warnings for things like $page->name and even gives me autocompletion.
I think it would q...