Documentation Improvement Initiative

[Les De Ridder]

On Tuesday, 18 February 2020 at 20:50:19 UTC, H. S. Teoh wrote:
> On Tue, Feb 18, 2020 at 07:08:56PM +0000, Adam D. Ruppe via 
> Digitalmars-d wrote:
>> On Tuesday, 18 February 2020 at 18:39:57 UTC, H. S. Teoh wrote:
>> > std.windows.registry does not have any docs.
>> 
>> http://dpldocs.info/locate/?searchTerm=std.windows.registry
>> 
>> 
>> This is one of the big reasons why I decided *against* using 
>> dmd for my doc generation thing - it actually follows 
>> `version` rules which is necessary for compiling, but a bad 
>> thing for docs! So instead I did a separate parser.
>> 
>> Join me and together we rule the Dalaxy with good 
>> documentation!
>
> Maybe we should *replace* the current docs with dpldocs... Make 
> dpldocs the official doc system. Throw out the current 
> half-baked stuff...
>
>
> T

I frankly much prefer the current docs over dpldocs. While dpldocs
might be technically superior, the UI is quite bad, it looks cold 
and
cluttered to me. A large part of this can probably be fixed 
through CSS
changes, though.