Re: telephony API description paragraph

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