>> Indeed, I agree! PHP was where I started and the user contributions in the 
>> PHP doc was priceless. We could solve that with Disqus 
>> (https://disqus.com/). Just jack in some JS when the refdoc is being run on 
>> pike.lysator.liu.se. I’ve already done that with Google Custom Search:
>> 
> 
> The big problem with user contributions in docs is that the quality
> varies from "good enough to turn appalling docs into something you can
> actually use" to "flat-out wrong and horrendously misleading". Is
> someone going to vet all posts and make sure they're on the better
> side of the scale?

Indeed. I guess moderators (i'm volunteering) would be happy to fix those.

Actually, the main drawback is not to have sample Pike code at all, rather than 
having some sub-optimal one.

-- 
Bertrand LUPART

Reply via email to