Improved Phobos dox

[Andrei Alexandrescu]

On 9/16/13 11:21 AM, Jacob Carlborg wrote:
> On 2013-09-16 18:22, Andrei Alexandrescu wrote:
>> On the contrary, from what I've read in LaTeX and typography is that you
>> want to keep formatting semantics high level, e.g. "This is a chapter
>> title" as opposed to "this is heading text" or (worse) "this is large
>> text with large spacing".
>
> This is not LaTeX. When using the proper tags you're adding semantic
> meaning to your content.

Same principles apply to LaTeX. Anyhow, the discussions has been 
settled. You are right, and I got convinced.

>> Actually as I noted above that's an issue because we share the same
>> style file between dlang.org and phobos. Of course, we could have two
>> files, but I don't find using classes a shameful alternative.
>
> We most likely should.

Yah, we already have separate ddoc files for the main site and for the 
library. I suspect at a point we'll segregate the css files, too. We 
haven't gotten to the necessity yet.


Andrei