search

rfc-format / draft-iab-xml2rfc-v3-bis

-bis document for the RFC format xml2rfc v3 draft
6 stars 10 forks source link

document current semantics of rfc/@docName and rfc/@format #122

Closed reschke closed 4 years ago

reschke commented 4 years ago

(this is a first step towards the proposed resolution in https://www.ietf.org/id/draft-levkowetz-xml2rfc-v3-implementation-notes-10.html#section-3.1.21.5)

reschke commented 4 years ago

so here's the caveat: see https://gist.github.com/reschke/e1750b3a224528bf0eab1e4526efea84

xml2rfc uses seriesInfo for the BCP number, not the seriesInfo attribute; so it's inconsistent in where it takes information from (the RFC number is taken from the number attribute).

I don't think it makes sense to document this inconsistency; it would be better to either fix it, or directly proceed with removing \ from the \ element.

What do you think, @levkowetz ?