OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

soa-eerp message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [soa-eerp] I049: BQoS - Schema in Non-Normative Appendix ofeach Spec for Readability


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-2200961227211318@M2W006.mail2web.com" type="cite">
Most of OASIS specs do not include the schema list.
  
The XML Schema for BQoS will be 6 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



Original Message:
-----------------
From: eerp_sy@changfeng.org.cn eerp_sy@changfeng.org.cn
Date: Sun, 21 Jun 2009 15:44:14 -0400
To: wtcox@coxsoftwarearchitects.com, soa-eerp@lists.oasis-open.org
Subject: [soa-eerp] I049: BQoS -  Schema in Non-Normative Appendix of each
Spec for Readability


Issue # I049

For BQoS Spec only 

Related issues: I050 and I051

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 - Check your email from the web at
http://link.mail2web.com/mail2web



---------------------------------------------------------------------
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.com – Enhanced email for the mobile individual based on Microsoft®
Exchange - http://link.mail2web.com/Personal/EnhancedEmail



---------------------------------------------------------------------
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 


  


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]