Redesign of dlang.org

Thomas Mader via Digitalmars-d digitalmars-d at puremagic.com
Thu Dec 24 05:26:19 PST 2015


On Thursday, 24 December 2015 at 06:43:32 UTC, Andrei 
Alexandrescu wrote:
> Currently dlang.org has over 62KLOC of Ddoc source, so any 
> significant surgery on it will be a large effort. Dropping ddoc 
> means we'd need to use another templating engine (getting back 
> to raw html would be too much trouble), and 10 people have 11 
> ideas about which template engine is used by "everyone".
>
> I can give you right now an estimate - dropping ddoc and 
> replacing it with vibe.d is unlikely to be a landslide success. 
> When the alternate documentation was introduced using vibe.d, 
> my hope was that everybody would be all over it like a cheap 
> white suit on rice, and that the use of vibe.d would 
> organically grow to make the stdlib documentation stellar, and 
> then engulf the main site. Sadly participation was scant, and 
> we had a couple of vibe.d-related situations in which the 
> maintainer division (ahem... Vladimir and myself) had no idea 
> on what to do and had nobody to rely on.

Thanks for those details your decision is much more clear now for 
me.
I didn't know that the documentation is switched to vibe.d 
already. So I guess everything comes down to the following 
question. Do you want to drop vibe.d or ddoc as a templating 
engine for the site?
Using both doesn't seem to make any sense and for me it's not 
clear which way you want to go.
I remember the decision being made that vibe.d should be more 
tightly integrated into D and if that is still true the question 
for the templating engine seems to already be settled.
If thats correct then allowing Jacob to do the work with vibe.d 
seems to bring you one step further to the goal to introduce 
vibe.d

> Let me put that another way: for folks who want to improve 
> dlang.org but for whom ddoc is an impediment, the option exists 
> TODAY to work on large parts of the site that have nothing to 
> do with it. Yet from what I can tell nobody is taking it. Would 
> you have an interest? (Serious question.)

At the moment my interest in Web Development is pretty low but I 
am interested to fix errors and add content as I see fit.
For that it's nice if the hurdle is as low as possible.
For me it probably doesn't make any difference if I need to use 
vibe.d or ddoc since I don't know them but I guess one of them is 
better suited for the task.


More information about the Digitalmars-d mailing list