--- Ian Bicking <[EMAIL PROTECTED]> wrote: > The documentation format discussion kind of died down, but I'd like > to > do some documenting, and that's one of those fleeting motivations you > really have to grab onto ;) Anyway, after looking some at the XML > produced by reST, I think the format doesn't imply any great lock-in. > > And I like writing it, so I'd like to use it. But this effects all > the > developers who might write documentation, since one of the first > things > I want to do is rewrite the current WebKit documentation, expanding > and > checking for accuracy. I'm not planning to do anything too exciting > at > this point (no doc strings or literate programming or new tools or > anything), just trying to get the basic documentation in good shape. > > Shall I go forward or do we need more discussion about this? > > Ian > At the risk of making the documentation project even harder, it seems to me the best place to create Webware documentation is in a TWiki-like environment because mass participation would be so easy. Having looked over the reStructuredText specs a bit, I rather like it because it seems pretty simple.
There has been talk now and then of a Webware based Wiki (a WikiKiti? ;). How difficult/feasible it would be modify your Wikiware code to utilize reStructuredText? Roger __________________________________________________ Do you Yahoo!? HotJobs - Search new jobs daily now http://hotjobs.yahoo.com/ ------------------------------------------------------- This sf.net email is sponsored by:ThinkGeek Welcome to geek heaven. http://thinkgeek.com/sf _______________________________________________ Webware-discuss mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/webware-discuss
