Our docs should be more beautiful

qznc via Digitalmars-d digitalmars-d at puremagic.com
Mon Jul 18 14:26:18 PDT 2016


On Monday, 18 July 2016 at 15:56:29 UTC, 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.
>
> * My pet dream was to work on a project with a beautiful 
> justified and hyphenated website. After endless debates, 
> ugliness has won - I'm looking at a eye-scratching ragged right 
> edge.

The "ragged" left is more ugly. If you want a be beautiful, the 
left side should align, but every text is indented differently 
due to boxes/lines.

> Literally all vertical spacing is larger than it should be.

I would disagree, but at this level it is bike shedding.

There should be more vertical space. For example, I would 
increase the line height a little and the lines are too wide.

Does it make sense to work on this soon-to-be-replaced styling?


More information about the Digitalmars-d mailing list