cocoon-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jeff Turner <>
Subject Re: xdoc -> wiki documentation (Re: documentation in separate cvs module or block)
Date Wed, 19 Feb 2003 14:49:00 GMT
On Wed, Feb 19, 2003 at 01:39:56PM +0000, Pier Fumagalli wrote:
> "Jeff Turner" <> wrote:
> > So I agree with Diana about moving all docs to the Wiki.  It seems the
> > best long-term solution, avoiding all the problems that a dual wiki/xdoc
> > system would cause.
> I disagree on that. IMO the "Wiki" syntax doesn't have the capability to
> contextualize the information contained in the document (how can we tell
> that a "screenshot" is different from a "configuration file snippet?" - in
> "Wiki" it's all a big <PRE>...</PRE> whatever).

In doc-v11 we'd have to abuse <code> to do that.  The XML format is so
limited that this kind of abuse becomes necessary.  We could add
<screenshot> and <configuration> tags, but where does the tag-adding
process end?

Its sad, but right now, CSS-happy XHTML is often more semantically rich
than doc-v11 XML documentation.  We could use:

<div style="configuration">

Which is a DTD-friendly equivalent of <configuration>.

So there's a half-formed plan over in Forrest-land to migrate to XHTML 2
as an intermediate format, and make it one of the frontend formats too:


> Otherwise, what's the point of using XML anyway. I could use FrontPage and
> web folders and get done with it...
>     Pier

View raw message