cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jeff Turner <je...@apache.org>
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" <jefft@apache.org> 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">
</div>

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:

http://marc.theaimsgroup.com/?l=forrest-dev&m=104351979527689&w=2

--Jeff

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

---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org


Mime
View raw message