Skip to content

Commit 2171c6a

Browse files
committed
More changes after AD evaluation.
1 parent 610009e commit 2171c6a

File tree

6 files changed

+31
-13
lines changed

6 files changed

+31
-13
lines changed

generated/draft-ietf-calext-ical-tasks.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -257,7 +257,7 @@ Internet-Draft Task Extensions to iCalendar March 2025
257257
Observer A calendar user interested in a calendar component, e.g., a
258258
manager may have interest in all tasks that have not been
259259
completed. Often represented as an "Attendee" with the "role"
260-
paramdeter set to the value "NON-PARTICIPANT".
260+
parameter set to the value "NON-PARTICIPANT".
261261

262262
Resource A resource in the scheduling context is any shared entity
263263
that can be scheduled by a calendar user, but does not control its

sources/sections-ietf/98-references.adoc

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,14 @@ span:title[_CalConnect, Task Architecture V1.0_],
3131
span:uri.src[https://www.calconnect.org/architectures/Task%20Architecture%201.0.pdf].
3232
span:type[book]
3333

34+
* [[[WsCalendar,nofetch(WsCalendar)]]],
35+
span:surname[Considine], span:initials[T.],
36+
span:surname[Douglass], span:initials[M.],
37+
span:title[_WS-Calendar Version 1.0_],
38+
span:date[2011],
39+
span:uri.src[https://docs.oasis-open.org/ws-calendar/ws-calendar-spec/v1.0/cs01/ws-calendar-spec-v1.0-cs01.pdf].
40+
span:type[book]
41+
3442
* [[[WfRP,nofetch(WfRP)]]],
3543
span:surname[Russell], span:initials[N.],
3644
span:surname[ter Hofstede], span:initials[A.H.M.],

sources/sections/00-intro.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
== Introduction
33

44
This document specifies extensions to the existing Internet Calendaring and Scheduling Core Object Specification (iCalendar) <<RFC5545>>, and associated protocols, in order to enhance the structured communication and execution of tasks. The enhancements allow for the communication, time planning and scheduling of tasks by and between automated systems (e.g. taxi dispatch systems,
5-
in smart power grids, business process management systems) as well as for human centered tasks.
5+
in smart power grids (see <<WsCalendar>>), business process management systems) as well as for human centered tasks.
66

77
A "task" is a representation of an item of work assigned to an individual or organization. In the iCalendar Object Model <<RFC5545>> the representation of tasks is by "VTODO" calendar components. Tasks can be identified in a number of situations, either informally as ad-hoc tasks in personal "to-do" lists or more formally in:
88
Business processes - ranging from repetitive workflows to adaptive cases and trouble ticketing

sources/sections/03-terms.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ or published free/busy information. It is an "Organizer" who invites "Attendees"
2626
Observer::
2727
A calendar user interested in a calendar component, e.g., a manager may
2828
have interest in all tasks that have not been completed. Often represented as
29-
an "Attendee" with the "role" paramdeter set to the value "NON-PARTICIPANT".
29+
an "Attendee" with the "role" parameter set to NON-PARTICIPANT.
3030

3131
Resource::
3232
A resource in the scheduling context is any shared entity that can

sources/sections/08-task-specification.adoc

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,8 @@ The external information may be data to be manipulated in performing the task.
4040

4141
The "LINK" property can be used to relate a domain specific service to the task. For example, it might be a URI pointing to a web page where the status of the task can be directly manipulated.
4242

43+
(Note: link relations below are for illustration only)
44+
4345
[source]
4446
----
4547
LINK;LINKREL="vacation-system";VALUE=URI:
@@ -49,7 +51,11 @@ LINK;LINKREL="vacation-system";VALUE=URI:
4951
Additionally, it might be used to link data specific to the task, for example an electronic copy
5052
of a signature taken to confirm delivery of a package.
5153

52-
(Note: link relations below are for illustration only)
54+
[source]
55+
----
56+
LINK;LINKREL="electronic-signature";VALUE=URI:
57+
http://example.com/delivery/sig1234.jpg
58+
----
5359

5460
The <<RFC9253>> "REFID" property is used to identify a key
5561
used to group tasks by that key.
@@ -66,9 +72,3 @@ between tasks as found in project management to be specified as well as parent/c
6672
relationships and dependencies (DEPENDS-ON). Tasks ("VTODO" calendar components) may also be related to other
6773
calendar components; for example to a "VEVENT" calendar component to block time to perform a task.
6874

69-
70-
[source]
71-
----
72-
LINK;LINKREL="electronic-signature";VALUE=URI:
73-
http://example.com/delivery/sig1234.jpg
74-
----

sources/sections/11-status-reporting.adoc

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ END:VSTATUS
2525
=== Comments associated to reasons and status changes
2626

2727
Multiple comments and reasons may have the same status. As situations
28-
change further "VSTATUS" calendar components can be added to provide additional
28+
change, further "VSTATUS" calendar components can be added to provide additional
2929
information.
3030

3131
[source]
@@ -54,13 +54,23 @@ END:VSTATUS
5454
Note that the "VSTATUS" calendar component is not intended to be used as a history
5555
of changes to a tasks properties. The purpose of the "VSTATUS"
5656
calendar component is only to document changes related to fulfilling
57-
the tasks
57+
the tasks.
58+
59+
=== Updating the overall status
60+
Only the Task Organizer, or the server acting as the Organizers proxy,
61+
may change or add "VSTATUS" calendar components and the "STATUS" property.
62+
63+
The overall VSTATUS will be changed in response to incoming Attendee replies. Each change of the overall VSTATUS MUST be accompanied by a change to the STATUS.
64+
65+
Note there is no defined ordering of properties and components so the
66+
DTSTAMP property SHOULD be set for each VSTATUS component to preserve ordering.
5867

5968
[[attendee-participant]]
6069
=== Relating reason and comments to "ATTENDEE" property status changes.
6170

6271
The <<RFC9073>> "PARTICIPANT" calendar component can be used to provide additional
63-
information about why an "ATTENDEE" property participation status has changed.
72+
information about why an "ATTENDEE" property participation status has changed
73+
following the guidelines set out in <<RFC9073, section=7.1>>.
6474
The "COMMENT" property can also
6575
be used to include additional human-readable information about why the
6676
associated "STATUS" or "ATTENDEE" property changed. For example, if a driver

0 commit comments

Comments
 (0)