tc39/ecma262

add IDs to more `<dfn>`s

Open

#3,502 opened on Nov 27, 2024

View on GitHub
 (1 comment) (0 reactions) (0 assignees)HTML (15,626 stars) (1,409 forks)batch import
editorial changegood first issue

Description

Most, if not all, <dfn>s would benefit from being able to browse references using the references pane. Unfortunately, the references pane is only enabled for <dfn>s that are given an id attribute, which many currently lack. We should go through and add IDs to any that are reasonable.

example references link on mouseover

example references pane

Contributor guide

Tech stack
htmljavascript
Domain
documentation
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
basic HTMLfamiliarity with ECMAScript spec
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
85
Research direction
Look through the HTML source files in the ecma262 repository for `<dfn>` tags that lack an id attribute. For each such element, determine a suitable id based on the defined term, ensuring it is unique and follows existing conventions. Then add the id attribute. Files to modify are likely in the spec's source (e.g., .html files).