[rfc-i] draft-flanagan-rfc-framework-02 composition tools

jmh at joelhalpern.com (Joel M. Halpern) Tue, 04 November 2014 00:39 UTC

From: "jmh at joelhalpern.com"
Date: Mon, 03 Nov 2014 19:39:18 -0500
Subject: [rfc-i] draft-flanagan-rfc-framework-02 composition tools
In-Reply-To: <54581DF1.1070100@isi.edu>
References: <12093BCD-14FA-475D-810F-065EEBE87872@cisco.com> <20141101231012.66362.qmail@ary.lan> <CAK3OfOi6=_8vD=4aRRPGR8y7wm5PoskGh2QX3qP+-_1dyXWUWg@mail.gmail.com> <54578A22.6000707@cisco.com> <m038a0e2pr.fsf@tzi.org> <5457A423.8040301@cisco.com> <CAK3OfOifZT9c2N2kTmm7xU7d3Kn19FuN8OQDRXoLWogvdhnpBA@mail.gmail.com> <37596336-EAE5-4239-9D9D-F109B1E45C52@isi.edu> <CAK3OfOgRjL8xtBA7OnSPkej7NEgRdcPs51jua5w41ugX-zFCGQ@mail.gmail.com> <5457DAF8.9080701@isi.edu> <CAK3OfOiLeo1PhaYSy7J8=ergOph4z2ML-pj-E-7B0v6RmZE-Jw@mail.gmail.com> <CAK3OfOig9uqtX874QY46tY2OcdM8jvBBc1AQ2xTX9vJESy0daA@mail.gmail.com> <5457F456.1090504@isi.edu> <CAK3OfOhXj-vrctFRM0vv3foR24AOk5HAS27OyP-wZzB3XjnJ5w@mail.gmail.com> <5457F889.9060302@isi.edu> <6010461C-1EDD-44C9-8179-556C477950C6@fugue.com> <54581DF1.1070100@isi.edu>
Message-ID: <54582036.5070308@joelhalpern.com>

Having used MS Word on some large I-Ds I have to say that I am getting 
tired of the assertion that the only folks for whom Word won't work are 
the one Joe cites below.  In one case, we found using Word so unweildy 
that we hand-converted it into XML.

I am not asking the Joe Touch stop using Word.  But the assertions that 
it is workable for the bulk of us make assumptions that are not 
supported by the evidence.

If the request is that we plan for conversion tools to permit authoring 
in MS Word, with the understanding that it will be less effective since 
there is no way to capture the original metadata cleanly in MS Word, but 
instead the tools must guess the values, I could see us including that 
in the migration plans.

Yours,
Joel

On 11/3/14, 7:29 PM, Joe Touch wrote:
>
>
> On 11/3/2014 2:54 PM, Ted Lemon wrote:
>> On Nov 3, 2014, at 4:50 PM, Joe Touch <touch at isi.edu> wrote:
>>> I agree, but why do we want to use xml2rfc if it boxes us into things
>>> like this?
>>
>> You saying this as if you were proposing some alternative that would
>> box us in less.   But you haven't made a real proposition--all we
>> have is that you think Word would work.
>
> I want a solution for which Word can be used as an authoring tool.
> Support for authoring tools hasn't been a key factor in the progress to
> date.
>
>> But we know that Word
>> doesn't address a great many of the very definite requirements we
>> have articulated; in particular, it would not be usable for some
>> significant percentage of the IETF membership.
>
> The percentage of the IETF that does not use Windows, MacOS, or Linux,
> agreed.
>
>> And it boxes us in far worse than xml2rfc does.    You said we should
>> aim higher, but we *are* aiming higher than Word.   It just depends
>> on what you mean by "higher."   You are putting usability for
>> Microsoft Word users as the highest value, and trying to drag
>> everything else through that wormhole, but first, that's not our user
>> base, and second, usability for document editors is not the only or
>> even the most important requirement for this solution.
>
> I have seen a lot of requirements driven from the need for automatic
> extraction of document structure or contents, but have not seen a good
> rationale as to the need to do that from documents.
>
>> So this is why you aren't getting the traction that you think you
>> should be getting here: you are pushing a solution to the wrong
>> problem.
>
> The problem is DOCUMENTATION.
>
> This isn't a programming project.
>
> Joe
> _______________________________________________
> rfc-interest mailing list
> rfc-interest at rfc-editor.org
> https://www.rfc-editor.org/mailman/listinfo/rfc-interest
>