Re: Document diffs... Re: A sad farewell

Joseph Touch <touch@strayalpha.com> Fri, 06 November 2020 17:53 UTC

Return-Path: <touch@strayalpha.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 5B87B3A09D8 for <ietf@ietfa.amsl.com>; Fri, 6 Nov 2020 09:53:33 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.318
X-Spam-Level:
X-Spam-Status: No, score=-1.318 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, HTML_MESSAGE=0.001, SPF_HELO_NONE=0.001, SPF_NEUTRAL=0.779, URIBL_BLOCKED=0.001] autolearn=no autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=strayalpha.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 KHQOLQVDxZUj for <ietf@ietfa.amsl.com>; Fri, 6 Nov 2020 09:53:31 -0800 (PST)
Received: from server217-4.web-hosting.com (server217-4.web-hosting.com [198.54.116.98]) (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 CD4393A09D6 for <ietf@ietf.org>; Fri, 6 Nov 2020 09:53:31 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=strayalpha.com; s=default; h=To:References:Message-Id:Cc:Date:In-Reply-To: From:Subject:Mime-Version:Content-Type:Sender:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id: List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=Rc3y+TeUv4Jlkrhb2QmCc8F41+s1x0UDXTTjkhHG86Q=; b=GGANrjap1OON/tAz3u89hg7E7 86TTE5PEu216/k60Ssw80wmV1I8Hw2fLjqxTFAHYme7rn5SOazUGjGb3Z61cTAy2ke3PdqVHQRcGS Soju7O3JBmCBHdGFGOJnhMuv+54HEHk2k58m9SxwMpmkZJJVwNHphI7pLk9ddh5RrAoKtDssOgJnc hanHDpD9yToSqdo8hm4AOe/vQh2YCkZC4/wAcBPgNbLwoLY4B1FqVaCHiwVYhb998nMfLnytI3Nal ahtboBeLr0jWkNmpRSeW3mePciA4wUXvm8Twv9oyU012L+V13EACpldZvdFx0Vv33Wz13VMd2eoXm r2BbzUeyg==;
Received: from cpe-172-250-225-198.socal.res.rr.com ([172.250.225.198]:49531 helo=[192.168.1.14]) by server217.web-hosting.com with esmtpsa (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.93) (envelope-from <touch@strayalpha.com>) id 1kb5vQ-000EDB-M5; Fri, 06 Nov 2020 12:53:31 -0500
Content-Type: multipart/alternative; boundary="Apple-Mail=_5405A116-18B0-4C08-B7A0-6337B4CF1309"
Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.120.23.2.1\))
Subject: Re: Document diffs... Re: A sad farewell
From: Joseph Touch <touch@strayalpha.com>
In-Reply-To: <CAMm+Lwg_Q-zqAtJZc95HhtTw7NcT3GeXgYWW+8WtecG3cEhK+g@mail.gmail.com>
Date: Fri, 06 Nov 2020 09:53:23 -0800
Cc: Larry Masinter <LMM@acm.org>, IETF <ietf@ietf.org>, Pete Resnick <resnick@episteme.net>
Message-Id: <FDF90C15-29D9-4AE7-A91C-9A2D7A541DA6@strayalpha.com>
References: <b0ca070f-dd1f-1b8d-940c-7e4c57ea8393@cisco.com> <5fa3ffbe.1c69fb81.a621e.78ba@mx.google.com> <MN2PR15MB3103C6573396210E2CA7274D97EE0@MN2PR15MB3103.namprd15.prod.outlook.com> <E971F6B0-EFF1-4E1D-8CCB-80FA7FEB722D@gmail.com> <20201105174127.GF1750809@mit.edu> <6f1fcd3a-c3cf-a9a7-7aaf-af327d337f43@mnt.se> <CAKq15vcBBGhwAd76LEQDhEa+e1XcTr2HGnmJw9J9y9znbjFMAw@mail.gmail.com> <174AC0A1-77B5-4B6B-AD9D-7C9FB6023BC1@episteme.net> <CAKq15vc947QrG0KgTdP2kiLpE_8YXbEWMZfyFqaGRdJ4me-Mxg@mail.gmail.com> <CE739672-72C4-44B7-821A-99AE400F574C@akamai.com> <CAKq15vdEVfk4ST+WEk06hdgVxMtUU=GKwZwTjtoUSxvEouHRfg@mail.gmail.com> <6FCC5D7B-2EDC-4191-AA0F-BE91211B9B07@akamai.com> <CAKq15vcRAu8VrDmZ-44z3vy8r=1Rx-AA0Xwsg84JFRjpX+=Ypg@mail.gmail.com> <CE764E62-AC69-4339-B4ED-A0D0044E995E@strayalpha.com> <CAMm+LwiwBz9xs6SSVZepxLru+qGN7KYKHeE2=58gxMf0Ay_eCA@mail.gmail.com> <6F08619A-046B-4A36-8623-546CD87A73FC@strayalpha.com> <CAMm+Lwg_Q-zqAtJZc95HhtTw7NcT3GeXgYWW+8WtecG3cEhK+g@mail.gmail.com>
To: Phillip Hallam-Baker <phill@hallambaker.com>
X-Mailer: Apple Mail (2.3608.120.23.2.1)
X-OutGoing-Spam-Status: No, score=-1.0
X-AntiAbuse: This header was added to track abuse, please include it with any abuse report
X-AntiAbuse: Primary Hostname - server217.web-hosting.com
X-AntiAbuse: Original Domain - ietf.org
X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12]
X-AntiAbuse: Sender Address Domain - strayalpha.com
X-Get-Message-Sender-Via: server217.web-hosting.com: authenticated_id: touch@strayalpha.com
X-Authenticated-Sender: server217.web-hosting.com: touch@strayalpha.com
X-Source:
X-Source-Args:
X-Source-Dir:
X-From-Rewrite: unmodified, already matched
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf/CY1MAUD3nApPY1Y5wYcsEI1HkNA>
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, 06 Nov 2020 17:53:33 -0000


> On Nov 6, 2020, at 9:06 AM, Phillip Hallam-Baker <phill@hallambaker.com> wrote:
> 
> On Fri, Nov 6, 2020 at 11:42 AM Joseph Touch <touch@strayalpha.com <mailto:touch@strayalpha.com>> wrote:
>> On Nov 6, 2020, at 8:02 AM, Phillip Hallam-Baker <phill@hallambaker.com <mailto:phill@hallambaker.com>> wrote:
>> 
>> My tool, RFCTool can accept input in Word, or Markdown or both. It is open source and runs on OSX, Linux and Windows.
> 
> Typing XML in Word is not really Word (E.g., references, anchors, tag data, etc.). 
> 
> Why on earth did you assume that was what I was doing?

From the instructions on inserting anchors and references. 

> IMO, the point of a Word template is to have it be able to edit and print drafts as they would be seen by users AND to allow use of Word’s internal cross-reference capability. 
> 
> Of course. I use an open source library that parses the Word document for me and returns a parse tree containing all the paragraph and line markup, cross references, etc. etc.
> 
> I do use a very small amount of pseudo-XML at the very start of a document because this is a more convenient means of expressing the IETF specific markup than breaking that all out into Word tags. I am also using xml tags for citations because we need those broken out into normative and informative and the Word citation manager isn't really fit for purpose.

And for cross-references, e.g., “See Section 12” or “See Figure 22”.

By the time you add it up, you’re taking a good chunk of why Word is useful and pushing it off to explicitly entered XML.

> I can easily extend the converter so that instead of typing <norm="draft-hallambaker-mesh-architecture"/> for a normative citation of that draft you would use a Word line style so that all you see is draft-hallambaker-mesh-architecture, preferably in a different color.

That’s not a Word cross-reference. That’s a line style. 

Joe