10000 Header self-refs should use anchor names chosen by the author · Issue #1157 · ietf-tools/xml2rfc · GitHub
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content
Header self-refs should use anchor names chosen by the author #1157
Open
@asbjornu

Description

@asbjornu

Describe the issue

As pointed out by @royfielding in #1156 (comment):

It is not appropriate for the tools to override the anchor names chosen by the authors. We deliberately chose those names and expect them to appear in all section and ToC references. It is still a bug even if the old references work, since we do not want two or three alias names for every section ref. We only want the ones that are authored in the XML.

As an example, the Range Requests header in RFC 9110 points to the anchor #name-range-requests, while the appropriate anchor to point to would be #range.requests, as the presumably author-chosen identifier of the header's parent element:

<div id="range.requests">
  <section id="section-14">
    <h2 id="name-range-requests">
      <a href="#section-14" class="section-number selfRef">14. </a>
      <a href="#name-range-requests" class="section-name selfRef">Range Requests</a>
    </h2>
    <p id="section-14-1"></p>
    <p id="section-14-2"></p>
    <div id="range.units"></div>
    <div id="field.range"></div>
    <div id="field.accept-ranges"></div>
    <div id="field.content-range"></div>
    <div id="partial.PUT"></div>
    <div id="multipart.byteranges"></div>
  </section>
</div>

Code of Conduct

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingrpatIssues needing attention from RFC Production Advisory Team

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions

      0