oops. I see it’s merged by now. (It’s also perfect, so all the better)

Cheers,

Brian

> On 29 Mar 2023, at 13:21, Michael Welzl <mich...@ifi.uio.no> wrote:
> 
> Hi Brian,
> 
> This PR has been waiting for your reaction for a while:
> https://github.com/ietf-tapswg/api-drafts/pull/1125 
> <https://github.com/ietf-tapswg/api-drafts/pull/1125>
> 
> One out of two remaining PRs … after these, we should probably issue a new 
> version.
> 
> Cheers,
> Michael
> 
> 
>> On Mar 10, 2023, at 5:55 PM, Brian Trammell (IETF) <i...@trammell.ch 
>> <mailto:i...@trammell.ch>> wrote:
>> 
>> Adding a sentence making it clear it’s safe to skip the glossary if you’re 
>> going to read the rest of the document would address my approachability 
>> concern completely. :)
>> 
>> Sent from my iPhone
>> 
>>> On 10 Mar 2023, at 17:34, Gorry Fairhurst <go...@erg.abdn.ac.uk 
>>> <mailto:go...@erg.abdn.ac.uk>> wrote:
>>> 
>>> On 10/03/2023 14:57, Brian Trammell (IETF) wrote:
>>>> hi Reese, all,
>>>> 
>>>> Apologies I haven’t been around on the answering-of-comments; it’s been a 
>>>> rough month. Thanks, all, for getting these revs of the documents out. 
>>>> I’ve reviewed the changes.
>>>> 
>>>> - Arch changes are good, modulo the following non-blocking comment:
>>>> 
>>>> I’m not convinced of the value of the glossary of terms, as it forwardrefs 
>>>> basically the entire document, and some of the definitions are so generic 
>>>> as to be potentially confusing (e.g. Event), so I think putting these up 
>>>> front reduces the document’s approachability and readability.  I 
>>>> understand that some people like these (and other standards orgs make them 
>>>> mandatory, hi ETSI), so I won’t fight it.
>>> 
>>> Mea cupla on this, and I did recall your thoughts when we discussed at one 
>>> of the TAPS interims. At first I didn't feel persauded, but as I tried to 
>>> reset my head to someone who had never read these IDs before, I began to 
>>> think this could be really valuable to give some initial context to the 
>>> many terms we use across the documents. The text is identical or "thinned" 
>>> versions of later text.
>>> 
>>> If this glossary is thought useful - which I now personally think it is, 
>>> but others are free to comment  - I'd be really quite OK with this 
>>> "glossary" starting with a sentence that says each of these terms is 
>>> defined later in the document, in other words - hinting strongly don't 
>>> bother with this if you know what you are reading....
>>> 
>>>> 
>>>> - Interface changes are good.
>>>> 
>>>> - Implementation changes are good.
>>>> 
>>>> Cheers,
>>>> 
>>>> Brian
>>>> 
>>>>>> On 10 Mar 2023, at 01:26, Reese Enghardt <i...@tenghardt.net 
>>>>>> <mailto:i...@tenghardt.net>> wrote:
>>>>> 
>>>>> Dear TAPS,
>>>>> 
>>>>> As you may have seen, our three documents were updated to address Zahed's 
>>>>> AD review comments (Thank you to everyone involved!).
>>>>> 
>>>>> Please note that there were normative language changes in the Interface 
>>>>> document.
>>>>> 
>>>>> If you have any questions about or any objections to these changes, 
>>>>> please respond to the list within the next two weeks, i.e., by Thursday 
>>>>> March 23rd, 5pm PT. (This is Thursday before IETF 116.)
>>>>> 
>>>>> If we don't hear anything by this date, we will assume that there is WG 
>>>>> consensus on these changes.
>>>>> 
>>>>> For your convenience, here are the diffs for all three documents:
>>>>> 
>>>>> 
>>>>> https://author-tools.ietf.org/iddiff?url2=draft-ietf-taps-arch-16 
>>>>> <https://author-tools.ietf.org/iddiff?url2=draft-ietf-taps-arch-16>
>>>>> 
>>>>> https://author-tools.ietf.org/iddiff?url2=draft-ietf-taps-interface-19
>>>>> 
>>>>> https://author-tools.ietf.org/iddiff?url2=draft-ietf-taps-impl-15
>>>>> 
>>>>> 
>>>>> Best,
>>>>> Reese
>>>>> 
>>>>> 
>>>>> On 3/9/23 10:01, internet-dra...@ietf.org wrote:
>>>>>> A New Internet-Draft is available from the on-line Internet-Drafts 
>>>>>> directories.
>>>>>> This Internet-Draft is a work item of the Transport Services WG of the 
>>>>>> IETF.
>>>>>> 
>>>>>>        Title           : An Abstract Application Layer Interface to 
>>>>>> Transport Services
>>>>>>        Authors         : Brian Trammell
>>>>>>                          Michael Welzl
>>>>>>                          Theresa Enghardt
>>>>>>                          Godred Fairhurst
>>>>>>                          Mirja Kuehlewind
>>>>>>                          Colin Perkins
>>>>>>                          Philipp S. Tiesel
>>>>>>                          Tommy Pauly
>>>>>>  Filename        : draft-ietf-taps-interface-19.txt
>>>>>>  Pages           : 91
>>>>>>  Date            : 2023-03-09
>>>>>> 
>>>>>> Abstract:
>>>>>>   This document describes an abstract application programming
>>>>>>   interface, API, to the transport layer that enables the selection of
>>>>>>   transport protocols and network paths dynamically at runtime.  This
>>>>>>   API enables faster deployment of new protocols and protocol features
>>>>>>   without requiring changes to the applications.  The specified API
>>>>>>   follows the Transport Services architecture by providing
>>>>>>   asynchronous, atomic transmission of messages.  It is intended to
>>>>>>   replace the BSD sockets API as the common interface to the transport
>>>>>>   layer, in an environment where endpoints could select from multiple
>>>>>>   interfaces and potential transport protocols.
>>>>>> 
>>>>>> 
>>>>>> The IETF datatracker status page for this Internet-Draft is:
>>>>>> https://datatracker.ietf.org/doc/draft-ietf-taps-interface/
>>>>>> 
>>>>>> There is also an HTML version available at:
>>>>>> https://www.ietf.org/archive/id/draft-ietf-taps-interface-19.html
>>>>>> 
>>>>>> A diff from the previous version is available at:
>>>>>> https://author-tools.ietf.org/iddiff?url2=draft-ietf-taps-interface-19
>>>>>> 
>>>>>> 
>>>>>> Internet-Drafts are also available by rsync at 
>>>>>> rsync.ietf.org::internet-drafts
>>>>>> 
>>>>>> 
>>>>>> _______________________________________________
>>>>>> Taps mailing list
>>>>>> Taps@ietf.org
>>>>>> https://www.ietf.org/mailman/listinfo/taps
>>>>>> 
>>>>> _______________________________________________
>>>>> Taps mailing list
>>>>> Taps@ietf.org
>>>>> https://www.ietf.org/mailman/listinfo/taps
>>>> _______________________________________________
>>>> Taps mailing list
>>>> Taps@ietf.org <mailto:Taps@ietf.org>
>>>> https://www.ietf.org/mailman/listinfo/taps
>>> 
>>> 
>> 
>> _______________________________________________
>> Taps mailing list
>> Taps@ietf.org <mailto:Taps@ietf.org>
>> https://www.ietf.org/mailman/listinfo/taps
> 
> _______________________________________________
> Taps mailing list
> Taps@ietf.org
> https://www.ietf.org/mailman/listinfo/taps

_______________________________________________
Taps mailing list
Taps@ietf.org
https://www.ietf.org/mailman/listinfo/taps

Reply via email to