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

Robert Sparks <rjsparks@nostrum.com> Mon, 07 February 2022 20:58 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 9ED733A0A01 for <edm@ietfa.amsl.com>; Mon, 7 Feb 2022 12:58:53 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.792
X-Spam-Level:
X-Spam-Status: No, score=-2.792 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=0.001, NICE_REPLY_A=-0.714, T_SPF_HELO_PERMERROR=0.01, T_SPF_PERMERROR=0.01, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) 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 pjlMOpqb-Lkb for <edm@ietfa.amsl.com>; Mon, 7 Feb 2022 12:58:49 -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 EEDE03A09DB for <edm@iab.org>; Mon, 7 Feb 2022 12:58:48 -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 217KwgNg049908 (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384 bits=256 verify=NO); Mon, 7 Feb 2022 14:58:42 -0600 (CST) (envelope-from rjsparks@nostrum.com)
DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=nostrum.com; s=default; t=1644267522; bh=zfnotKD5XCWzrPvcf3cHWjKGSWaSRYpXZqZaXczk0To=; h=Date:Subject:To:Cc:References:From:In-Reply-To; b=eALIigcglENsmAqhSD3Y2Ab+lEH3ceV/WcJX69eCOefcwjmm9/TtjL6aP2/AdC5u+ /L1ulkUiWsIQnm4J6YFYu3wNMmfGw+rfxLJsbNpQ2BkrtLWXRzvAOQoGQpZ3nT2azB pmG6xcsnzxbHfPUeXhGubemJlAycBh/8VqeiwmNU=
X-Authentication-Warning: raven.nostrum.com: Host [47.186.48.51] claimed to be [192.168.1.114]
Content-Type: multipart/alternative; boundary="------------v7rJA9mlFgNtGXVUEUStHehv"
Message-ID: <350d7422-1673-09da-99ef-5a066cbe1d30@nostrum.com>
Date: Mon, 07 Feb 2022 14:58:36 -0600
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:91.0) Gecko/20100101 Thunderbird/91.5.1
Content-Language: en-US
To: "Charles Eckel (eckelcu)" <eckelcu@cisco.com>
Cc: Tommy Pauly <tpauly@apple.com>, "edm@iab.org" <edm@iab.org>
References: <20531b68-b422-31ef-eb93-08c0a5275de6@nostrum.com> <e721fda5-224b-74ec-400a-2c114d49631a@nostrum.com> <E20F5EBF-ABE0-4A5C-94CD-0BC041C5909A@cisco.com>
From: Robert Sparks <rjsparks@nostrum.com>
In-Reply-To: <E20F5EBF-ABE0-4A5C-94CD-0BC041C5909A@cisco.com>
Archived-At: <https://mailarchive.ietf.org/arch/msg/edm/5TRP2EwoDjTioNeeIMmJo0GIdK8>
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: Mon, 07 Feb 2022 20:58:54 -0000

On 2/7/22 2:48 PM, Charles Eckel (eckelcu) wrote:
> ‘related_implementations' or ‘related_code', as described below,  work 
> for me, with a slight preference for related_code. 

I'm trying to inform future suppliers of links as to when they should 
choose the new tag vs the existing repo, github_repo, or github_org tag. 
`code` by itself is pretty sweeping.

But it's likely already poorly defined soup, so what's a little more 
confusion?

>
> Cheers,
> Charles
>
>> On Feb 7, 2022, at 9:14 AM, Robert Sparks <rjsparks@nostrum.com> wrote:
>>
>> (retry with a better from address - apologies to the list moderators 
>> for noise)
>>
>> Glad to see people aren't piling onto this particular bikeshed :)
>>
>> The only things that we get by adding a tag are making it more likely 
>> that the descriptions of the links appear the same on group or 
>> document pages, but be aware that these descriptions can be edited 
>> arbitrarily, and to make it so that datatracker code (or code using 
>> the datatracker API) in the future can treat these links as 
>> semantically different from webpage links or github* links.
>>
>> To optimize both of those things, if we create a different tag, let's 
>> try to make the semantics match what we're really trying to say with 
>> it as best we can.
>>
>> Given that we want to capture not just implementations of a spec (or 
>> of a group's set of specs), but also testing tools and analyzers etc, 
>> I propose 'related_implementations' with the display name of "Related 
>> Implementations" (even though that's a bit long).
>>
>> RjS
>>
>> On 2/4/22 11:58 AM, Tommy Pauly 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
>