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

touch at isi.edu (Joe Touch) Tue, 04 November 2014 00:43 UTC

From: "touch at isi.edu"
Date: Mon, 03 Nov 2014 16:43:59 -0800
Subject: [rfc-i] draft-flanagan-rfc-framework-02 composition tools
In-Reply-To: <54582036.5070308@joelhalpern.com>
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> <54582036.5070308@joelhalpern.com>
Message-ID: <5458214F.9010706@isi.edu>

Current Word does not support the "metadata" that XML does right now.

That can be taken as a deficiency of Word.

It can also be taken as a deficiency of the XML - that it cannot be
easily generated from Word, or that it's not clear that some such
metadata is even important.

Joe

On 11/3/2014 4:39 PM, Joel M. Halpern wrote:
> 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
>>
> _______________________________________________
> rfc-interest mailing list
> rfc-interest at rfc-editor.org
> https://www.rfc-editor.org/mailman/listinfo/rfc-interest