RE: [sdd] F2F Action item: New wording for Completion usage note

Merri,

  I like this.  I would change
to MUST.  FYI...this is more than "requires".  It could
be "provides".  Thus, we need to state that if the artifact
"executes" a system operation or "requires" a "system
operation" to complete the deployment of the contents in the artifact.

Regards,

Randy George

Senior Technical Staff Member

Tivoli Software, IBM Software Group

Austin, TX  

(512) 838-0752     T/L 678-0752

"Merri Jensen"
<> 

10/31/07 06:09 PM

To

Randy George/Austin/IBM@IBMUS, Julia
McCarthy/Raleigh/IBM@IBMUS

cc

<>

Subject

RE: [sdd] F2F Action item: New wording
for Completion usage note

How about something like:

 

A Completion element SHOULD (MUST?)
be included if the artifact being processed requires a system operation
such as a reboot or logoff to occur in order to function successfully.

 

-Merri

 

From: Randy George [mailto:]

Sent: Wednesday, October 31, 2007 3:23 PM

To: Julia McCarthy

Cc: 

Subject: Re: [sdd] F2F Action item: New wording for Completion usage
note

 

This sounds like good content to be in the intro section for completions...but
not a usage note.   

Also, I like declaration more than definition..for you are declaring that
this is needed or will happen.

Regards,

Randy George

Senior Technical Staff Member

Tivoli Software, IBM Software Group

Austin, TX  

(512) 838-0752     T/L 678-0752

Julia McCarthy/Raleigh/IBM@IBMUS

10/31/07 01:51 PM

To



cc

Subject

[sdd] F2F Action item: New wording for Completion
usage note

 

We said at the F2F that we wanted to remove the usage note from Completion
and replace it with something better. I got the todo. Specifically, we
are talking about new wording for Completion element usage notes in InstallableUnitType,
ConfigurationUnitType and LocalizationUnitType. 

Old: : If completion actions are associated
with one or more of the deployment operations supported by the defined
artifacts, they MUST be described in Completion elements.

Proposed New: A Completion definition can serve as a warning to consumers
that an artifact will perform a reboot or logoff. Alternatively, it can
alert consumers that the results of artifact processing will not be functional
until a reboot or logoff has been performed.

TC members, if you have comments and make them via email, it will save
us time during meetings.

Merri, you can include the new wording in the draft and cross the following
items off the outstanding todos list: 

4.3.1.2 InstallableUnitType.Completion - Julia to provide new content

4.3.2.2 ConfigurationUnitType.Completion - Julia to provide new content

(4.9.2.2 LocalizationUnitType.Completion - this was not on the list, but
it also needs to be changed.) 

Julia McCarthy