IETF Logo Mail Archive

Re: document writing/editing tools used by IETF

Phillip Hallam-Baker <phill@hallambaker.com> Fri, 26 February 2021 03:18 UTC

Return-Path: <hallam@gmail.com>
X-Original-To: ietf@ietfa.amsl.com
Delivered-To: ietf@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 8A05E3A16D6 for <ietf@ietfa.amsl.com>; Thu, 25 Feb 2021 19:18:17 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.399
X-Spam-Level:
X-Spam-Status: No, score=-1.399 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.25, HTML_MESSAGE=0.001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=no 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 oI-Tm7ucurWx for <ietf@ietfa.amsl.com>; Thu, 25 Feb 2021 19:18:16 -0800 (PST)
Received: from mail-yb1-f180.google.com (mail-yb1-f180.google.com [209.85.219.180]) (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 433C13A16D4 for <ietf@ietf.org>; Thu, 25 Feb 2021 19:18:16 -0800 (PST)
Received: by mail-yb1-f180.google.com with SMTP id l8so7555239ybe.12 for <ietf@ietf.org>; Thu, 25 Feb 2021 19:18:15 -0800 (PST)
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; bh=FzcRbJpfWMKohtuMK7bmqSxkcBtlixrJRODRC1IbT+Q=; b=SmkH9geec36+bZ5vdv4jDoxoCt1ZeCXShQw4qObJGskUx7h/2R1tEOweNU5dXP2w1n LhuRAQsJmHA9Rfg3dPzm2LkrLUQ6oe3mcsZfpLN6pjPFkNR0JWj9h+Z5PxZcptXPsMnp rTB1xqzez1bDTx0jSs+5kYgNjdIYhBYQgZ/qEfnIwnG9lcm6EhLtxhwCAVl90ij3liz+ XyFdIYKcy1y9HienmGoLtyFkj7PPvtK5H8FIyFETO63ZiBOVrFLrqjL3RXHXQah5RBb2 4+2Fdpeqoatx9UaXca9NljAttR2KI8kBNFLx6o6rVYox6Ioor8EAbsUM4wMEli101D4l /WWg==
X-Gm-Message-State: AOAM530BXWrD0iUwgFunmEXTeuh0gQhcvuH5PRb1bFL0EDk4adnwwY/B lPQ1PPbMCIwrwlnZdyCfhYiOCvUyyODdQMTjyC8=
X-Google-Smtp-Source: ABdhPJxO+C0IxdN0Djw1nValr1LbYON21nrWw8G5F/K3aHJJeSARu8uvNN+PcOkXXpL4+cHQ7ev0D2n3igzQ88oh8xk=
X-Received: by 2002:a25:2ac3:: with SMTP id q186mr1534885ybq.213.1614309495222; Thu, 25 Feb 2021 19:18:15 -0800 (PST)
MIME-Version: 1.0
References: <37eecb9b-f0eb-e21c-b162-b1f0339e4981@si6networks.com> <3c2d646d-f18d-4d88-b458-29dbd486432b@beta.fastmail.com> <446A8D6B-E624-49E0-B67E-D1F8AFC794E2@lastpresslabel.com> <28ac1e86-f641-b9e8-0f61-6ff442feaa90@si6networks.com> <LO2P265MB057322BA95B1B44D4175356BC29E9@LO2P265MB0573.GBRP265.PROD.OUTLOOK.COM> <089096b1-10d2-3eac-d37c-f040a1930061@network-heretics.com> <37142313-C251-40DC-9336-D3A2F0FB69AD@tzi.org> <001d01d70be3$ff0972d0$fd1c5870$@acm.org>
In-Reply-To: <001d01d70be3$ff0972d0$fd1c5870$@acm.org>
From: Phillip Hallam-Baker <phill@hallambaker.com>
Date: Thu, 25 Feb 2021 22:18:02 -0500
Message-ID: <CAMm+LwhkLTKkp3q4s97TBA-=WpJPof861mygPSjJttowpDjGuw@mail.gmail.com>
Subject: Re: document writing/editing tools used by IETF
To: Larry Masinter <LMM@acm.org>
Cc: Carsten Bormann <cabo@tzi.org>, Keith Moore <moore@network-heretics.com>, IETF Discussion Mailing List <ietf@ietf.org>
Content-Type: multipart/alternative; boundary="00000000000005375305bc34b85f"
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf/yh-JLyXYSYAr5WgVL4eji3bQ95o>
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF-Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf>, <mailto:ietf-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/ietf/>
List-Post: <mailto:ietf@ietf.org>
List-Help: <mailto:ietf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 26 Feb 2021 03:18:18 -0000

On Thu, Feb 25, 2021 at 9:08 PM Larry Masinter <LMM@acm.org> wrote:

> Keith is talking about formats for submission. For collaboration, there's
> a generation of collaborative tools from Google Docs to Dropbox and
> Microsoft tools that are a lot better than GitHub for collaboration.
>

There only needs to be a single interface to the ID/RFC system.

My model is to allow the authors to edit the drafts in Word/Markdown and
create HTML output close to what the ID/RFC system produces. When they have
agreed on an update, they send the .xml file to the submission system.

So

Source: Word (for spell checked text), Markdown (for machine generated text)
Review: HTML (caveman TXT if people must).
Submit: XML2RFC

I regard XML2RFC to be a submission format and nothing more. At the moment,
it is generated as a file format along with the HTML and TXT versions but I
am thinking about moving to a separate submit command which would interface
directly to the ID submission system. This would allow some housekeeping
functions to be done more smoothly.

v2.23.0 | Report a Bug | By Email