Matt Dowell, a coworker of mine, wrote up a quickstart guide:
http://wiki.opensymphony.com/space/WebWork2+QuickStart+Guide
-Original Message-
From: Jason Carreira
Sent: Sunday, September 14, 2003 11:34 PM
To: [EMAIL PROTECTED]
Subject: [OS-webwork] Documentation
I updated a
Joseph Ottinger wrote:
He was probably offended by all the horrible negativity aimed at him on
#java.
What was said about him on #java?
/Rickard
---
This SF.NET email is sponsored by:
SourceForge Enterprise Edition + IBM + LinuxWorld =
On Thu, 9 Jan 2003, [ISO-8859-1] Rickard Öberg wrote:
Joseph Ottinger wrote:
He was probably offended by all the horrible negativity aimed at him on
#java.
What was said about him on #java?
I dunno, probably something like Ken is supposed to be doing
documentation, which is really cool,
Joseph Ottinger wrote:
Joseph Ottinger wrote:
He was probably offended by all the horrible negativity aimed at him on
#java.
What was said about him on #java?
I dunno, probably something like Ken is supposed to be doing
documentation, which is really cool, esp. since he apparently has
Well maven appears to be a build system that replaces a lot of
functionality that ant already provides. I'd rather see maven
distributed as pre-defined ant build targets rather than it's own
system per se. I'm in the b/w camp re: maven and it's usefulness. but I
get an uncomfortable feeling
: Thursday, December 12, 2002 11:05 PM
Subject: Re: [OS-webwork] Documentation
Exactly. This documentation thread has gone on long enough, overall
consensus seems to be a yes to xdocs, and an no to maven. The very fact
that the 'simple mavenising' posted on here says that one has to get
maven out
-
From: Ken Egervari [eXtremePHP] [EMAIL PROTECTED]
To: [EMAIL PROTECTED]
Sent: Friday, December 13, 2002 12:40 AM
Subject: Re: [OS-webwork] Documentation
Despite the maven issues, no one responded to my last post to the
newsgroup
which investigated some other concerns I had about the xdoc
a perfectly
valid document according to the xml schema (which I already made yesterday).
Cool,
Ken
- Original Message -
From: Patrick Lightbody [EMAIL PROTECTED]
To: [EMAIL PROTECTED]
Sent: Friday, December 13, 2002 3:44 AM
Subject: Re: [OS-webwork] Documentation
Ken,
Do whatever you think
but remember - this is more like a book
Yep, so why not to go with LaTeX, FrameMaker, InDesign, Quark Xpress,
PageMaker or some other utility that suits better? Then just provide us
with PS and PDF, and maybe other file formats.
Some argue that we need to use simple format, so that anyone can
Ken,
You bring up a lot of interesting things here, I¹ll try to reply below
(note: I¹m far from a documentation expert).
Well, I've been looking at a bunch of technologies that we can use to build
the documentation, but I'm not convinced that Maven will help us. Maven is an
interesting
Hi Mike,
Well, we have a few issues. I'm thinking about the big picture in that XML
some form of XSLT (or something else) is beneficial, but I also wanted to
stike a balance in that many people didn't want the bloated libraries to be
involved (or to be abstracted away from them if they were).
Hani Suleiman wrote:
I'm actually fairly strongly against maven. It's a huge project, and
almost all of the websites produced by it have a cookie cutter feel to
it. I also disagree with it being 'the way of the future'. It might be a
fashionable choice for many OSS projects, but so are a lot
PROTECTED]
To: [EMAIL PROTECTED]
Sent: Thursday, December 12, 2002 6:52 AM
Subject: Re: [OS-webwork] Documentation
I'm actually fairly strongly against maven. It's a huge project, and
almost all of the websites produced by it have a cookie cutter feel to
it. I also disagree with it being 'the way
-Original Message-
From: [EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED]]On Behalf Of
Ken Egervari [eXtremePHP]
Sent: 12. desember 2002 12:38
To: [EMAIL PROTECTED]
Subject: Re: [OS-webwork] Documentation
Hi Mike,
Well, we have a few issues. I'm thinking about the big picture
OK - let me reply to this one differently :)
As for Maven, producing a website is to me one of the minor features. It is
a fantastic build system, but I agree it is too 'rough' at the moment for
use on a project like WebWork.
I was merely suggesting xdoc as a format as it is simple, and does
-Original Message-
From: [EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED]]On Behalf Of
Hani Suleiman
Sent: 12. desember 2002 12:52
To: [EMAIL PROTECTED]
Subject: Re: [OS-webwork] Documentation
I'm actually fairly strongly against maven. It's a huge project, and
almost all
we are in agreement then =)
- Original Message -
From: Mike Cannon-Brookes [EMAIL PROTECTED]
To: [EMAIL PROTECTED]
Sent: Thursday, December 12, 2002 7:25 AM
Subject: Re: [OS-webwork] Documentation
Ken,
Just to clarify:
1) xdoc is good - it's simple and easy to use.
2) Adding 'bulk
: RE: [OS-webwork] Documentation
-Original Message-
From: [EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED]]On Behalf Of
Ken Egervari [eXtremePHP]
Sent: 12. desember 2002 12:38
To: [EMAIL PROTECTED]
Subject: Re: [OS-webwork] Documentation
Hi Mike,
Well, we have a few
Ken,
Just to clarify:
1) xdoc is good - it's simple and easy to use.
2) Adding 'bulk' to the build is fine, as long as it's still _simple_ to
build (ie downloading a JAR from CVS that's just 'used to build docs' is no
problem)
3) SiteMesh is used for the website presentation, not for the docs.
Hello,
Mike Cannon-Brookes wrote:
Ken,
snip/
Personally I'd vote for xdocs without Maven at the moment, that gives us a
good upgrade path to Maven (if we decide to use it) or to any other XML
based doc format (as xdocs are XML files already).
Sure. However, why not check in the Maven
bit. I liked the xdoc format, however and was planning on using that
regardless.
Ken,
Not sure if we are going to use Maven (Mike likes it, Rickard doesn't, I
sorta-like-it-sorta-hate-it). I'm sure everyone else out there falls
somewhere in one of those three categories. BUT, since you're
Why not use IBM Bookmaster :) I wrote a whole manual with that once,
talk about painful!
On Wed, 2002-12-11 at 04:31, Joseph Ottinger wrote:
How about using, oh, PF:Word then? That would rock and have a cool gee,
I'd forgotten that existed factor. :)
On Wed, 11 Dec 2002, Robert Nicholson
know your thoughts.
Ken
- Original Message -
From: Patrick Lightbody [EMAIL PROTECTED]
To: [EMAIL PROTECTED]
Sent: Tuesday, December 10, 2002 10:23 AM
Subject: Re: [OS-webwork] Documentation
Ken,
I tend to prefer simple HTML documentation. XML - XSLT - HTML is
overkill.
I nice batch
compatibility with the current method while still going with XML+XSLT.
- Original Message -
From: Hani Suleiman [EMAIL PROTECTED]
To: [EMAIL PROTECTED]
Sent: Tuesday, December 10, 2002 11:49 AM
Subject: Re: [OS-webwork] Documentation
Well, they were changed to jsp, which is the worst of both
: Tuesday, December 10, 2002 10:23 AM
Subject: Re: [OS-webwork] Documentation
Ken,
I tend to prefer simple HTML documentation. XML - XSLT - HTML is
overkill.
I nice batch of HTML files should suite us well.
-Pat
- Original Message -
From: Ken Egervari [eXtremePHP] [EMAIL
[eXtremePHP] [EMAIL PROTECTED]
To: [EMAIL PROTECTED]
Sent: Tuesday, December 10, 2002 8:59 AM
Subject: Re: [OS-webwork] Documentation
I'll devise 2 stylesheets then. One to transform the document for local
viewing and another to make them look the same way they are now with the
.jsp extension
A bit No f'ing way from me on the Word 2000 idea ;-)
xsl:fo etc will allow you to generate a PDF .. I'm sure Ken knows how to get
a PDF from XML.
---
This sf.net email is sponsored by:ThinkGeek
Welcome to geek heaven.
http://thinkgeek.com/sf
On Tuesday, Dec 10, 2002, at 16:32 Europe/London, Ken Egervari
[eXtremePHP] wrote:
XSLT will also help us out if the website presentation layer changes
or when
we decide to compile the manual into a PDF document (which I really
hope we
do since PDF is a fantastic format for printing and
. desember 2002 19:00
To: [EMAIL PROTECTED]
Subject: Re: [OS-webwork] Documentation
On Tuesday, Dec 10, 2002, at 16:32 Europe/London, Ken Egervari
[eXtremePHP] wrote:
XSLT will also help us out if the website presentation layer changes
or when
we decide to compile the manual into a PDF
-Original Message-
From: [EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED]]On Behalf Of
Bill Burton
Sent: 10. desember 2002 21:05
To: [EMAIL PROTECTED]
Subject: Re: [OS-webwork] Documentation
Hello,
Aslak Hellesoy wrote:
Why don't you write documentation in xdoc format
PROTECTED]
Sent: Tuesday, December 10, 2002 10:23 AM
Subject: Re: [OS-webwork] Documentation
Ken,
I tend to prefer simple HTML documentation. XML - XSLT - HTML is
overkill.
I nice batch of HTML files should suite us well.
-Pat
- Original Message -
From: Ken Egervari [eXtremePHP
PS That said, he who wants to write the documentation gets to choose how
it
is done.
Amen to that! Ken, please don't take any of our (my) comments as a negative
thing, I'm just giving you alternate feelings about various formats. But
yes, at the end of the day, it's all up to you -- you're the
PM
Subject: Re: [OS-webwork] Documentation
I agree that the documentation should certainly be available out of the
box.
My experience is that, however, one needs to make documentation as simple
as
possible to write.
Look at how much documentation and knowledge the Wiki has created compared
, 2002 4:31 PM
Subject: Re: [OS-webwork] Documentation
I agree that the documentation should certainly be available out of the
box.
My experience is that, however, one needs to make documentation as simple
as
possible to write.
Look at how much documentation and knowledge the Wiki has
] [EMAIL PROTECTED]
To: [EMAIL PROTECTED]
Sent: Tuesday, December 10, 2002 12:06 AM
Subject: Re: [OS-webwork] Documentation
Everyone,
Actually, what I actually wanted to do was combine all the forms of
documentation written by various people and consolidate it into a book
fashion. That way
PROTECTED]
Subject: Re: [OS-webwork] Documentation
I think I'll look into this xdoc approach as I have not used it myself
although I'm sure it's very similar. If it can do direct xml - pdf
generation with 'zero' code (in addition to formats like html),
then I'm all
for that =)
I'll get back
-
From: Ken Egervari [eXtremePHP] [EMAIL PROTECTED]
To: [EMAIL PROTECTED]
Sent: Tuesday, December 10, 2002 12:06 AM
Subject: Re: [OS-webwork] Documentation
Everyone,
Actually, what I actually wanted to do was combine all the forms of
documentation written by various people
37 matches
Mail list logo