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

 


Help: OASIS Mailing Lists Help | MarkMail Help

ws-calendar message

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


Subject: [OASIS Issue Tracker] Updated: (WSCALENDAR-276) Line 453-465 - itappears that this language would be better served if the heading 3.1.4appeared before the text that starts on line 453.



     [ http://tools.oasis-open.org/issues/browse/WSCALENDAR-276?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Toby Considine updated WSCALENDAR-276:
--------------------------------------

       Proposal: 
Inlines 453-465, which is the transition from the last Temporal Relationship example the the discussion of Sequences, the current language is:

Intervals with Temporal Relationships enable the message to express complex temporal relations to form a Sequence. , as well as express the simple consecutive Intervals named a Partition.

A Sequence describes a coherent set of Intervals that can be assembled from a collection of Intervals. As the rules for parsing XML do not mandate preservation of order within a sub-set, we cannot assume that order is preserved when parsing a set of Components. For Sequences in WS-Calendar, then, mere order is not enough—a Sequence is a collection of Intervals each of which Interval either refers to or is referred by at least one Interval. Using the references, expressed as Temporal Relations, WS-Calendar describes a single coherent Sequence that is assembled from a set of Intervals in a collection.

3.1.4 Sequences: Combining Intervals

A Sequence is a collection of Intervals with a coherent set of Temporal Relationships (Table 1 3). Temporal Relationships are transitive, so that if Interval A is related to Interval B, and Interval B is related to Interval C, then Interval A is related to Interval C. Sequences can also include Gluons (see section 3.3.1, References and Inheritance), but for this section, we will discuss Sequences only as a set of Intervals.

be changed to:

Temporal Relationships express when one Interval begins or ends, and when the next begins or ends. Temporal relationships create orderable sets of Intervals that can be re-assembled after exchange. A coherent ordered sets of Intervals is named a Sequence.

3.1.4 Sequences: Combining Intervals

A Sequence is an ordered set of intervals in which the order is determined by time or by schedule. Processes may have dependencies that require an order in their execution. One Interval ends and another begins. Three Intervals must start at once. Two intervals must end at the same time. This temporal ordering of intervals may be fixed, even as the start or end time of a Sequence changes.

A simple and useful Sequence is the Partition. Intervals in a Partition follow one after the other, and all may share the same Duration. Even for the simple Partition, it is necessary to order the Intervals. 

There is no inherent order in a set of information elements which may be parsed and re-assembled as they are exchanged by partners. In particular, XML parsing rules do not mandate preservation of order within a sub-set; we cannot assume that order is preserved when parsing a set of Intervals. In a Sequence, temporal relationships define how a collection of Intervals is re-assembled into a coherent Schedule. 

Sequences can also include Gluons (see section 3.3.1, References and Inheritance), but for this section, Sequences are discusses only as a collection of Intervals.


  was:I would love to offer a clarifying suggestion but cannot easily discern the critical statements that are needed to introduce the subject of sequences from the language in the document.

    Description: 
it appears that this language would be better served if the heading 3.1.4 appeared before the text that starts on line 453. In addition, the three paragraps, 453-454, 455-460 and 462-465 compose a confusing set of statements about sequences, intervals, temporal relationships, etc.

I would love to offer a clarifying suggestion but cannot easily discern the critical statements that are needed to introduce the subject of sequences from the language in the document.

  was:it appears that this language would be better served if the heading 3.1.4 appeared before the text that starts on line 453. In addition, the three paragraps, 453-454, 455-460 and 462-465 compose a confusing set of statements about sequences, intervals, temporal relationships, etc.


> Line 453-465 - it appears that this language would be better served if the heading 3.1.4 appeared before the text that starts on line 453.
> ------------------------------------------------------------------------------------------------------------------------------------------
>
>                 Key: WSCALENDAR-276
>                 URL: http://tools.oasis-open.org/issues/browse/WSCALENDAR-276
>             Project: OASIS Web Services Calendar (WS-Calendar) TC
>          Issue Type: Sub-task
>          Components: spec
>    Affects Versions: pr02
>         Environment: EnerNex
>            Reporter: Toby Considine
>            Assignee: Toby Considine
>             Fix For: wd20
>
>
> it appears that this language would be better served if the heading 3.1.4 appeared before the text that starts on line 453. In addition, the three paragraps, 453-454, 455-460 and 462-465 compose a confusing set of statements about sequences, intervals, temporal relationships, etc.
> I would love to offer a clarifying suggestion but cannot easily discern the critical statements that are needed to introduce the subject of sequences from the language in the document.

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