>>>>> On Wed, 17 Mar 2010 10:42:43 -0500, Timothy Quinn <tim.quinn_at_oracle.com> said:
TQ> Hi, Justin.
TQ> Two mild concerns.
TQ> One is whether the command could be more specific as to just what type
TQ> of documentation it is producing. Create-documentation seems really
TQ> broad to me.
TQ> Another is maybe subtle but worth thinking about, I think. I think
TQ> this would be the first "create" command that does not update the
TQ> config itself as recorded in domain.xml (or, with create-domain,
TQ> actually products a brand new domain.xml). That is, every other
TQ> "create" command creates something that is used during the execution
TQ> of the app server...a domain, a JDCB connection, etc. There is also a
TQ> parallel delete command for each of those.
TQ> In contrast, this command produces something that's certainly useful
TQ> but does not alter the configuration of the domain and for which there
TQ> is no delete counterpart.
TQ> So is this really a "describe-config" or "describe-metadata" or
TQ> "describe-config-metadata" command? Again, I'm not sure any of those
TQ> is the right alternative command name, but I think you see what I'm
TQ> getting at.
I think the name should start with "generate-"
Ed
--
| edward.burns_at_oracle.com | office: 408 884 9519 OR x31640
| homepage: | http://ridingthecrest.com/