Re: [Tools-discuss] [rfc-i] Proposed survey on I-D authoring tools

Dan York <york@isoc.org> Thu, 01 October 2020 01:08 UTC

Return-Path: <york@isoc.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 A57393A0061; Wed, 30 Sep 2020 18:08:30 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.101
X-Spam-Level:
X-Spam-Status: No, score=-2.101 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, RCVD_IN_MSPIKE_H2=-0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=isoc.org
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 JaI1Tz_mT9nQ; Wed, 30 Sep 2020 18:08:29 -0700 (PDT)
Received: from NAM11-CO1-obe.outbound.protection.outlook.com (mail-co1nam11on2040.outbound.protection.outlook.com [40.107.220.40]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id D3AF73A005E; Wed, 30 Sep 2020 18:08:28 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=kCcCXjM8mLNiEov/7/Hf0k5UCxTmePk8yHCPEL5n45f2IQC1B4cUSSp51loDKu2Ixe49sj0ciBLSp0DX9eANdIvAJJ9sXWw9hr/c9uolu1dDOuWsA0YABrFS0vwylR0gPMqbUxtsBMjl30A4ri8rI9pOw+N5fTPtBZwPTFVlYzH6VpIF4i8hHbta8CAIn7oKhgOuxZweA6NnVZFMU00jQ+x/BzERN2Pf0F/wqvCUN2PTnSXh9VPFeuuQhgy6HXqn4VpTcVO1agXIeK6x2rMJi9ggUiA2Y5s8WJCeFy3jU8pt1aGjlS2zLAglvizkY8Mx8O3huxxdTCJ+Tr8WERhcTw==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=pxFybyFY4oT0s72Ots+CQMHc0q4VexejTgDbiZDkKAQ=; b=A9Xa2eeTB+Jzspc/m0psE6MkzOmt0MWTVA6nBxDbJsyqJqSrDyvl7kf5ZukIDeatYKwi3HmBEPcg7culzAA/2qnPaN0ibws8TUU3c6hqQH0rHwxHB6NPcC77W+oqKcevsfJKE/vadoTNQnZTSG5Y6umAUj5jGRTlHhSlP3HlQJXCXb0Vr2Nf4R11ugtMACOQE8/Mx3+z6jSg6Xx1KpgR6PN8royBLXdbfW+LxI+MmUDIypmHD77Q/d30ETdxqNCBLFc7q1Y4WUOxSxKg7ez8ZMc3lsZ0X1yN0LIZ5c/Fhyr+mlxtD7Xz8phry+WYTv+I3KFafzah/r/5d7ByUGy4aQ==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=isoc.org; dmarc=pass action=none header.from=isoc.org; dkim=pass header.d=isoc.org; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=isoc.org; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=pxFybyFY4oT0s72Ots+CQMHc0q4VexejTgDbiZDkKAQ=; b=faITR5s+r3nETXRbO7sL1/T9/Xum3ra6AEacoh64mBvN7nwETAnbC9cvIkhI9ewdDwQUsQ68R4pjRjSKihn7F51Zo1bXlyIxqi7JjnW73Wu14A+/J7TydCy/6rjAXmPeptvftlJ77SVs8jC0IW9TJ57y7xKGv5YdkjOZg9OYhxY=
Received: from BL0PR06MB4530.namprd06.prod.outlook.com (2603:10b6:208:5a::16) by MN2PR06MB6560.namprd06.prod.outlook.com (2603:10b6:208:20b::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3433.34; Thu, 1 Oct 2020 01:08:26 +0000
Received: from BL0PR06MB4530.namprd06.prod.outlook.com ([fe80::e969:45e7:f2a8:697e]) by BL0PR06MB4530.namprd06.prod.outlook.com ([fe80::e969:45e7:f2a8:697e%6]) with mapi id 15.20.3433.035; Thu, 1 Oct 2020 01:08:26 +0000
From: Dan York <york@isoc.org>
To: Jay Daley <jay@ietf.org>
CC: "rfc-interest@rfc-editor.org" <rfc-interest@rfc-editor.org>, Tools Discussion <tools-discuss@ietf.org>
Thread-Topic: [rfc-i] Proposed survey on I-D authoring tools
Thread-Index: AQHWl3tuYn3Tq9bUMUKB6NxrEmDsbqmB78OA
Date: Thu, 01 Oct 2020 01:08:26 +0000
Message-ID: <AB3DDB4B-A3D5-4C76-9BA4-B9D7DFE8DF8E@isoc.org>
References: <71CCD4C4-2CBA-4AD3-A254-2F19B261D882@ietf.org>
In-Reply-To: <71CCD4C4-2CBA-4AD3-A254-2F19B261D882@ietf.org>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
x-mailer: Apple Mail (2.3608.120.23.2.1)
authentication-results: ietf.org; dkim=none (message not signed) header.d=none;ietf.org; dmarc=none action=none header.from=isoc.org;
x-originating-ip: [2601:198:4100:84b0:b1ab:50e4:30b8:9219]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: 6c33320f-8fe8-429b-8221-08d865a68038
x-ms-traffictypediagnostic: MN2PR06MB6560:
x-microsoft-antispam-prvs: <MN2PR06MB6560FFD3805D0BA88491983CB7300@MN2PR06MB6560.namprd06.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:10000;
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: YpX3/oMXRBY2CNWVADXqghnxOU06xLB+fa4fh+Trb/6iN4yur7icgf6M3boLHErBROzW65DuLgtpMWuSRHWn2adXrkKT6u+a0gLRZzmXscWp4RSUSR/J/xzvdR8hHMEiNpUOge7Xp/W3EZYs2vZiri3GCgKn5lhp8SCw8g+2hUa/A1P6TprDqozvveLep+AmPxkbe6fufpTg4BgOYV1bfF3eZ7mmMxM7ct0dm9AzENfdgAR3ws2yCyNacZRZRs0/O8dH3OZOTD6ALfJbM4MkEDZdOYkZqvEuLS1NX4LHrH2KeKZONx/Oi7PGC7I1GaAJK9DyAo1Tl4S4NGeTblnZ0w==
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:BL0PR06MB4530.namprd06.prod.outlook.com; PTR:; CAT:NONE; SFS:(366004)(376002)(346002)(136003)(39840400004)(396003)(6486002)(6916009)(316002)(76116006)(66946007)(2906002)(71200400001)(66446008)(64756008)(66556008)(66476007)(6512007)(33656002)(36756003)(8676002)(54906003)(86362001)(2616005)(4326008)(8936002)(5660300002)(478600001)(6506007)(186003)(53546011); DIR:OUT; SFP:1101;
x-ms-exchange-antispam-messagedata: p+LQGQKbyhyICLXnpNp+qiNQJNQB9jyfFYeyoB/w56rM06P5uA0Fr2lupTxkzQcwd2TLu8iCaI5X1DC+k3llvAmAkE1wfNb2aj1Y4kdZl+BvuxNFcOP1t9QWR/CO441DS/ZpBa5a1OYN1Aj1QL64AouvkNsBR5DfCeR6XSEsShBDebRFcXZjXGxf0yPhxL6Cpr+/0v6/r1M5gD6aIFHv1ok5t88P5oHqbBkf/haWZsqnGr/beaz6I1LN2Dr2z2W6VxTVY1IxYIbVLoquItdIM/VU2dKLJRLIt9oGXf883Cd9P7qbOAy77CYE5TrClGtTMfu4da/i0j3rYUrf48zh5ZrkAEtRWSLOZ3F3LMX0fLcKRq0m4g5tvqsTd9zz3u4FfNr2W9VZDYlfEET3DKSNIyAB4isH5YdMbqM7te9WKtTh3gKmivBT+aVFqMCww/5XtbGqaH9rR1G2A1jLC/0R8/+WQW/Tmzh75MtJ1E6l4Lpvi0POzNbdT6z6/FUe8p2/Fo1MqHwcd3u/p57XnYsq3aveF3vjYGGrA50dbfUOmuRXuM1akBvACy+2PQfW2nLF7GIu1Ra1yiFeDYLUu2iawZhqWMS7gTH8oEPqgp1AxT8U3oPX69LOROH5/5kmLt0MF728XpOzqS54afxfMrLXQpJDGMH3Xyr8jGK/i+SL2uAYJq/pqMTpGAkOJoA7u9EaLqlSdlubY3KOPAlS1wb0oA==
x-ms-exchange-transport-forked: True
Content-Type: text/plain; charset="utf-8"
Content-ID: <0240609448D588408CDDF4AF53A03AEB@namprd06.prod.outlook.com>
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-OriginatorOrg: isoc.org
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: BL0PR06MB4530.namprd06.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 6c33320f-8fe8-429b-8221-08d865a68038
X-MS-Exchange-CrossTenant-originalarrivaltime: 01 Oct 2020 01:08:26.2229 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 89f84dfb-7285-4810-bc4d-8b9b5794554f
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: IYQflpiJssDV0kcOlT1O+kaXXzJYOtbv5RaBIzkl48pOlTcFV1sr446QApc+6XUf
X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR06MB6560
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/6trO2UIZJZhEpB2baJR7Pn3XPWE>
Subject: Re: [Tools-discuss] [rfc-i] 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 01:08:31 -0000

Jay,
A couple of comments inline… 

> On Sep 29, 2020, at 10:58 PM, Jay Daley <jay@ietf.org> wrote:
> 
> [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 chose for me

For clarity, perhaps “Another author of my document chose for me”

> 	• The I-D I wanted to contribute to was already drafted in one of these tools
> 	• Other [PLEASE SPECIFY]

What about something like “Someone else helped me set up my tools”?  I know I’ve helped a couple of people get set up by explaining what I use and pointing people to tools.  You could think of that as “I researched my tools” … but it might be interesting to know how much is really being passed around by people sharing info with each other.

> 
> [PAGE]
> XML v3

This entire section below assumes you either author in XML or have sufficient complexity in your documents where you need to know about XMLv3. In recent years I’ve shifted to writing drafts entirely in Markdown, and to be honest all my drafts have been simple enough in their text and formatting that I haven’t needed to know anything about the underlying XML. The transition from XML v2 to v3 did not seem to make a difference for my documents.

I think there are probably some % of authors who are in the same situation. Particularly newer authors who did not come out of the XML world and do their editing in some text format like Markdown or AsciiDoc, or use MS Word.

I understand the need to ask these questions because there *are* authors who do care about the v3 format (and in some cases care very strongly).

Maybe to make it easier on survey respondents, if you are using SurveyMonkey or some similar tool, perhaps you can use the option to conditionally display questions so that if someone answers “None” on the knowledge of the v3 format, then they won’t see the additional questions.

> 
> [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

On these two questions below, do we want to include something about “Integration with version control systems”?  I’m thinking about some of the different tools that are designed to work with git / GitHub.

> [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
> 	• 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
> 	• 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

Regards,
Dan