W3C home > Mailing lists > Public > public-sysapps@w3.org > June 2013

Re: telephony API description paragraph

From: Charles McCathie Nevile <chaals@yandex-team.ru>
Date: Sun, 16 Jun 2013 15:26:46 +1000
To: "Marcos Caceres" <w3c@marcosc.com>
Cc: "Dave Raggett" <dsr@w3.org>, "public-sysapps@w3.org" <public-sysapps@w3.org>
Message-ID: <op.wyrwywjcy3oazb@131-113-150-203.event.mita.keio.ac.jp>
On Sun, 16 Jun 2013 18:27:04 +1000, Marcos Caceres <w3c@marcosc.com> wrote:

> On Sunday, June 16, 2013, Charles McCathie Nevile wrote:
>> On Sun, 16 Jun 2013 04:02:05 +1000, Marcos Caceres <w3c@marcosc.com>
>>> On Thursday, June 13, 2013 at 3:44 PM, Dave Raggett wrote:
>> ...
>>
>>> Please let me know if you would like a change of wording. This  
>>> paragraph has to be updated for each successive published draft to
>>> summarise the changes since the previous version.
>>>>
>>> Ah, good point about keeping track of significant changes (filed a bug
>>> [1]). I think what we actually want is a specific section for that  
>>> instead of doing that in the SoTD
>>
>> Well, a note in the status is generally useful. It turns out some people
>> *do* read that section...
>
> Yes, but just a link to the Changes section will do, right? Like
> "Significant changes to this document since last publication are  
> documented in the Changes section."

Yeah, that's pretty much perfect.

(An example of what not to do would be the longdesc spec, which lists a  
lot of the changes in the status section instead of just pointing to the  
changelog)...

cheers

Chaals

-- 
Charles McCathie Nevile - Consultant (web standards) CTO Office, Yandex
       chaals@yandex-team.ru         Find more at http://yandex.com
Received on Sunday, 16 June 2013 13:27:18 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:36:13 UTC