Re: [Rswg] Making progress on RFC 7991-bis

[Brian E Carpenter <[e-mail]>]

> deprecation is only forward guidance that this feature will be removed in a future version.

Hate to repeat myself, but this implies a definition of "deprecate" that makes archived XML files invalid. For now we clearly do not have consensus that this is OK. (My comment yesterday on draft-hoffman-rfc7990-updates-01 effectively suggests a way to resolve this.)

Otherwise I think both of Jay's messages are very much to the point.

Regards
    Brian Carpenter

On 12-Aug-22 02:57, Jay Daley wrote:
> 
> 
>> On 2 Aug 2022, at 18:07, Eric Rescorla <[e-mail]> wrote:
>>
>> 1. Do we need to publish the current de facto format as an
>>     RFC or should it be in some other form such as an I-D
>>     or a Web page?
> 
> I believe it should be an RFC because that forces a specific process on us whereby there is a lot of discussion, each new version incorporates a big set of changes and new versions are infrequent and well distributed.  By contrast, a web page or I-D would quickly become a much faster changing process with each new version having a small number of changes.  I see the former process as better for the following reasons:
> 
> 1.  As has been amply demonstrated, allowing a relatively quick, much less visible and non-consensus change process has got us into a mess.
> 
> 2.  Almost every change that might go into the grammar has a significant level of complexity and a full WG process is the best way to tease out that complexity and ensure that any changes are good changes.
> 
> 3.  We have never had an example of an urgent change needed to the grammar such that the RFC development process would be too slow.
> 
> 4.  We have many people in the community who still use v2 and even those who use v3 are using different versions depending on how up to date their xml2rfc is, and what files they copied into working directories when.  A slow running RFC process is the best fit to the way the community works whereas a fast changing process will increase this lack of cohesion.
> 
> 5.  If we want to move from the situation where we have only two tools (xml2rfc and Julian’s XSLT) that directly support the grammar, to an ecosystem of tools that do so, then an RFC is the best support of that from an implementer perspective.
> 
> 6.  One element of the mess has been identifying where the authoritative version of the grammar can be found.  Until recently that was the rnc source file as found in the subversion repository of the xml2rfc tool.  Now it is this file in GitHub https://raw.githubusercontent.com/ietf-tools/rfcxml-templates-and-schemas/main/rfc7991bis.rnc but other than us simply declaring that, there’s no way to always point to that.   If we have an RFC then that becomes the authoritative source.
> 
>>     
>> 2. Should we just publish the de facto format as-is
>>     or should we make limited changes prior to the completion of
>>     a more complete format document? If the latter, what process
>>     should we use to vet those changes?
> 
> Sorry, this is a complex answer:
> 
> A.  Yes we must document the de facto grammar as is.  Please note that there are three parts to this:
> 
>    i.  The changes documented in https://www.ietf.org/archive/id/draft-levkowetz-xml2rfc-v3-implementation-notes-13.html
> 
>    ii.  The elements defined in the grammar that are not documented in any RFC such as <toc>
> 
>    iii.  There are a number of xml2rfc specific processing instructions (those of the form <?rfc … >) and these, while not strictly part of the grammar, were the only way to achieve things in v2 that can now be done in the v3 grammar and so were effectively obsoleted by RFC 7991 thought that was never explicitly stated. It would be very useful to have a simple statement that all xml2rfc specific PIs are now obsoleted because people are still confused by this.
> 
> B.  This new RFC should describe version "3.1" of the grammar, reflecting its backward compatibility rather than be also be numbered v3 or jump to v4.
> 
> C.  If the chairs think we can reasonably quickly get agreement on deprecating any features (such as the complex postal stuff) then that deprecation should follow the normal use of deprecation - the grammar feature remains and can be used as before and deprecation is only forward guidance that this feature will be removed in a future version.
> 
> D.  I would like to see this document formally rename "The xml2rfc vocabulary" to "RFCXML" reflecting the de facto renaming in the authoritative documentation and the discussion around that on the tools-discuss list.  I’ll post a separate message reminding people why this has happened and re-opening the discussion to see how this group feels about it.
> 
> Jay
> 
>>
>> - Pete and Eric (as chairs)
>>
>