Improved Phobos dox

[Andrei Alexandrescu]

On 9/16/13 9:44 AM, Vladimir Panteleev wrote:
> I noticed the change: dd -> div. This is bad, because it reduces semantics.

The change was from unqualified <dd> to <div class="param">. Big difference.

Now you're arguing that <dd class="param"> is better than <div 
class="param">. This is more interesting, and I'd like to get convinced 
one way or another.

For my part I prefer the minimal commitment of <div> - just leave it to 
the style to decide how to go about things. So I have minimal hardcoding 
of semantics in the generated html, and maximum flexibility in the CSS - 
I can get to hide the thing altogether, or format it in ways that are 
very different from classic <dd>.

> Your example is: i -> span class="param". This is good, because it
> improves semantics.

Great.


Andrei