Rabbit in the Sawfish Capplet's Headlights

[Jeff Waugh <jdub aphid net>]

Hi all,

Okay, so Michael and I have kinda chosen the bits we're interested in doing,
and I'm just about to start putting some of the text I've written into
DocBook format (yes, I'm one of those people who DocBooks afterwards)...

However, I don't want to do this and stuff it up for future integration.


Problem: There is no capplet template, and therefore, no guide to the
integration issues we'll have with such a document.

Problem: Sawfish is an application, and when you put the documentation work
that Michael and I are doing together, it will fill the role of 'application
documentation' quite well.

Problem: I'm doing the capplet options documentation, and that will almost
certainly be referenced as context-sensitive help.


So, what should I do? :)

Given that Michael and I haven't got to the integration stage yet, and that
only parts of the entire document need to be accessible for
context-sensitive help and whatnot, I'm not entirely sure how I should
structure what I'm writing.


If worst comes to worst, I'll just document section by section, without
thought to where these fit into a larger document (let alone help system),
and do the integration later with John and Michael.

- Jeff


-- jdub aphid net ----------------------------- http://lazarus.aphid.net/ --

      I must be getting old... Buying toothpaste with gel in it is no       
                       longer an Absolute Necessity.