-
Notifications
You must be signed in to change notification settings - Fork 4
Description
Problem
Internal link definitions point to anchors that don't exist in the files, causing broken cross-references. These appear to be cross-file references that were incorrectly defined as internal references.
Affected Files and Broken References
temp.md (3 broken references)
1. term.incomplete.type (lines 7757, used at lines 951, 4949)
- Defined as:
[term.incomplete.type]: #term.incomplete.type - But anchor
<a id="term.incomplete.type">does NOT exist in temp.md - Should likely point to intro.md or basic.md
2. term.odr.use (line 7758, used at lines 5058, 7795)
- Defined as:
[term.odr.use]: #term.odr.use - But anchor
<a id="term.odr.use">does NOT exist in temp.md - Should likely point to basic.md
3. implimits (line 7690, used at line 5214)
- Defined as:
[implimits]: #implimits - But anchor
<a id="implimits">does NOT exist in temp.md - Should point to implementation limits section (likely support.md or intro.md)
strings.md (4 broken references)
1. char.traits.req (line 4063, used at line 41)
- Defined as:
[char.traits.req]: #char.traits.req - But the actual anchor in strings.md is:
<a id="char.traits.require">(line 39) - Mismatch:
.reqvs.require
2. string.view.compare (line 4093, used at line 819)
- Defined as:
[string.view.compare]: #string.view.compare - But anchor
<a id="string.view.compare">does NOT exist in strings.md - Section may have different name or be in different file
3. string.view.comparison.overloads (line 4094, used at line 1051)
- Defined as:
[string.view.comparison.overloads]: #string.view.comparison.overloads - But anchor does NOT exist in strings.md
4. strings.summary (line 4096, used at line 12)
- Defined as:
[strings.summary]: #strings.summary - But anchor does NOT exist in strings.md
- Should likely be in a different file or different section name
Impact
Major - Broken internal links make navigation difficult. Users clicking these references will get "not found" errors or jump to wrong locations. This affects usability significantly.
Fix Required
-
For temp.md: Update link definitions to point to correct files:
[term.incomplete.type]: basic.md#term.incomplete.type[term.odr.use]: basic.md#term.odr.use[implimits]: support.md#implimits(or wherever it actually is)
-
For strings.md:
- Fix
char.traits.req→char.traits.require - Identify correct file/anchor for
string.view.compare - Identify correct file/anchor for
string.view.comparison.overloads - Identify correct file/anchor for
strings.summary
- Fix
This likely requires improvements to label_indexer.py to properly track which file defines each label.