I've had similar problems with getting up & running; because it's certainly
not so straightforward; and then after trying and trying I find that it is a
bug or a feature that hasn't yet been implemented.

Some things that would help an absolute beginner
i) a highly *visible* section highlighting what will definately not work -
eg JBoss 3 deployment
ii) a sample small application that can be deployed in, at least, both
WebLogic and JBoss (if possible) - certainly in more than 1 App Server. Just
a small & simple application covering the basics.
(this is what I was working on for myself until I hit the JBoss 3
problems...)
iii) yes, the FAQ will be greatly appreciated

Chris
-=-=-

-----Original Message-----
From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]]
Sent: 24 January 2002 16:01
To: Nortje Andrew
Cc: '[EMAIL PROTECTED]'
Subject: Re: [Xdoclet-user] Documentation


You're right Andrew. We also have to WTFM ;-)

I think Ara made an attempt to set up an FAQ on jguru.com. How's that 
going Ara?

The xtags subproject will describe the tags in one or more xml files. 
These xml files will be used to generate documentation (among other 
things).

Perhaps you have some tips about what you'd like to see in the Howto? -
I mean, it's not always obvious to us developers what is not-so-obvious 
to ordinary users. We'd like to hear your suggestions. How about this:

1) Setting up your Ant build script
2) Writing a simple EJB
3) Building the EJB
4) Deploying the EJB
5) Testing the EJB

Basically everything is in the docs/examples, but I agree with you that 
there is no clear description of the process (what steps to follow in 
what order).

Would this be helpful for newbies?

-Aslak

----- Original Message -----
From: "Nortje, Andrew" <[EMAIL PROTECTED]>
Date: Thursday, January 24, 2002 2:37 pm
Subject: [Xdoclet-user] Documentation

> 
> XDoclet Developers
> 
> I know this is open source but I think a LITTLE more work on the
> documentation will go a LONG way to making this product more 
> usable. I like
> it, I use it, but man it's tough to figure things out.
> 
> Some simple "How to's" would be great. 
> 
> RTFM can't work here
> 
> 


_______________________________________________
Xdoclet-user mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/xdoclet-user

Any e-mail message from the European Central Bank (ECB) is sent in good faith but 
shall neither be binding nor construed as constituting a commitment by the ECB except 
where provided for in a written agreement.
This e-mail is intended only for the use of the recipient(s) named above. Any 
unauthorised disclosure, use or dissemination, either in whole or in part, is 
prohibited.
If you have received this e-mail in error, please notify the sender immediately via 
e-mail and delete this e-mail from your system.


_______________________________________________
Xdoclet-user mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/xdoclet-user

Reply via email to