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

 


Help: OASIS Mailing Lists Help | MarkMail Help

energyinterop message

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


Subject: [OASIS Issue Tracker] Commented: (ENERGYINTEROP-428) wd31: schemablock header -> spec no longer related



    [ http://tools.oasis-open.org/issues/browse/ENERGYINTEROP-428?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=26284#action_26284 ] 

William Cox commented on ENERGYINTEROP-428:
-------------------------------------------

Not sure if this is necessary, but it may be desirable.

Perhaps add a statement in the section about the schemas indicating that the comments/documentation are numbered but do not relate to the sections of the specification.

I'd defer to Toby - if time, consider for PR02. If not, defer.

> wd31: schema block header -> spec no longer related
> ---------------------------------------------------
>
>                 Key: ENERGYINTEROP-428
>                 URL: http://tools.oasis-open.org/issues/browse/ENERGYINTEROP-428
>             Project: OASIS Energy Interoperation TC
>          Issue Type: Bug
>          Components: schema, spec
>    Affects Versions: wd24
>         Environment: Anne Hendry
>            Reporter: Anne Hendry 
>            Assignee: Toby Considine
>            Priority: Minor
>
> The block header comments in the schema while at one time may have referred to the sections of the spec, no longer relate (have different titles than the spec sections they refer to, are sometimes unpopulated, just block comment heads with no content below).  These should be cleaned up (or removed) before final release as they are confusing as is.
> For instance, in resource.xsd there is a block comment header "<-!  3.6 Voltage Regulation  ->", but there is no section 3.6 in the spec and Voltage Regulation is described in section 13.    In power.xsd there is a block comment header "<!-- 9.9 Enumerations -->"  and "<!--  9.9.1 Voltage   -->" but there is no spec section 9.9.  Other headers suggest content for spec sections that do exist but have different content.  These are just examples.  It seems most of them are no longer related.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://tools.oasis-open.org/issues/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        


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