avalon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Farr, Aaron" <Aaron.F...@am.sony.com>
Subject RE: Documentation
Date Mon, 21 Jun 2004 21:35:22 GMT


> -----Original Message-----
> From: Niclas Hedhman [mailto:niclas@hedhman.org]
> 
> > Beside that we - or maybe only I - have multiple requirements on the
> xdoc
> > -> output generation:
> 
> > 1) HTML based output for: our website, eclipse help etc.
> > 2) Word / PDF output with various layouts: for us / my customers etc.
> 
> PDF support is on the 'Wanted" list for sure, but _I_ feel hesitant to
> invest
> the effort, when there is no 'specification' on the xdoc format we are
> using.

There may not be a specification, but from what I've seen we're still using
the Anakia format.  Our navigation.xml files are the same as the ones used
in Maven.  We're just transforming them differently (*very* differently).

As for PDF generation, I imagine we could reuse a lot from the maven pdf
plugin which has come a long way:

 http://maven.apache.org/reference/plugins/pdf/goals.html


> _I_ am fairly negative to have Wiki as the primary documentation tool. How
> do
> you plan to do site navigation for instance?

See my blog entry:

http://www.jadetower.org/muses/archives/000051.html

several codehaus projects have now very successfully done this.  See the
picocontainer site: http://picocontainer.org/.  Notice the [edit] link at
the bottom of each page.  The whole site is wiki-based.

J. Aaron Farr
  SONY ELECTRONICS
  STP SYSTEMS
  (724) 696-7653

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


Mime
View raw message