On his blog today, John Cox has this new article describing what he calls an "example of good PHP development".

BBCode has always bugged me in Xaraya. I never liked the implementation, and it seemed to always be one little problem compiling up against the next. When I added the dp.SyntaxHighlighter it appeared to work just fine, until I realized the loop for the Advanced BBCode would transform the code multiple times. This caused me to search out a little more sturdy way of working with BBCode, while not losing too much of the functionality that I have already introduced.

StringParser_BBCode is an excellent example at how to write solid code and document it the right way. The only thing missing is an XRef showing the PHPDoc codes that the author used. Not only do I have Xaraya's BBCode fixed, but I have an excellent parser to build from for Wiki Syntax and other transforms that we use. I just wish every problem could be solved this easily.

I have to agree on him with one thing (not having the time to pick over the code itself) - the documentation for this project is *very* nice. I do wish that more projects would take th time to work up information like this...