Our docs should be more beautiful

[Andrei Alexandrescu via Digitalmars-d]

On 07/18/2016 09:43 PM, Andrei Alexandrescu wrote:
> On 07/18/2016 11:56 AM, Andrei Alexandrescu wrote:
>> I was proofreading
>> http://dtest.thecybershadow.net/artifact/website-f26d7179b8449e89e1961391fde9f221813c707c-04d0496c2d8cecedc4d75c919646d564/web/phobos-prerelease/std_experimental_checkedint.html
>>
>> and there are a few ways in which our docs could look better.
>
> BTW, apparently the ddox version is not generated. Should be at:
>
> http://dtest.thecybershadow.net/artifact/website-f26d7179b8449e89e1961391fde9f221813c707c-04d0496c2d8cecedc4d75c919646d564/web/library-prerelease/std/experimental/checkedint.html
>
>
> but it's not. Vladimir?

Eh, found it at:

http://dtest.thecybershadow.net/artifact/website-32ee0211c7f70b1a06ed3f6ee49f561bee57fee0-ef296f09c3917e6f329f2ca29cbd9f6a/web/library-prerelease/std/experimental/checkedint.html

The ddox version does look nicer. My only nits there are:

* The red underline for links looks jarring, especially in conjunction 
with blue code.

* Look, ma, no boxes - awesome. And most horizontal lines are 
understatedly helpful.

* At the bottom of the page there's an odd "| Page generated by ddox." I 
suppose something should be before the pipe?

* Well the template constraint is not formatted differently/helpfully. 
I'm thinking some stylized comments in conjunction with ddox could work 
miracles here.


Andrei