UTS #35 is not consistent about section references

Description

UTS #35 uses a variety of patterns for referencing sections. It would be better to establish some consistency for referencing and linking to sections rather than the following examples.

  • “Part <number>: Section <id> <title>”, e.g. “Part 1: Section 4.3 Likely Subtags”

  • “Part <number>, Section <id> <title>”, e.g. “Part 1, Section 3.2.1 Canonical Unicode Locale Identifiers”

  • “Part <number> Section <id> <title>”, e.g. “Part 6 Section 2.1.1 Subdivision Containment”

  • “Part <number>: <part title>: Section <id> <title>”, e.g. “Part 6: Supplemental: Section 2.4.1 Preferred Units for Specific Usages”

  • “Part <number> <part title>, Section <id>, <title>”, e.g. “Part 2 General, Section 3, Character Elements”

  • “Part <number> <part title>, Section <id>, <title>”, e.g. “Part 2 General, Section 3.3, Index Labels”

  • “Part <number> <part title>, section <id> <title>”, e.g. “Part 4 Dates, section 4.4 Time Data”

  • “Part <number> <part title>, Section <id> <title>”, e.g. “Part 2 General, Section 10.1 Inheritance”

I prefer the last of these, and will be adopting it in ECMA-402 until specific guidance is documented here (which would be much appreciated).

P.S. Any fix for this should also make linking more consistent, ideally always present and covering the full reference rather than e.g. <strong>Part 3: <a href="https://unicode.org/reports/tr35/tr35-numbers.html#Contents">Numbers</a></strong>, Section 2 <a href="https://unicode.org/reports/tr35/tr35-numbers.html#Number_Elements">Number Elements</a>.

Activity

Mark Davis 
October 2, 2024 at 9:46 PM

Discussed in TC, appeared to be rough consensus to remove the “Part X” if we make sure the section titles are unique.

is there a way to easily extract all the HTML anchors and links from the LDML parts?

Mark Davis 
September 30, 2024 at 12:32 AM

Adding to Design WG agenda

Richard Gibson 
August 18, 2023 at 4:22 PM

“Section <Title>” without an intervening number strikes me as potentially confusing (e.g., “Part 2 General, Section Inheritance” reads like a reference to text describing inheritance of sections rather than to the section titled “Inheritance”). Absent the number, I think “Section” should also be dropped:

See Part 2 General, Inheritance.

Mark Davis 
August 17, 2023 at 11:54 PM

Richard, since we’ve dropped section numbers, would you favor:

Part 2 General, Section Inheritance

(and the link covering all of it?)

Steven R. Loomis 
May 22, 2023 at 7:37 PM

correct the part number is the same.

Furthermore we now have Machinery that verified that we don’t drop any section anchors

Details

Priority

Assignee

Reporter

Fix versions

Components

Sprint

Created December 19, 2022 at 12:13 AM
Updated March 1, 2025 at 11:33 PM