Hi there,
Part 2 of the review. Big document ;)
Page 61
1. TBW - I guess content is missing here?
2. Data Source - Isn't the data source lookup also aliased to the
global JNDI name?
Page 66
1. Nothing is explicitly mentioned about needing a local extracted
installation
of Glassfish if you want to run appclient script. It is assumed
here by
mentioning as-install/bin directory. Maybe a bit of clarification
is needed
on that. Only the webstart scenario does not require prior
configuration of
the client machine.
Page 67
1. See previous comment.
Page 68
1. Please explain the remark since if it is different between
cluster and
non-cluster operation that should be made apparent.
Page 71
1. TBD - I assume this needs to be filled in.
Page 72
1. "or" after list-applications(1) needs to be removed.
2. TBD - I assume this needs to be filled in.
3. tbw - I assume these need to be filled in as well.
Page 73
1. Is it still true that every descriptor file has a DTD, or are
there descriptor
files that use a schema?
Page 82
1. What equivalency mapping are we talking about here? Is there a
table/list
for these?
Page 95
1. Missing space in isUSERNAME_PASSWORD.
Page 105, 106, 107
1. Maybe it is wise to move the not implemented elements into the
end so it becomes
very apparent they are no longer / not supported / not
implemented?
Page 108
1. Is the delegate value really ignored? This will cause a lot of
problems with
customers that rely on this behavior. If this is the case it
should be mentioned
very prominently in the release notes with this release!
Page 116
1. What are the commit options? And why is A not supported?
Page 121
1. What are the properties for version 7? And how can those be
rewritten for this
version, so they can migrate away from using them?
Regards,
Manfred
-----Original Message-----
From: Judy.J.Tang_at_Sun.COM [mailto:Judy.J.Tang_at_Sun.COM]
Sent: Friday, October 09, 2009 6:09 PM
To: quality_at_glassfish.dev.java.net
Subject: Re: Review Application Deployment Guide (part 1 of 3)
Would also like to add my thanks to Manfred. Looking forward to read
your part 2 and 3,
very valuable input !
Thanks,
Judy
Gail Risdal wrote:
> Thanks, Manfred! Appreciate your thorough review and attention to docs.
>
> Gail
>
> Manfred Riem wrote:
>
>> Application Deployment Guide
>>
>>
>>
>> Page 30
>>
>> 1. Why not also include Java EE 6 Tutorial II here also (like
>> in the Quick Start Guide).
>>
>>
>>
>> Page 36
>>
>> 1. 1 JSR 88 Deployment is a deployment mechanism implemented
>> based on the JSR 88 standard
>> from jcp.org. It delivers vendor neutral deployment options.
>>
>> 2. Degradation will most definitely be there.
>>
>>
>>
>> Page 37
>>
>> 1. How is the rolling upgrade done? Is that explained later in
>> the document?
>>
>> 2. Does each deployment descriptor have a DTD or are there now
>> descriptors that use a schema?
>> "Each deployment descriptor XML file has a corresponding Document
>> Type Definition (DTD) file"
>>
>>
>>
>> Page 44
>>
>> 1. "In this case, the administrator edits and reassembles the
>> archive." Isn't it better to use a
>> deployment plan instead of editing the WAR/EAR/RAR?
>>
>>
>>
>> Page 45
>>
>> 1. "Sun Glassfish Enterprise Server v3 Preview Reference
>> Manual" I assume the "Preview" part
>> needs to be dropped here?
>>
>>
>>
>> Page 55
>>
>> 1. Is "JRuby" a valid type for the server?
>>
>>
>>
>> Page 58
>>
>> 1. "Note - This task is best suited for use in a development
>> environment." I don't think that is the
>> case here. A deployment plan looks to me like a good candidate for
>> production deployments.
>>
>>
>>
>> Page 60
>>
>> 1. TBW - I guess content is missing here?
>>
>>
>>
>>
>>
>> These are today's pages.
>>
>>
>>
>> Manfred
>>
>>
>>
>> *From:* Judy.J.Tang_at_Sun.COM [mailto:Judy.J.Tang_at_Sun.COM]
>> *Sent:* Thursday, October 01, 2009 5:20 PM
>> *To:* quality_at_glassfish.dev.java.net
>> *Subject:* More GlassFish v3 documents for review
>>
>>
>>
>> Hi All,
>>
>> The following GlassFish v3 documents have priority for review. Please
>> review these first. Looking
>> forward to get your review feedback !
>>
>> * Administration Guide click
>>
>> <http://wiki.glassfish.java.net/attach/AdministrationGuide/SJSASEEAG.pdf>
>>
>> * Quick Start Guide (unbundled version; /if possible, reviews needed
>> by October 6, 2009/) click
>>
>> <http://wiki.glassfish.java.net/attach/QuickStartGuide/SJSASEEQSG.pdf>
>> * Application Development Guide (formerly Developer's Guide) click
>>
>> <http://wiki.glassfish.java.net/attach/DeveloperSGuide/SJSASEEDG.pdf>
>> * Application Deployment Guide click
>>
>>
<
http://wiki.glassfish.java.net/attach/ApplicationDeplyomentGuide/SJSASEEADG
.pdf>
>>
>>
>>
>> [1] Doc review rule:
>> http://wiki.glassfish.java.net/Wiki.jsp?page=Docreviewrule
>>
>> Happy Reviewing :-)
>> Judy
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: quality-unsubscribe_at_glassfish.dev.java.net
> For additional commands, e-mail: quality-help_at_glassfish.dev.java.net
>
---------------------------------------------------------------------
To unsubscribe, e-mail: quality-unsubscribe_at_glassfish.dev.java.net
For additional commands, e-mail: quality-help_at_glassfish.dev.java.net