On Tue, 24 Jan 2006 17:22:35 +0530, "quasi" <[EMAIL PROTECTED]> said: > why not just create a page like cffi-examples at the cliki and link it > from the CFFI page ? Or just add the example at the bottom of the > cffi page itself if it is not too long ? >
I was dimly aware of the cliki, but my main memory was that it was confusing. When I looked, I couldn't find a place where a contribution would be findable by others. In others words, the cliki looks vast but hard to use. Its mandate is "everything", which is a bit wide. The CL cookbook looks well-structured, usable, but nontrivial to contribute to and (not coincidentally) too small to be very useful. Apropos of these problem with cliki and clcookbook, I just got a reply back from Edi Weitz. He founded the CL cookbook and has authorized me to cc his email onto this list. Notably, he mentions he'd welcome someone taking over the project. Edi Weitz writes: <edi> Hi Alexis! I'm not subscribed to the gardeners list but it's fine if you want to forward my reply to them. The CL Cookbook is obviously not doing very well at the moment. It seems that all contributors (including myself) are too busy with other things. However, new contributors are always welcome. If you want to add something, just email me and I'll set up the necessary commit rights. Having said that, I also wouldn't mind if someone would want to take over my task of maintaining the whole project (which at the moment isn't much more than adding new contributors every now and then). As far as converting the project to a Wiki-like thingy - well, I don't believe in Wikis. I think that to achieve an overall level of correctness and conciseness you need some editorial control and a group of contributors which agree on certain standards. In fact, a documentation project aimed at newbies where every random Joe User can add or modify stuff is potentially more dangerous than helpful - just check out how much wrong advice is given on c.l.l. (and made immortal by Google Groups). What the CL Cookbook needs is more quality content, not necessarily a new infrastructure. But that is just my personal opinion. The license of the CL Cookbook obviously allows you take the content as a starting point for a new project. Cheers, Edi. </edi> >From his reply, it sounds like the CL cookbook could benefit from gardening help. Also, it sounds exactly like the kind of resource that would help newbies. Also, he says he'd welcome someone taking over the management. Hmmm... I happen to agree with Edi that a raw wiki can be unhelpful (see my complaints about cliki above). But I think I disagree with in thinking the remedy is an infrastructure that requires "designated contributors" (which ends up reducing casual contributions). Instead I'd imagine the best middle ground is setup that allows for very easy contributions (either a posted email address, or through a wiki), but also includes a stable core of custodians who care about its quality and keep it accurate and tidy. I'd imagine most of the work would be deleting obsolete material, maintaining formatting standards, keeping everything organized, and cross-referenced. Perhaps this is merely the distinction between editorial effort and editorial control. A practical approach to this question: how did the Perl community do it? Is this a worthwhile gardening project, or just a diversion of overdiluted resources? It seems like the CL community has a million small unused documentation projects, so maybe one more is not a good thing. What do others think? alexis _______________________________________________ Gardeners mailing list [email protected] http://www.lispniks.com/mailman/listinfo/gardeners
