[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: RE: [wsdm][UPlat] Versioning
Do we need to specify the format of the version? In many cases, versions of web services are expressed by changing the namespace of the description of the web service - this is a URI. Also, we need to clarify what the version applies to. Are we describing the version of the service - for which there may be many endpoints? Are we describing the version of an endpoint - for which there may be many interfaces? Or are we describing the version of an interface? It seems likely that manageability capabilities may be versioned independently, and that an implementer will want to mix and match manageability capabilities with various versions into one manageability endpoint. This implies that it may be important to discover the specific version of each of the management capabilities or at least the management interfaces. So an endpoint will need to provide a set of versions to describe the set of management capabilities it exposes. I agree with your requirement for change descriptions. And this is where information about what the previous version is would be, as well as how this version extends/replaces/fixes/etc. the previous version. -----Original Message----- From: Andreas Dharmawan [mailto:email@example.com] Sent: Wednesday, October 29, 2003 4:08 PM To: firstname.lastname@example.org Subject: [wsdm][UPlat] Versioning Here is my first cut on Versioning: * Versioning: - Definition(s): Versions: A sequence of copies of (Functional and Manageability) Webservices incorporating new modifications. Each version is identified by a number, following a certain specified format signifying the major version number and the release number. Typically an increment in the major version signifies a substantial increase in the function of the Webservice or a partial or total re-implementation. Whereas the release number increases each time the Webservice is changed in any way and re-released. Versioning information must also contain change description that describes what has changed in a revision compared to the previous one. - Management Need(s): 1. Version numbers are useful so that the manager can know if the manageable Webservice interfaces have changed (bugs have been fixed or new functions added) since she obtained her copy. She could also learn whether a bug report relates to the current version. 2. A manager of manageable resources must have the ability to query the available endpoints' revisions along with the corresponding change descriptions such that the manager can discern the most appropriate and compatible interface of a particular manageability function that her management client can use. To unsubscribe from this mailing list (and be removed from the roster of the OASIS TC), go to http://www.oasis-open.org/apps/org/workgroup/wsdm/members/leave_workgroup.ph p.