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

[Randy George <randyg@us.ibm.com>]

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" <Merri.Jensen@sas.com>

10/31/07 06:09 PM

To	Randy George/Austin/IBM@IBMUS, Julia McCarthy/Raleigh/IBM@IBMUS
cc	<sdd@lists.oasis-open.org>
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:randyg@us.ibm.com]
Sent: Wednesday, October 31, 2007 3:23 PM
To: Julia McCarthy
Cc: sdd@lists.oasis-open.org
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	sdd@lists.oasis-open.org
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
julia@us.ibm.com