informative dfn

informative-dfn linting rule

Default: false

Warns when a link in a normative section points to a definition that was defined in an informative section. Normative text should not depend on informatively-defined terms.

Example violation

<section class="informative">
  <dfn>fancy algorithm</dfn> is described here.
</section>

<section>
  <h2>Processing Model</h2>
  <!-- BAD: normative section linking to informative definition -->
  <p>Run the <a>fancy algorithm</a>.</p>
</section>

How to fix

Either:

1. Move the <dfn> to a normative section
2. Use a normative proxy: <dfn data-cite="spec#fancy-algorithm">fancy algorithm</dfn>
3. Add class="lint-ignore" to the specific link to suppress the warning

How to enable

var respecConfig = {
  lint: { "informative-dfn": true },
};