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.
