Fixed date to move to ddox for Phobos documentation

Andrei Alexandrescu via Digitalmars-d digitalmars-d at puremagic.com
Fri Jun 10 10:33:01 PDT 2016


On 6/10/16 3:17 PM, Martin Nowak wrote:
> On 06/04/2016 09:32 PM, Andrei Alexandrescu wrote:
>> Sounds good to me, thanks. Delegation/lieutenantship/empowering for the
>> win. I think we should also secure Martin's buy-in to make sure. -- Andrei
>
> I'm fine with switching to ddox, could have happened a while ago.
> Would be worth to switch for the auto-complete alone.

Awesome!

I should add that it would be valuable to keep the ddoc build as well. 
In my introductory material on D I discuss the basic elements of 
distribution: function, unittest, doc, deployment. It is compelling to 
mention that we build the stdlib documentation using the same means. An 
introduction to ddox at that point would be too much, and mentioning 
that "well ddoc isn't good enough for the official stdlib doc" does not 
sit well.

> I'd want to disable or replace discourse before we make it our official
> documentation. We could easily self-host some commenting functionality
> if deemed necessary, but adding an unmaintained communication channel
> isn't the best idea IMO.

I'm a bit bummed about that. I like it. Is my understanding incorrect 
that disqus is fairly established by now? I see it on a bunch of legit 
sites, and it seems to add value to those as it could add to ours.


Andrei



More information about the Digitalmars-d mailing list