Why are 'note's so limited?

[miekg]

Note's are only allowed in the front section, but they can hardly contain anything, 7991 bills them as unnumbered section, but then limits what can be contained in them. Why?

It makes more sense to say a note is a unnumbered section, with the restriction it can only exist in a front section.

[reschke]

What elements are you missing?

[miekg]

I wanted to render this markdown snippet as a note: https://raw.githubusercontent.com/miekg/learninggo/mmark2/preface.md

Meaning I wanted to have:

• <eref>
• <blockquote>

and possibly more. I can see (some) value limiting this for RFC creation, but looks arbitrary.

[reschke]

FWIW, you can have \, the same way as in regular sections.

[miekg]

<Note> also doesn't have an anchor attribute; meaning it is one of the few things left you can't reference.

[reschke]

I believe it should allow anchor.

[levkowetz]

On 2018-09-19 07:46, Julian Reschke wrote:

I believe it should allow anchor.

Aren't notes expected to be removed before publication? If so, having links to them would make for more work during publication.

[reschke]

a) Some notes stay in the document. b) That said, I agree that linking from within the document might be a bad idea (maybe cause for a warning). c) However, it might be good if the note could be assigned a meaningful anchor name for linking from other documents.

[miekg]

did we have a discussion on this one on the list?

[stpeter]

We discussed this in the XML change management team and concluded that the note element is fine as-is because it is intended for use only after the abstract in special circumstances (e.g., IESG notes and ISE notes). The original poster likely should have used the aside element instead of the note element. It's possible that improved documentation is needed.