Re: [soa-eerp] I051: BSLA - Schema in Non-Normative Appendix ofeach Spec for Readability

[William Cox <wtcox@CoxSoftwareArchitects.com>]

Szu --

I'm not sure what you mean by "most of OASIS specs do not include the schema list[ing]." This is, in my experience, universally done even though the separate file starting around 6 months ago was changed to the normative version.

So this is incorrect. The Schema should be included in the specification in an appendix. See, for example, SCA-Assembly.

Comment from a related issue:

I just finished a detailed review of the Public Review versions of several SCA specs. They all include the schema (without diagrams) in an appendix.

My suggestion is #2, put the schema in the spec (for ease of review).

Similar note on the other issues (1049-1051).

Thanks!

bill
--
William Cox
Email: wtcox@CoxSoftwareArchitects.com
Web: http://www.CoxSoftwareArchitects.com
+1 862 485 3696 mobile
+1 908 277 3460 fax


eerp_sy@changfeng.org.cn wrote:

380-22009612273343828@M2W018.mail2web.com" type="cite">

Same as Issue I049, most of OASIS specs do not include the schema list.
  
The XML Schema for SLA will be 9 pages long. The illustration (from XMLSpy)
will be too small to read, if put the whole Schema into one page. Will
including schema list into in Non-Normative Appendix of bQoS Spec really
help readability? 

We have two alternatives for this issue: 

1. Not to include schema into the spec (close with no action) 
2. Assign it to editor to include schema into spec


源郵件:
-----------------
發件人: eerp_sy@changfeng.org.cn eerp_sy@changfeng.org.cn
日期: Sun, 21 Jun 2009 15:46:54 -0400
收件者: wtcox@coxsoftwarearchitects.com, soa-eerp@lists.oasis-open.org
主題: [soa-eerp] I051: BSLA -  Schema in Non-Normative Appendix of each
Spec for Readability


Issue # I051

For BSLA Spec only 

Related issues: I049 and I050

Original Message:
-----------------
From: William Cox wtcox@CoxSoftwareArchitects.com
Date: Sat, 20 Jun 2009 22:59:12 -0400
To: soa-eerp@lists.oasis-open.org
Subject: [soa-eerp] NEW Issue: Schema in Non-Normative Appendix of each
Spec for Readability


PLEASE DO NOT REPLY TO THIS EMAIL OR START A DISCUSSION THREAD UNTIL THE 
ISSUE IS ASSIGNED A NUMBER.

The issues coordinators will notify the list when that has occurred.

Protocol: bqos / rating / sla /

Artifact: spec
Type: editorial

Title: Schema in Non-Normative Appendix of each Spec for Readability

Description:
Schema is not in the specifications. The schema should appear in each 
specification in a non-normative appendix, and state that the included 
schema is non-normative.

The illustrations (from XMLSpy) should be considered for inclusion as well.

Related issues:


Proposed Resolution:

Insert as suggested.


bill cox
--
*William Cox*
Email: wtcox@CoxSoftwareArchitects.com 
<mailto:wtcox@CoxSoftwareArchitects.com>
Web: http://www.CoxSoftwareArchitects.com
+1 862 485 3696 mobile
+1 908 277 3460 fax



--------------------------------------------------------------------
mail2web LIVE ?Free email based on Microsoft?Exchange technology -
http://link.mail2web.com/LIVE



---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail.  Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php 



--------------------------------------------------------------------
mail2web – 從 web 檢查您的電子郵件，網址
http://mail2web.com/ .