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

[Robert Sparks <[e-mail]>]

Inline:

On 8/11/22 9:57 AM, 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.

I'm not sure that's true.

Several of the changes, particularly early changes, that moved away from 
7991 were driven by the need to publish an RFC. The RPC even has a state 
for blocking on tools, and we haven't had a reason to use it _recently_ 
for something that would affect the grammar, but before it was created, 
we likely would have around the <br> and <tt> changes for example. There 
were things that had to be changed for the earlier v3 era RFCs to proceed.

Further changes aren't appearing as frequently now as we have developed 
a better ability to push back on author demands with "that's going to 
require an update to 7991".

So "never" doesn't feel like the right observation to make as input to 
this reasoning, and I _do_ think we need to anticipate needing urgent 
changes in the future, and have a mechanism ready for achieving that.

>
> 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)
>>