Re: [Tools-discuss] Updated survey (was: Proposed survey on I-D authoring tools)

Jay Daley <jay@ietf.org> Mon, 05 October 2020 19:44 UTC

Return-Path: <jay@ietf.org>
X-Original-To: tools-discuss@ietfa.amsl.com
Delivered-To: tools-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 010C63A0F4F for <tools-discuss@ietfa.amsl.com>; Mon, 5 Oct 2020 12:44:57 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.899
X-Spam-Level:
X-Spam-Status: No, score=-1.899 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
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 w2fzMkzSBg44; Mon, 5 Oct 2020 12:44:55 -0700 (PDT)
Received: from jays-mbp.localdomain (unknown [158.140.230.105]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPSA id DA9683A0F4D; Mon, 5 Oct 2020 12:44:54 -0700 (PDT)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.120.23.2.1\))
From: Jay Daley <jay@ietf.org>
In-Reply-To: <f0fa094f-9ea8-1ee8-25a6-90dc2ac5c071@gmx.de>
Date: Tue, 06 Oct 2020 08:44:52 +1300
Cc: tools-discuss@ietf.org
Content-Transfer-Encoding: quoted-printable
Message-Id: <6E314C42-307A-41D9-94B0-FD1A14827F96@ietf.org>
References: <71CCD4C4-2CBA-4AD3-A254-2F19B261D882@ietf.org> <m2lfgqq2ww.wl-randy@psg.com> <1071F4D3-3F36-4012-9CBB-19DDDE6D0564@ietf.org> <m2h7req25a.wl-randy@psg.com> <9F1ABBE7-DC90-4C3C-8493-E89243C73C4C@ietf.org> <m24knepwg4.wl-randy@psg.com> <A62BA403-01EC-4142-A91C-6E675C1E1942@ietf.org> <19017.1601561002@localhost> <4B2B4A68-AC82-4455-A9D1-30F3789038F9@ietf.org> <68CF84A2-7B5F-42A4-B4B7-B68C875591FA@tzi.org> <6F989ED3-4CD5-4E46-A410-965DA76E3F58@ietf.org> <E909F63E-F780-4171-B88D-D094EAC233CF@ietf.org> <f0fa094f-9ea8-1ee8-25a6-90dc2ac5c071@gmx.de>
To: Julian Reschke <julian.reschke@gmx.de>
X-Mailer: Apple Mail (2.3608.120.23.2.1)
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/MH8a4Vw6ctgemT_h14taSego7_Y>
Subject: Re: [Tools-discuss] Updated survey (was: Proposed survey on I-D authoring tools)
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-discuss/>
List-Post: <mailto:tools-discuss@ietf.org>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 05 Oct 2020 19:44:57 -0000


> On 6/10/2020, at 12:23 AM, Julian Reschke <julian.reschke@gmx.de> wrote:
> 
> Am 01.10.2020 um 19:09 schrieb Jay Daley:
>> The updated survey is below.  Please note that
>> 
>> - this doesn’t show the links
>> - I am still not sure how to point people to their Datatracker stats page
>> - the flow logic may change when the survey is tested.
>> 
>> Further feedback is most welcome.
>> 
>> Jay
>> ...
> 
> Sorry for late feedback :-)
> 
> This is good, thanks!
> 
> The one missing thing I currently can think of is an option to provide
> information about other tools in use to either *generate* source, or to
> validate it.
> 
> For instance:
> 
> - automatic *extraction* of sourcecode (such as ABNF) with the goal of
> validation (and maybe re-inserting into an appendix)
> - automatic *insertion* of source code
> - automatic generation of document parts (such as reference tables)
> - preprocessors that extend the XML vocabulary and generate "plain" xml2rfc
> - use of SVG tools (or reasons why they are not used)
> - tools that read a textual description and generate artwork from it
> (like sequence diagrams)
> - tools that check references (such as to RFCs and IDs, and to catch
> dangling "deep" links, such as when a section number in the referenced
> document changed)

The survey currently asks:

[QUESTION - Matrix/Rating Scale]
How often do you use the following checking tools? (Ignore any you don’t know about)
Items
	• Bill’s ABNF parser to check ABNF
	• idnits to check a draft before submission 
	• idspell to check a draft for spelling errors
	• pyang to check YANG modules
	• RFC dependency checker
	• rfcdiff to find diffs between versions of drafts
	• Using the relaxNG schema for the RFC XML
	• SMICng to check MIBs
	• smilint to check MIBs
	• svgcheck to check a draft for SVG schema compliance 
	• xml2rfc validator to validate RFC XML
	• YANG validator to check YANG modules
	• Other [PLEASE SPECIFY]
Scale
	• Always
	• Very often
	• Sometimes
	• Rarely
	• Never [Ensure this is scored as 0]

Which I think covers some of what you have suggested but by asking about the specific tools rather than the generic categories.  As this is such a catch-all I will add a question:

	[QUESTION - Comment Box]
	Please list any other tools that you use and the purpose of those tools

Jay

> 
> Best regards, Julian
> 
> ___________________________________________________________
> Tools-discuss mailing list
> Tools-discuss@ietf.org
> https://www.ietf.org/mailman/listinfo/tools-discuss
> 
> Please report datatracker.ietf.org and mailarchive.ietf.org
> bugs at http://tools.ietf.org/tools/ietfdb
> or send email to datatracker-project@ietf.org
> 
> Please report tools.ietf.org bugs at
> http://tools.ietf.org/tools/issues
> or send email to webmaster@tools.ietf.org

-- 
Jay Daley
IETF Executive Director
jay@ietf.org