Re: [Edm] Implementation status tag name: please bikeshed!

Robert Sparks <rjsparks@nostrum.com> Wed, 09 March 2022 18:00 UTC

Return-Path: <rjsparks@nostrum.com>
X-Original-To: edm@ietfa.amsl.com
Delivered-To: edm@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 96E9F3A0E83; Wed, 9 Mar 2022 10:00:01 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.689
X-Spam-Level:
X-Spam-Status: No, score=-1.689 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_INVALID=0.1, DKIM_SIGNED=0.1, HTML_MESSAGE=0.001, NICE_REPLY_A=-0.001, RCVD_IN_DNSWL_BLOCKED=0.001, T_SCC_BODY_TEXT_LINE=-0.01, T_SPF_HELO_PERMERROR=0.01, T_SPF_PERMERROR=0.01] autolearn=no autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=fail (1024-bit key) reason="fail (message has been altered)" header.d=nostrum.com
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id lzMCEZ3PdD77; Wed, 9 Mar 2022 09:59:57 -0800 (PST)
Received: from nostrum.com (raven-v6.nostrum.com [IPv6:2001:470:d:1130::1]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id D8C5D3A0F5E; Wed, 9 Mar 2022 09:59:56 -0800 (PST)
Received: from [192.168.1.114] ([47.186.48.51]) (authenticated bits=0) by nostrum.com (8.17.1/8.16.1) with ESMTPSA id 229HxnTI032177 (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384 bits=256 verify=NO); Wed, 9 Mar 2022 11:59:49 -0600 (CST) (envelope-from rjsparks@nostrum.com)
DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=nostrum.com; s=default; t=1646848790; bh=xd1dgYOQqDtZSw/nV75no/bxKFxim6MwGISPhv4Emks=; h=Date:Subject:To:Cc:References:From:In-Reply-To; b=mRFyO4b91sN2lK6zJQmI5fDTLJ07xkQq3tXfnCyqDHVruUCJlni4749ZhkcBbaI0J /IghUR/blWyyUTMMRKI8ORz7vaJiwMX8TZiyXZVbTIQPQSFTT5Q8eKU1IFyW5SC6P0 MhFOzLnsaF7CuIDA+6LBsqt2ddBZLLjziyMR+Y34=
X-Authentication-Warning: raven.nostrum.com: Host [47.186.48.51] claimed to be [192.168.1.114]
Content-Type: multipart/alternative; boundary="------------RriIsQVsvLnKY6EbcOa0FQqL"
Message-ID: <1ea660e6-fc2f-2931-623f-ec2bef8eb219@nostrum.com>
Date: Wed, 09 Mar 2022 11:59:43 -0600
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:91.0) Gecko/20100101 Thunderbird/91.6.2
Content-Language: en-US
To: "Charles Eckel (eckelcu)" <eckelcu@cisco.com>, Tommy Pauly <tpauly@apple.com>
Cc: Tommy Pauly <tpauly=40apple.com@dmarc.ietf.org>, "edm@iab.org" <edm@iab.org>
References: <A59FD713-6D6B-4F90-A66A-1BF67215592F@apple.com> <5D859367-0339-4404-87E2-AF02FDE45487@apple.com> <6E9C77EC-1C82-4778-8B92-C2A78AF36D1A@cisco.com> <D7C96004-4ABA-4CE5-87CF-4B64894947FB@apple.com> <b6c5a0c2-fb92-6285-ef11-c96edd46665c@nostrum.com> <1AA4008A-F454-4C9C-AB5F-944AB15E93EB@apple.com> <58146B84-5005-4F2D-BE95-CF7E03318B02@cisco.com> <c972928c-c5f4-b74b-421d-71a1402a3ab8@nostrum.com> <409162C5-4149-48C5-A601-2CD59596A510@apple.com> <2377D69E-71BC-49B2-8581-517C2D0528ED@cisco.com>
From: Robert Sparks <rjsparks@nostrum.com>
In-Reply-To: <2377D69E-71BC-49B2-8581-517C2D0528ED@cisco.com>
Archived-At: <https://mailarchive.ietf.org/arch/msg/edm/uABydQOKQp3LV8UCDjw-gltJgHg>
Subject: Re: [Edm] Implementation status tag name: please bikeshed!
X-BeenThere: edm@iab.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "Evolvability, Deployability, & Maintainability \(Proposed\) Program" <edm.iab.org>
List-Unsubscribe: <https://www.iab.org/mailman/options/edm>, <mailto:edm-request@iab.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/edm/>
List-Post: <mailto:edm@iab.org>
List-Help: <mailto:edm-request@iab.org?subject=help>
List-Subscribe: <https://www.iab.org/mailman/listinfo/edm>, <mailto:edm-request@iab.org?subject=subscribe>
X-List-Received-Date: Wed, 09 Mar 2022 18:00:03 -0000

On 3/9/22 11:36 AM, Charles Eckel (eckelcu) wrote:
> I tried this out with my draft, 
> https://datatracker.ietf.org/doc/draft-eckel-edm-find-code/. It worked 
> well. I also sent a note to the hackathon list encouraging its use.
>
> Is there a way to use this for existing RFCs?
Yes, chairs can edit the resources for RFCs that are attached to their 
groups. Otherwise you would have to ask the secretariat to add the links 
(via a request to support@ietf.org).
>
> Thanks,
> Charles
>
>> On Mar 8, 2022, at 12:50 PM, Tommy Pauly <tpauly@apple.com> wrote:
>>
>> I’ve added an example for Binary HTTP Messages, with two 
>> implementations, here:
>>
>> https://datatracker.ietf.org/doc/draft-ietf-httpbis-binary-message/
>>
>> The tags for that were:
>>
>> related_implementations https://github.com/chris-wood/ohttp-go (Go 
>> Implementation)
>> related_implementations https://github.com/martinthomson/ohttp (Rust 
>> Implementation)
>>
>> I’ll send info about how to use the tag to the WG chairs list.
>>
>> Thanks,
>> Tommy
>>
>>> On Mar 3, 2022, at 3:35 PM, Robert Sparks <rjsparks@nostrum.com> wrote:
>>>
>>>
>>> On 3/3/22 4:31 PM, Charles Eckel (eckelcu) wrote:
>>>>
>>>>> On Mar 2, 2022, at 2:42 PM, Tommy Pauly 
>>>>> <tpauly=40apple.com@dmarc.ietf.org> wrote:
>>>>>
>>>>> Perfect! I do see it now. I didn’t realize that trac wouldn’t 
>>>>> reflect that.
>>>>>
>>>>> Charles, we should be good to go then for the hackathon.
>>>>
>>>> Great. Is there documentation on the new tag or how to use it?
>>>> I have added tags to drafts while submitting them, but I am not 
>>>> aware of how to add/edit tags for drafts that have already been 
>>>> submitted.
>>>
>>> For individual drafts, the authors can edit the set of additional 
>>> resources - look for the [Edit] button at "Additional Resources" at 
>>> draft-eckel-edm-find-code, for example.
>>>
>>> For wg drafts, the wg chairs (or delegates) are who can edit the 
>>> additional resources (such as at draft-ietf-schmoo-hackathon).
>>>
>>> The editing itself is downright clunky at the moment - you get a 
>>> text field to edit that gets parsed.
>>>
>>> For draft-eckel-edm-find-code, right now, the set of resources looks 
>>> like:
>>>
>>> github_repo https://github.com/eckelcu/draft-eckel-edm-find-code
>>>
>>> You could add an additional implementation by adding a line that 
>>> looked like:
>>>
>>> related_implementations https://super.implementation.neverusethis.com
>>>
>>> The edit for itself has a small bit of help text.
>>>
>>> RjS
>>>
>>>>
>>>> Thanks,
>>>> Charles
>>>>
>>>>>
>>>>> Best,
>>>>> Tommy
>>>>>
>>>>>> On Mar 2, 2022, at 2:04 PM, Robert Sparks <rjsparks@nostrum.com> 
>>>>>> wrote:
>>>>>>
>>>>>> It should be available already. The ticket hasn't changed as we 
>>>>>> have a soft-freeze on trac (we're letting people enter new 
>>>>>> tickets, but making as few other changes as possible) as we wrap 
>>>>>> up the migration to github.
>>>>>>
>>>>>> RjS
>>>>>>
>>>>>> On 3/2/22 3:30 PM, Tommy Pauly wrote:
>>>>>>>
>>>>>>>
>>>>>>>> On Mar 2, 2022, at 1:23 PM, Charles Eckel (eckelcu) 
>>>>>>>> <eckelcu=40cisco.com@dmarc.ietf.org> wrote:
>>>>>>>>
>>>>>>>>
>>>>>>>>> On Feb 18, 2022, at 12:41 PM, Tommy Pauly 
>>>>>>>>> <tpauly=40apple.com@dmarc.ietf.org> wrote:
>>>>>>>>>
>>>>>>>>> Thanks to everyone who provided feedback via email and GitHub.
>>>>>>>>>
>>>>>>>>> David and I discussed, and I think we’d like to go with:
>>>>>>>>> - Tag name: “related_implementations”
>>>>>>>>> - Display name: "Related Implementations”
>>>>>>>>
>>>>>>>> Works for me.
>>>>>>>>
>>>>>>>>>
>>>>>>>>> Robert, could you get that added?
>>>>>>>>
>>>>>>>> Is there a need for an enhancement request to be entered for 
>>>>>>>> this, and if so, what is the mechanism for does so?
>>>>>>>
>>>>>>> Robert filed this: https://trac.ietf.org/trac/ietfdb/ticket/3560
>>>>>>>
>>>>>>>> I am curious as to the time frame this functionality might be 
>>>>>>>> added and if there will be an opportunity to try it out during 
>>>>>>>> the IETF 113 Hackathon.
>>>>>>>
>>>>>>> Agreed, if we can get this ahead of IETF 113, we could advertise 
>>>>>>> it in the hackathon and let WG chairs know as well. Robert, what 
>>>>>>> do you expect for timeline?
>>>>>>>
>>>>>>> Tommy
>>>>>>>>
>>>>>>>> Cheers,
>>>>>>>> Charles
>>>>>>>>
>>>>>>>>>
>>>>>>>>> Best,
>>>>>>>>> Tommy
>>>>>>>>>
>>>>>>>>>> On Feb 4, 2022, at 9:58 AM, Tommy Pauly 
>>>>>>>>>> <tpauly=40apple.com@dmarc.ietf.org> wrote:
>>>>>>>>>>
>>>>>>>>>> At out last call, we discussed adding a single tag that WG 
>>>>>>>>>> chairs and document authors could use to point to a resource 
>>>>>>>>>> for implementation status/info/guidance/code or interop testing.
>>>>>>>>>>
>>>>>>>>>> The question is what the tag name should be! This is a 
>>>>>>>>>> bikeshed, but we should decide on something before IETF 113 
>>>>>>>>>> so we can add it for people working on the hackathon and in 
>>>>>>>>>> working groups.
>>>>>>>>>>
>>>>>>>>>> For reference, the existing tags are: faq, github_org, 
>>>>>>>>>> github_repo, github_username, gitlab_username, jabber_log, 
>>>>>>>>>> jabber_room, mailing_list, mailing_list_archive, repo, slack, 
>>>>>>>>>> tracker, webpage, wiki, yc_entry, yc_impact
>>>>>>>>>>
>>>>>>>>>> Some options to start us off:
>>>>>>>>>> • implementations (display as “Implementations”)
>>>>>>>>>> • impl_status (display as “Implementation Status”)
>>>>>>>>>> • related_code (display as “Related Code”)
>>>>>>>>>>
>>>>>>>>>> Please reply with other options, or which option you prefer.
>>>>>>>>>>
>>>>>>>>>> You can also chime in on the GitHub issue: 
>>>>>>>>>> https://github.com/intarchboard/program-edm/issues/15
>>>>>>>>>>
>>>>>>>>>> Best,
>>>>>>>>>> Tommy
>>>>>>>>>> -- 
>>>>>>>>>> Edm mailing list
>>>>>>>>>> Edm@iab.org
>>>>>>>>>> https://www.iab.org/mailman/listinfo/edm
>>>>>>>>>
>>>>>>>>> -- 
>>>>>>>>> Edm mailing list
>>>>>>>>> Edm@iab.org
>>>>>>>>> https://www.iab.org/mailman/listinfo/edm
>>>>>>>>
>>>>>>>
>>>>>
>>>>
>>> -- 
>>> Edm mailing list
>>> Edm@iab.org
>>> https://www.iab.org/mailman/listinfo/edm
>>
>