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

["eerp_sy@changfeng.org.cn" <eerp_sy@changfeng.org.cn>]

New working Draft WD06 uploaded at
www.oasis-open.org/committees/download.php/33244/BusinessServiceLevelAgreeme
nt-v1.0-spec-wd06.pdf and it added the XML schema on Line # 818-1450.   

This issue can be closed.   


Original Message:
-----------------
From: William Cox wtcox@CoxSoftwareArchitects.com
Date: Wed, 24 Jun 2009 15:37:21 -0400
To: eerp_sy@changfeng.org.cn, wtcox@coxsoftwarearchitects.com,
soa-eerp@lists.oasis-open.org
Subject: Re: [soa-eerp] I051: BSLA -  Schema in Non-Normative Appendix
ofeach Spec for Readability


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
<mailto:wtcox@CoxSoftwareArchitects.com>
Web: http://www.CoxSoftwareArchitects.com
+1 862 485 3696 mobile
+1 908 277 3460 fax


eerp_sy@changfeng.org.cn wrote:
> 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 - Check your email from the web at
http://link.mail2web.com/mail2web