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>: <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>.
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:
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>
.