|
From: Thomas R. <tri...@tr...> - 2003-04-27 15:42:51
|
I think Isabelle meant the upp front work of figuring out how to use Maven. The amount of new APIs/utilities/frameworks that we have to keep up with is overwhelming, and sometimes it is better to stick with what you already know. On the other hand, if there is a project member that already knows Maven and is willing to do the configuration/education that is necessary, then this would be a nice option. You and Luke seems to be the ones with Maven experience. Thomas > I thought the whole point of maven was to reduce the amount of work > needed to create a project web site and documentation. > > If maven is too "heavy weight", perhaps the Forrest project would be > more to your liking. The docs are in a "docbook-lite" XML > format and out of the box it generates HTML and PDF. Having the site > and docs in XML will make it easier to keep the site > consistent and make it easier for folks to contribute good docs. > > I am currently working on a doc for the uPortal project using Forrest. > Here are example links: > > source document: > http://rci.rutgers.edu/~wgthom/forrest/site/eclipse-uportal-howto.xml > generated html: > http://rci.rutgers.edu/~wgthom/forrest/site/eclipse-uportal-howto.html > generated pdf: > http://rci.rutgers.edu/~wgthom/forrest/site/eclipse-uportal-howto.pdf > > later. > Bill > > > > Isabelle Muszynski wrote: > > Hi guys, > > > > Forgot one point : maven. > > I think we already have a lot to worry about (i.e. work for) without adding one more ingredient to the stew. Maven looks really good, and we should use it at some point, but can we please try to get a release out without having to learn yet one more thing? > > If we talk about a standard format for docs, then I like docbook and FOP. But it means having to write xml, which isn't as easy as writing text. > > Right now I'm planning to produce PDF's for the docs, it's portable and everybody has a viewer. I'll also be able to produce HTML from the docs, so that we can put an online version on the website. > > > > Isabelle > > > > > > > > ------------------------------------------------------- > This sf.net email is sponsored by:ThinkGeek > Welcome to geek heaven. > http://thinkgeek.com/sf > _______________________________________________ > Springframework-developer mailing list > Spr...@li... > https://lists.sourceforge.net/lists/listinfo/springframework-developer > > -- Thomas Risberg tri...@tr... |