[MUWS] comments on the document

["Sedukhin, Igor S" <Igor.Sedukhin@ca.com>]

Title: [MUWS] comments on the document

Following is the summary of my comments on the MUWS document (http://www.oasis-open.org/apps/org/workgroup/wsdm/download.php/6008/wd-wsdm-muws-0.5-20040317-with-tracking.doc)

82-97 What is the point of such summary? We've got requirements docs, just refer to them. Otherwise we can include a laugdty list of things like [MUWS can tolerate time zone differences].

The architecture section does not need to be summariezed that way too. That section is sufficiently structured already, IMO.

108 [The reader is familiar with the concept and principles of IT management system]
This is so vague and nonconcrete that I suggest this statement to be removed.

110 We need to include a reference to XML Namespaces spec (http://www.oasis-open.org/archives/wsdm/200403/msg00078.html)

113-114 [All parts of this document are normative with the exception of examples and special sections that are specifically marked as non-normative.]

And so, Introduction section has not been marked non-normative and same goes for 2.1 and so forth. Are they all normative now? What is normative in those sections?

I suggest that instead, the statement is changed to indicate which EXACT sections are normative. And I believe that would be only 4,5,6 and D,E.

150-151 [Since the Web services architecture defines how to specify information, operations, and notifications through WSDL interfaces]

I don't think WSA defines notifications via WSDL interfaces… That is an extension of WSA. I suggest notifications are removed from this statement.

151-152 [locateability through endpoints]
What's that?

154 [to provide the basis for providing]
Editorial.

156 [If a Web service can expose the functionality of an exposed resource through a Web service functional interface, then, a Web service can expose the manageabiity of the exposed resource.]

Editorial fix is needed for "expose*" use in the sentence.

193 [that offers the disk functions]
This has to be removed from the sentense.

196-197 [along with that reading sectors from the disk service]
It should say "using the disk service".

206 [Thus, manageability ]
"Thus" should be removed.

228-229 should say
[a "Metrics" WSDL interface description defined in a “http://www.docs.oasis-open.org/wsdm/2004/04/muws/wsdl” namespace]

239 The picture should be cropped to remove the bottom example part. It is not relevant anymore.

Section 2.4 onwards (througout the rest of the document): captialization of concept names must be fixed. It should all be lower case: "manageability provider" instead of "Manageability Provider", for example.

391 [in order to participate in MUWS]
Should say "in order to support MUWS specification".

391-392 I'm not sure it is necessary to list all capabilities defined in the section. Someone will have to always remember to update this list.

394-395 and throuout the rest of the document has to accommodate namespace separation (http://www.oasis-open.org/archives/wsdm/200403/msg00090.html)

397-398 has to incorporate UML example (http://www.oasis-open.org/archives/wsdm/200403/msg00081.html)

410 Property name capitalization in the UML diagram must match the capitalization in the property XML document and the schema.

421 [a resource properties document ]
Should say "a resource properties instance document"

428 onwards: fix [resourceId] to be ResourceId and bold.

485 [through Web services]
Should go.

492 Match the capitalization in the UML model.

530 [resource properties document ]
Instance document

550-553 and 561-564 [execute the Start transition according to the UML diagram]
Rephrase with states instead of transitions.

570 [of a typical object property ]
Just the "property".

573 [in context]
In WSDM context.

573-576 [The Metrics capability requires that a currentTime metric be present, providing a reference point for the time-based attributes defined for the metric data types (§4.3.2). (Note that currentTime is a read-only metric and, consequently, the resetAll() operation has no effect on it.)]

This belongs to the defintion of the CurrentTime later in the text. This sentense is quite out of place there.
Also it is CurentTime not currentTime to be precise.

578 fix capitalization in the diagram

604 and throuout the document [“MetricAttributes”]
I suggest that references to properties, operations or capability names are without quotes and in bold. That makes technical information visible and easily readable. Also this is the prevailing case in this and MOWS document right now, so it is easier to fix it in just a few places now.

645 Rename StartupInterval to SinceReset

-- Igor Sedukhin .. (igor.sedukhin@ca.com)
-- (631) 342-4325 .. 1 CA Plaza, Islandia, NY 11788