Documentation Improvement Initiative

[bachmeier]

On Wednesday, 19 February 2020 at 11:15:33 UTC, Les De Ridder 
wrote:
> 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.

I agree. It's not a problem for me, but if it's the *official* 
documentation generator, it needs a better design. That shouldn't 
take much though. These days there are tons of static site 
generators, so it's easy to steal a design.