Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Issues related to changed definition of <references> #135

Open
4 tasks
reschke opened this issue May 3, 2020 · 0 comments
Open
4 tasks

Issues related to changed definition of <references> #135

reschke opened this issue May 3, 2020 · 0 comments
Labels
style guide Changes that would affect RFC 7322, the style guide

Comments

@reschke
Copy link
Contributor

reschke commented May 3, 2020

...as done for #49:

  • The grammar describes the <name> child element as optional, but xml2rfc requires it
  • Allowing nesting implies that there now can be deeper hierarchies; this needs to be discussed and potentially disallowed in prose
  • The <back> element still allows multiple <references> child elements; either the grammar should be restricted or this should be mentioned in prose (this might also require changes in the Style Guide); in particular, a v2 processor will handle two <references> entries in <back> differently than xml2rfv in v3 mode (and that's really confusing)

Proposal: back out the change; it's not needed and was indeed discussed before and rejected. The problem discussed in https://tools.ietf.org/html/draft-levkowetz-xml2rfc-v3-implementation-notes-00#section-3.1.6 could be fixed simply by moving the associated text from the HTML spec to the vocabulary spec.

Potential extension:

  • Add "removeInRFC" attribute for references sections that will go away upon RFC publication
@reschke reschke changed the title Issues related to changed definition of \<references> Issues related to changed definition of <references> May 3, 2020
@stpeter stpeter added the style guide Changes that would affect RFC 7322, the style guide label Jul 23, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
style guide Changes that would affect RFC 7322, the style guide
Projects
None yet
Development

No branches or pull requests

2 participants