Hi Jennifer,
I looked again at the task analysis for JRuby. Most of the tasks seem to
belong in the Administrator's Guide and the Deployment Guide.
Of the developer tasks, very few seem to be in the realm of GlassFish.
They either seem to be generic jRuby tasks (out of scope) or performed
by using NetBeans (should be in the NetBeans documentation).
Please look at the task analysis again and separate out the "out of
scope" tasks (just put them under the heading "Out of Scope Tasks").
For the remaining tasks, please label them according to where they
should be documented.
After you have revised the task analysis, let's look again to see if
there are enough "in scope" tasks without a home to warrant a separate a
separate book.
I'm not sure I can answer your question about NB vs. CLI instructions
because I am not sure where the CLI is coming from. If the CLI is coming
from NB, it should be explained in the NB documentation. If the CLI is
generic to jRuby, it's out of scope. Only if the CLI is part of
GlassFish do we need to document it.
Hope this helps.
Regards,
-Paul
Jennifer Ball wrote:
> Hi Paul,
>
> I think we'll need a separate book for JRuby. I didn't see it listed
> there. We might also need a CVS repository too.
>
> Also, I remember someone asking about NB vs. CLI instructions, but I
> don't recall the answer. Do we use NB instructions or CLI
> instructions? The reason I ask is because a lot of the existing
> documentation (blogs and GS guides, etc) are written using the various
> NB plug-ins. OTOH, the tools group has their own NB-specific
> documentation for JRuby and jMaki. This isn't really an issue with
> Comet because there is no tools support.
>
> Thanks.
>
> Jennifer
>
> Paul Davies wrote:
>
>> Hi,
>>
>> Although work on the documentation for GlassFish v3 TP2 is well under
>> way, I thought it would be worth rechecking our assumptions for TP2 in
>> the light of the information that Abhijit shared at the GlassFish v3
>> doc planning meeting last week.
>>
>> Please review the TP2 deliverables at
>> http://wiki.glassfish.java.net/Wiki.jsp?page=GlassFishV3DocPlan#section-GlassFishV3DocPlan-TP2Deliverables
>> and let me know if I have correctly identified the primary usage
>> scenarios for TP2 and the documentation deliverables required for
>> those usage scenarios.
>>
>> If possible, please give me any feedback you have by the end of this
>> week.
>>
>> Thank you!
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docs-unsubscribe_at_glassfish.dev.java.net
> For additional commands, e-mail: docs-help_at_glassfish.dev.java.net
>
--
Paul Davies, Senior Technical Writer, Sun Microsystems, Inc.
http://blogs.sun.com/techscribe/