xml2rfc
xml2rfc copied to clipboard
Review alternate link to XML source in HTML output
Describe the issue
At the moment, xml2rfc adds a link to source XML.
Examples:
<link href="rfc9552.xml" rel="alternate" type="application/rfc+xml">
<link href="/a/www/www6s/staging/draft-ietf-6man-rfc6724-update-06.xml" rel="alternate" type="application/rfc+xml">
The href is from the path given at the execution time, xml2rfc doesn't treat RFC and I-Ds differently in this case.
RFC 7992 states that the href attribute should be pointing to the prepared XML source that was used to
generate this document. Provided example is <link rel="alternate" type="application/rfc+xml" href="source.xml">. ^1
Suggestion from @rjsparks:
The href attribute should emit the basename in all cases.
Code of Conduct
- [X] I agree to follow the IETF's Code of Conduct
Alternatively, a link to the source should be provided explicitly to xml2rfc at the runtime as a command line argument because the source link can be different.
cc: @paulehoffman, @reschke
I don't think it matters a lot, but it definitvely should make sense for documents that aren't RFCs yet (or be omitted).
I'm with Robert: just the basename, as is shown in 7992.
Well, the basename will be resolved against the context URI, otherwise it wouldn't make sense (sorry if I'm stating the obvious here).