Re: Calendar API description and summary semantics

[ s/Contacts/Calendar/ - both start with the same letter and have 8 letters ;) ]

On 1.7.2011, at 11.17, ext Anssi Kostiainen wrote:

> Hi,
> 
> The description and summary attributes of the Contacts API are defined as "a description of the event" and "a summary of the event" [1]. This is a bit vague and I'd suggest adapting the language from the iCalendar.
> 
> The iCalendar spec defines its description [2] and summary [3] properties as follows:
> 
> [[
> 
> Property Name: DESCRIPTION
> 
> Purpose: This property provides a more complete description of the calendar component than that provided by the "SUMMARY" property.
> 
> [...]
> 
> Property Name:  SUMMARY
> 
> Purpose: This property defines a short summary or subject for the calendar component.
> 
> ]]
> 
> Also the corresponding Contacts API examples seem to suggest the semantics are different from those of the iCalendar. I'd suggest we switch the examples around or e.g. adapt one of the iCalendar examples [4].
> 
> -Anssi
> 
> [1] http://dev.w3.org/2009/dap/calendar/#idl-def-CalendarEvent
> [2] http://tools.ietf.org/html/rfc5545#section-3.8.1.5
> [3] http://tools.ietf.org/html/rfc5545#section-3.8.1.12
> [4] http://tools.ietf.org/html/rfc5545#section-4

Received on Friday, 1 July 2011 08:25:47 UTC