Comments for <resources> and <connector-service> elements in Administration Reference Guide :

1)
Page 119 :
Description of admin-object-resource :
Defines an administered object for an inbound resource adapter.
can be
Defines an administered object for an resource adapter.

as administered objects can be specified for a non-inbound resource-adapter too.

2)
Page : 77
Section : Attributes :
"                                                                      Changing the
following attributes requires a server restart: datasource-classname,
associate-with-thread, lazy-connection-association, and
lazy-connection-enlistment.
"
Please include  driver-classname attribute.

3) Also, the above statement states only server restart. Whenever a resource's configuration is changed
we expect the referring applications to be redeployed or re-enabled (disable and enable) or server restart
[This is also applicable for section "connector-connection-pool" in page 38]

4) Table 1-79, attribute "validation-classname"'s description :
Also add :
"Some of the in-built validation classes for few databases are :
org.glassfish.jdbc.validation.DerbyConnectionValidation, org.glassfish.jdbc.validation.MySQLConnectionValidation, org.glassfish.jdbc.validation.OracleConnectionValidation, org.glassfish.jdbc.validation.PostgresConnectionValidation.
and
org.glassfish.jdbc.validation.JDBC40ConnectionValidation for any JDBC 4.0 compliant driver."


5) Table 1-79, attribute "fail-all-connections" 
"This parameter is mandatory if and only if is-connection-validation-required is set to true."

Above comment is not needed as default value of "fail-all-connections" is "false".

Probably, it can be written as, "fail-all-connections" when set to true, will take effect only when 'is-connection-validation-required' is set to true.

6) Page 24, attribute "res-adapter"'s description :
"Specifies the name of the inbound resource adapter
res-adapter"
can be
"Specifies the name of the resource adapter
res-adapter

7) Page 24, Section "Properties"
Admin objects can be created for any resource-adapter that defined "administered-objects" in the ra.xml. 
I see jms-ra related documentation in the section. 
Shall we remove them ?




8) Page 45, attribute "classloading-policy"
8-a)
"(Optional) Specifies whether applications must reference resource adapters in their deployment
class-loading- derived descriptors to use them."
can be re-phrased as 
"(Optional) class-loading policy determines the list of resource-adapters accessible to the applications."
8-b)
                       "derived — Applications must reference resource adapters in their deployment descriptors.
                       These references can be resource-ref, resource-env-ref, resource-adapter-mid, or
                       equivalent annotations."
can be re-phrased as 
                       "derived — Applications get access to resource-adapters based on the reference to resource-adapter artifacts in their deployment 			descriptors. These references can be via resource-ref, resource-env-ref, resource-adapter-mid, or
                       equivalent annotations."