Slash Boxes
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

use Perl Log In

Log In

[ Create a new account ]

cwest (1514)

  (email not shown publicly)
AOL IM: caseyrwest (Add Buddy, Send Message)

Perl geek.

Journal of cwest (1514)

Thursday January 10, 2002
12:50 PM

Template Toolkit CookBook and ... Wiki's

[ #2044 ]

Some folks want to see the TT CookBook be a Wiki site. I'm nervous about this for several reasons.

Most of them I can keep to myself as thier about quality control and editing and such...

My biggest worry is, well, take a look at the PHP online documentation. They implemented a Wiki and their docs have become obsolete and cluttered with tons of useless stuff.

If that's any indication of how Wiki documentation works.. it scares me.

On the other hand, if there were a process for publishing up-to-date cookbooks *to* a Wiki site, that would make it more interesting.

I refuse, however, to make a Wiki be the central source of the cookbook.

You'll download the cookbook, or view it online just like any other documentation. If you want to discuss it, perhaps that's the place for a Wiki.

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
More | Login | Reply
Loading... please wait.
  • I like the idea that you mention of making it into a 'real' book. Wiki and suchlike are essentially editorless systems, meaning that the most important information is not always displayed first. The problem with such sites is there is no flow. TT has lots of documentation already...mostly this needs structuring into some kind of "this is how to do this" way, and more importantly, some kind of "read this"..."now read this" way.

    However, that said, with wiki the JFDI aspect is really high. I want to write

  • ActiveState has an XSLT and Python Cookbook project ongoing. You might want to check their site out to see how it works (I think it's basically Wiki + node rating)