On Thu, 10 Aug 2000, Jon Stevens wrote:
> on 8/10/2000 9:05 PM, "Jason van Zyl" <[EMAIL PROTECTED]> wrote:
>
> > Does anyone object to using stylebook? Is there
> > something better?
>
> I would prefer just plain HTML either done by hand or with an editor like
> Netscape Composer or DreamWeaver.
>
> The reason is that it turns out that maintaining anything else is a major
> PITA.
Any particular reason? I asked Kevin what he thought of stylebook
but he hasn't answered me yet.
I was thinking of using XML so that we could produce other forms
of output like a PDF manual. If we use stylebook or some XML
format, I can probably get a volunteer with some good editing skills to
take over the maintenance of the docs.
> We could do the documentation in Turbine itself, but that would be cruel and
> unusual punishment since there wouldn't be a bootstrap process. :-)
That would actually be possible with the TDK. We could even do the
docs with WebMacro, dynamic via turbine or just output a static
tree of docs.
I just think stylebook can make some consistent looking
docs relatively quickly. I've never used stylebook is it
not very fun to work with?
jvz.
--
Jason van Zyl
[EMAIL PROTECTED]
------------------------------------------------------------
To subscribe: [EMAIL PROTECTED]
To unsubscribe: [EMAIL PROTECTED]
Search: <http://www.mail-archive.com/turbine%40list.working-dogs.com/>
Problems?: [EMAIL PROTECTED]
