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

Warren Kumari <warren@kumari.net> Thu, 01 October 2020 20:17 UTC

Return-Path: <warren@kumari.net>
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 B2DFB3A082F for <tools-discuss@ietfa.amsl.com>; Thu, 1 Oct 2020 13:17:52 -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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=unavailable autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=kumari-net.20150623.gappssmtp.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 c1RuEPeBYsCZ for <tools-discuss@ietfa.amsl.com>; Thu, 1 Oct 2020 13:17:50 -0700 (PDT)
Received: from mail-lj1-x22f.google.com (mail-lj1-x22f.google.com [IPv6:2a00:1450:4864:20::22f]) (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 D6ED83A082C for <tools-discuss@ietf.org>; Thu, 1 Oct 2020 13:17:49 -0700 (PDT)
Received: by mail-lj1-x22f.google.com with SMTP id b19so5728326lji.11 for <tools-discuss@ietf.org>; Thu, 01 Oct 2020 13:17:49 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kumari-net.20150623.gappssmtp.com; s=20150623; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc:content-transfer-encoding; bh=5NVvrP3bxrgvgAeYt4NoVl2j00XcIg1+35lX6VHIFnU=; b=L4oP5oLYmwtpmsQ6It8egunf+7aKaPLAPWsyS82OgSaGereaBZ/mlf+yOrw6xzTvRr 8swmmoX9X8efzodu8ATpaDkF3Ky4Vr4ChGn9HbCjGaD2Pbujeye4ZLEa5OlFMg7CSpk8 inSyk+F84CjsBpYiEDRyR3I+g8jv1Bt20N07sPEtTx9kexgwPlSgqkEbPUR7kYfXl39G LospRhtquFej0sJ6I9wv2TZK3Stm7XVPmUvtKplj3ppjDpK+//q+5bp5lkgp/yjH1vrI 5ytcgm1CKg9z+iRlJgJGzeLQOvVI4Lg16155JbnsXlMeZBVtUXNoAb6wtsfcTNp3gco8 Cf+Q==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc:content-transfer-encoding; bh=5NVvrP3bxrgvgAeYt4NoVl2j00XcIg1+35lX6VHIFnU=; b=Z4kIJ/fiSOE7NRsRcq/FEe4LJNqR90W0Sm75VWi+i5DY4PSmxOo7m0EgHDqzlivjD0 XjUfnF6RwGRG74Iy6MvnaSX+W5SRanzL2bdwZGxCU/ixpASGoMRRQkznRwpbnEDNZnm5 yBwOVg1IjvJr6PJbPcJq+VnUzjOXamZsDofGG/cZ3VHzJNRqFhPh3rLN3dYEL0nvbe2Z NSgPNrOTaP8gFYYj87xD6HHXBDJ96fZf3QASemTXsSE4RVD6+I6t4nnNVqnKrR6ZbAJ+ hoGgryBbDJH/A9LpDcB4yOAM+VGxVEQdhugYx14gbEZatYyVjKPRWhozgak83poiD31Z IkgQ==
X-Gm-Message-State: AOAM532dDmuZLm9g/Yc7r0/56/umtTrg7YHMa4ifgxTa2iEpeMpDLAL5 greCLDakW6usM+UH4c0haSjO7tKei10GCllpQQaf2A==
X-Google-Smtp-Source: ABdhPJyKzMRE6b8pplKeyJ3avD7eILbHJb/+fUJiu5LJ9vA+hijOieyblaJMQ+6e/x6JdhbjT+relue2bh8fGJtUcOg=
X-Received: by 2002:a2e:2e13:: with SMTP id u19mr2782096lju.11.1601583467142; Thu, 01 Oct 2020 13:17:47 -0700 (PDT)
MIME-Version: 1.0
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>
In-Reply-To: <E909F63E-F780-4171-B88D-D094EAC233CF@ietf.org>
From: Warren Kumari <warren@kumari.net>
Date: Thu, 1 Oct 2020 16:17:09 -0400
Message-ID: <CAHw9_iLtVqNUz3ZxATMJHOHW-MVUEh8coQkep_=x0cCDWdQDjw@mail.gmail.com>
To: Jay Daley <jay@ietf.org>
Cc: RFC Interest <rfc-interest@rfc-editor.org>, Tools Discussion <tools-discuss@ietf.org>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/PUyrbL5cQlt4tReRanb-zqVv6Y4>
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: Thu, 01 Oct 2020 20:17:53 -0000

Can we add: XMLMind with the xml2rfc-xxe plugin
to the "document format(s) and associated output process(es)" list?

This plugin was originally created by Billo, and I took over
maintenance many years back I don't know how many people still use it,
but there are howls of outrage everytime a new version of XMLMind
comes out and I don't release a new version in time.
This will at least help me know if it is still worth my time to rev
and post it...

W

On Thu, Oct 1, 2020 at 1:09 PM Jay Daley <jay@ietf.org> wrote:
>
> 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
>
> # Question Plan
>
> [PAGE]
> Introduction
>
> [HELPTEXT]
> Thank you for taking part in this survey.  This survey has been sent to everyone who has authored an Internet-Draft (I-D) in the last five years and is open to anyone who has ever authored an I-D.
>
> We are hoping to understand what formats and tools you use to author I-Ds, from drafting to submission.
>
> In particular, we are hoping to find out more about the use (or non-use) of the v3 XML format for I-Ds, which became the publication format for RFCs on 16 September 2019.
>
> [QUESTION - Multiple Choice]
> Approximately, how many I-Ds have you authored in total (different I-Ds not versions of the same I-D)?
> If you need a reminder then your Datatracker page will have the details.
>         • 0
>         • 1-5
>         • 6-10
>         • 11-20
>         • 21-50
>         • 51+
>
> [QUESTION - Matrix/Rating Scale]
> Approximately, how many times have you submitted a draft (both a new draft and a new version) to the Datatracker?
> Items
>         • 0
>         • 1-10
>         • 11-20
>         • 21-50
>         • 50-100
>         • 101+
> Scale
>         • In total
>         • Last 2 years (Since September 2018)
>         • Last year (since September 2019)
>
> [QUESTION - Multiple Choice]
> How many RFCs have you authored?
>         • 0
>         • 1-5
>         • 6-10
>         • 11-20
>         • 21-50
>         • 51+
>
>
> [PAGE]
> Drafting to submission
>
> [LOGIC]
> Only get here if they have authored an I-D.
>
> [QUESTION - Matrix/Rating Scale]
> How often have you used the following document format(s) and associated output process(es) (editor/template/converter) when authoring an I-D? (Ignore any you don’t know about)
> Items
>         • Plain text using no markup
>         • Plain text using a different output process
>         • Markdown using the kramdown-rfc2629 converter
>         • Markdown using the mmark converter
>         • Markdown using the draftr converter
>         • Markdown using the Pandoc2rfc converter
>         • Markdown using a different output process
>         • XML using the xml2rfc-xxe editor plugin
>         • XML using xml2rfc to create plain text for submission
>         • XML using a different output process
>         • AsciiDoc using the metanorma-ietf (formerly known as asciidoctor-rfc) converter
>         • AsciiDoc using a different output process
>         • TeX / LaTeX using the lyx2rfc editor plugin
>         • TeX / LaTeX using a different output process
>         • nroff using the Nroff Edit editor
>         • nroff using nroff2xml template
>         • nroff using a different output process
>         • .doc/.docx using Joe Touch’s Word Template (RFC5385)
>         • .doc/.docx using a different output process (This means specifically using rich text styles that a template/convertor will recognise)
>         • Other format (Only use this option if you author in a different format to all of those above) [PLEASE SPECIFY what format you author in and what output process you use]
> Scale
>         • Always
>         • Very often
>         • Sometimes
>         • Rarely
>         • Never [Ensure this is scored as 0]
>
> [QUESTION - Comment Box]
> If you answered “a different output process” in the question above then please specify what it is?
>
> [QUESTION - Checkboxes]
> How did you choose the document format(s) and associated output process(es) that you use? (Check all that apply)
>         • I researched the tools
>         • I decided on my authoring format first and then chose a tool that uses that
>         • I saw a presentation on one of the tools at an IETF meeting
>         • Another author of my document chose for me
>         • The I-D I wanted to contribute to was already drafted in one of these tools
>         • Someone else helped me set up my tools
>         • Other [PLEASE SPECIFY]
>
> [QUESTION - Matrix/Rating Scale]
> How often have you used the following template(s) when drafting an I-D? (Ignore any you don’t know about)
> Items
>         • A copy of a previous I-D / RFC
>         • A template from https://tools.ietf.org/tools/templates/
>         • A template that came with my chosen authoring tool/process
>         • My own
>         • Other [PLEASE SPECIFY]
> Scale
>         • Always
>         • Very often
>         • Sometimes
>         • Rarely
>         • Never [Ensure this is scored as 0]
>
> [QUESTION - Matrix/Rating Scale]
> How often do you use the following checking tools? (Ignore any you don’t know about)
> Items
>         • I validate against the RelaxNG schema for the RFC XML in my XML editor
>         • 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
>         • 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
> Scale
>         • Always
>         • Very often
>         • Sometimes
>         • Rarely
>         • Never [Ensure this is scored as 0]
>
> [QUESTION - Matrix/Rating Scale]
> How often do you use the following conversion tools? (Ignore any you don’t know about)
> Items
>         • bibtext2rfc to convert bibtext citations into bibxml references
>         • bibxml2md to convert bibxml references into markdown
>         • Doublespace tool to change spacing between sentences to two spaces
>         • id2xml to convert a plain text I-D into XML
>         • rfc2629xslt to convert RFC XML to another format
>         • xml2rfc to convert RFC XML to another format
> Scale
>         • Always
>         • Very often
>         • Sometimes
>         • Rarely
>         • Never [Ensure this is scored as 0]
>
> [QUESTION - Checkboxes]
> How do you run your tools? (Check all that apply)
>         • Locally
>         • On a private hosted server
>         • On an IETF public web service
>         • On a third-party public web service
>         • Other [PLEASE SPECIFY]
>
> [QUESTION - Multiple Choice]
> Do you run an automated build process?
>         • Yes - I-D Template
>         • Yes - Using GitHub CI/CD
>         • Yes - Using Gitlab CI/CD
>         • Yes - Using Jenkins
>         • Yes - Using CircleCI
>         • Yes - Other [PLEASE SPECIFY]
>         • No
>
>
> [PAGE]
> XML v3
>
> [QUESTION - Multiple Choice]
> How do you rate your knowledge of the v3 official RFC/I-D XML format?
>         • Excellent
>         • Good
>         • Fair
>         • Poor
>         • None
>
> [QUESTION - Matrix/Rating Scale]
> How satisfied are you with the following characteristics of the v3 XML format?
> Items
>         • Ease of use
>         • Features
>         • Documentation
>         • Tools support
>         • Other [PLEASE SPECIFY]
> Scale
>         • Very satisfied
>         • Satisfied
>         • Neutral
>         • Dissatisfied
>         • Very dissatisfied
>         • N/A
>
> [QUESTION - Matrix/Rating Scale]
> How important are the following characteristics of the v3 XML format to you?
> Items
>         • Ease of use
>         • Features
>         • Documentation
>         • Tools support
>         • Other [PLEASE SPECIFY]
> Scale
>         • Very important
>         • Important
>         • Neutral
>         • Unimportant
>         • Very unimportant
>         • N/A
>
> [QUESTION - Comment Box]
> What more needs to be done to support the rollout of the v3 XML format?
>
>
> [PAGE]
> State of the current authoring tools landscape
>
> [QUESTION - Matrix/Rating Scale]
> How satisfied are you with the following characteristics of authoring tools?
> Items
>         • Ease of use
>         • Integration with IETF processes
>         • Support for the full range of tags / metadata
>         • Control of output
>         • Support of various output formats
>         • Integration with version control systems
>         • Speed at which new features are added
>         • Overall quality
>         • Choice of different tools
>         • Other [PLEASE SPECIFY]
> Scale
>         • Very satisfied
>         • Satisfied
>         • Neutral
>         • Dissatisfied
>         • Very dissatisfied
>         • N/A
>
> [QUESTION - Matrix/Rating Scale]
> How Important are the following characteristics of authoring tools to you?
> Items
>         • Ease of use
>         • Integration with IETF processes
>         • Support for the full range of tags / metadata
>         • Control of output
>         • Support of various output formats
>         • Integration with version control systems
>         • Speed at which new features are added
>         • Overall quality
>         • Choice of different tools
>         • Other [PLEASE SPECIFY]
> Scale
>         • Very important
>         • Important
>         • Neutral
>         • Not important
>         • Not at all important
>         • N/A
>
> [QUESTION - Multiple Choice]
> Should the IETF invest in a new, modern toolchain for authoring drafts?
>         • Strongly agree
>         • Agree
>         • Neutral
>         • Disagree
>         • Strongly disagree
>
> [QUESTION - Matrix/Rating Scale]
> How important is it for you for any new tool to support the following authoring formats?
> Items
>         • Plain text
>         • Markdown
>         • XML
>         • nroff
>         • AsciiDoc
>         • Some form of WYSIWYG (e.g. MS Word or LibreOffice)
>         • Other [PLEASE SPECIFY]
> Scale
>         • Very important
>         • Important
>         • Neutral
>         • Not important
>         • Not at all important
>         • N/A
>
> [QUESTION - Comment Box]
> Do you have any more feedback on authoring tools and formats?
>
> --
> Jay Daley
> IETF Executive Director
> jay@ietf.org
>
> ___________________________________________________________
> 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



--
I don't think the execution is relevant when it was obviously a bad
idea in the first place.
This is like putting rabid weasels in your pants, and later expressing
regret at having chosen those particular rabid weasels and that pair
of pants.
   ---maf