datatracker icon indicating copy to clipboard operation
datatracker copied to clipboard

IETF datatracker: new "testing" tag for "additional resources"

Open bclaise opened this issue 1 year ago • 10 comments

Description

Case 1: individual drafts datatracker.ietf.org/doc/draft-ahuang-netconf-notif-yang/ as an example I can EDIT the additional resources If I click EDIT, I see the following tags: faq, github_org, github_repo, github_username, gitlab_repo, gitlab_username, jabber_log, jabber_room, mailing_list, mailing_list_archive, related_implementations, repo, slack, tracker, webpage, wiki, yc_entry, yc_impact, zulip I have not tested with the live datatracker, but it seems that I can select among the different existing tags, and add a pointer.

case 2: a working group document, I am an author, and not the WG chair I can't edit the "additional resources"

case 3: working document, and I am the WG chair I can't test this one.

Conclusion: It seems that we "just" need to add a new tag (such as "testing") and follow the same datatracker id authorization logic (the 3 use cases above)

Code of Conduct

bclaise avatar Mar 15 '24 22:03 bclaise

Will try to address this one during Code Sprint

evyncke avatar Mar 16 '24 00:03 evyncke

@bclaise would "related_test_cases" be OK ?

evyncke avatar Mar 16 '24 00:03 evyncke

What's being pointed to? Documentation of how to test? Code? Results? Something else?

rjsparks avatar Mar 16 '24 01:03 rjsparks

It seems indeed to be just a value in a model/table (to be handled by the secretariat I think) to add 'related_test_cases'.

Based on oral discussion with @bclaise it is more about wiki page or any external repository.

evyncke avatar Mar 16 '24 01:03 evyncke

It seems that adding a single row in name_extresourcename will do the trick indeed ;-)

evyncke avatar Mar 16 '24 02:03 evyncke

it is more about wiki page or any external repository.

Then why not use the existing wiki or repository external names and give them descriptive text like "Related Test Cases"?

What value is having the extra tag bringing?

rjsparks avatar Mar 16 '24 04:03 rjsparks

it is more about wiki page or any external repository.

Then why not use the existing wiki or repository external names and give them descriptive text like "Related Test Cases"?

What value is having the extra tag bringing?

The wiki or repository tags don't bring the necessary semantic that this is "testing" code, with for example PCAP, collector for a testing a telemetry protocol, etc.

bclaise avatar Mar 17 '24 04:03 bclaise

I suggest to add the following tags: related_test_cases, related_test_results This makes it easy for draft authors not only have related_implementations with running code, but also have test cases and results going along the document. This will be useful for the IETF communiy to judge the maturity of the document and for software developers implementing the document and validating their implementation.

graf3net avatar Mar 17 '24 04:03 graf3net

@graf3net 's suggestion makes more sense to me - does that satisfy what @bclaise is looking for?

rjsparks avatar Mar 20 '24 22:03 rjsparks

@graf3net 's suggestion makes more sense to me - does that satisfy what @bclaise is looking for?

Yes, exactly.

bclaise avatar Apr 01 '24 11:04 bclaise