The current inline documentation often uses HTML markup, for example here:
https://github.com/yiisoft/yii/blob/master/framework/web/CUrlManager.php#L18
I wonder if it would not make more sense to use markdown for this kind of documentation. It’s much easier to parse and also much more readable in raw format.
Thoughts?