Hi Aaron,
It is great to see so much content in your "work-in-progress". I understand
that some of the content is still to be verified so I'll come back when I've
had a chance to test/verify whatever I can.
One point I'd like to put across though is that the structure of the manual
should better reflect the different knids of people/roles that it is
targetted at (I am not keen on multiple manuals). I *really* like Kunle's
structure in the FAQ document where he has the document logically divided
for Bean Developers, Server Administrators and Container Developers.
My view is that the manual should cater for (and be organized logically for)
Bean Developers and Server Administrators. Container Developers are a
different breed entirely and a separate "Hackers guide to jBoss
spoon-bending..." should be considered for them.
Quick attempt at logical partitioning (with input from Kunle):
General
- Introduction (to the jBoss Suite of programs)
- Installation
- jBoss
- spyderMQ
- ....
- ...
- Troubleshooting
- Support
Server Administrator
- jBoss
- Start/Stop
- Client Configuration
- Server Configuration
- Deploying EJBs
- Managing jBoss
- spyderMQ
- Start/Stop
- Client Configuration
- Server Configuration
- spyderMQ Management & Tools
- Third-party Integration (server-side)
- Tomcat
- Resin
- etc...
Bean Developer
- Intro to devloping with jBoss (incl. Bean Developer Licensing issues)
- Developing with EJB (jBoss)
- Developing with JMS (spyderMQ)
- Third-party tools (useful to developers)
- Cocobase
- Castor
- Kawa
- etc...
Cheers!,
Micheal
> -----Original Message-----
> From: [EMAIL PROTECTED]
> [mailto:[EMAIL PROTECTED]]On Behalf Of Aaron Mulder
> Sent: 05 October 2000 03:13
> To: jBoss User List
> Subject: [jBoss-User] Preliminary Manual Feedback
>
>
> The manual is on the web site, and it's definitely a
> work-in-progress. About half the sections have been filled out, though
> there are still some holes even in those.
> But as long as we're working on it, I wonder if any of you have
> feedback about it. The table of contents is intended to be complete, so
> does it look like it addresses the things you need to know? Are there
> other topics you'd like to see covered?
> For the sections that are there, what do you think? Are there
> enough examples? Is the level of detail appropriate?
> Any comments along those lines or any other would be helpful -
> we'd like to make this a useful reference.
>
> Thanks,
> Aaron
>
> http://www.jboss.org/manual/
>
>
>
> --
> --------------------------------------------------------------
> To subscribe: [EMAIL PROTECTED]
> To unsubscribe: [EMAIL PROTECTED]
> Problems?: [EMAIL PROTECTED]
>
--
--------------------------------------------------------------
To subscribe: [EMAIL PROTECTED]
To unsubscribe: [EMAIL PROTECTED]
Problems?: [EMAIL PROTECTED]
