GumpacG opened a new pull request, #3704:
URL: https://github.com/apache/tinkerpop/pull/3704
## Problem
Each upgrade release-line file opens with a heading named after that line's
`.0` release, and the
release itself repeats the identical text later in the same file:
```
docs/src/upgrade/release-3.7.x.asciidoc
line 21: = TinkerPop 3.7.0 <- the whole 3.7.x series
line 1052: == TinkerPop 3.7.0 <- the 3.7.0 release
```
`llms.txt` derives both a page's title and its file name from that heading,
so 3.1 through 3.7 each
produced two entries indistinguishable by title, separated only by
Asciidoctor's duplicate-id
counter:
```
- [TinkerPop 3.7.0](upgrade/_tinkerpop_3_7_0.md): ... the TinkerPop 3.7.x
release line ...
- [TinkerPop 3.7.0](upgrade/_tinkerpop_3_7_0_2.md): ... specific to the
TinkerPop 3.7.0 release ...
```
That counter encodes document position, not content:
`_upgrading_for_providers_10` means "the 10th
heading titled Upgrading for Providers", so adding a release above it
silently repoints the URL.
## Changes
Nine lines, eight files, no code. Eight release-line headings renamed (`=
TinkerPop 3.7.0` to
`= TinkerPop 3.7.x`), which makes the text unique so Asciidoctor stops
appending a counter, plus an
explicit `[[upgrade-3.5.0-providers]]` anchor on the only `Upgrading for
...` section that becomes
its own page.
## Result
Generated `## upgrade` section, every title and URL now unique:
```
- [TinkerPop Upgrade Information](upgrade/index.md): Version-by-version
upgrade notes for Apache TinkerPop, covering breaking changes, new features,
and migration guidance for each release line from 3.0 onward.
- [TinkerPop 3.0.x](upgrade/_tinkerpop_3_0_x.md): Upgrade notes for the
TinkerPop 3.0.x release line: the initial 3.x releases, their features, and
migration guidance.
- [TinkerPop 3.1.x](upgrade/_tinkerpop_3_1_x.md): Upgrade notes for the
TinkerPop 3.1.x release line: breaking changes, new features, and provider
migration guidance across its releases.
- [TinkerPop 3.2.0](upgrade/_tinkerpop_3_2_0.md): Upgrade notes specific to
the TinkerPop 3.2.0 release: its breaking changes, new features, and changelog.
- [TinkerPop 3.2.3](upgrade/_tinkerpop_3_2_3.md): Upgrade notes specific to
the TinkerPop 3.2.3 release: its changes and changelog.
- [TinkerPop 3.2.x](upgrade/_tinkerpop_3_2_x.md): Upgrade notes for the
TinkerPop 3.2.x release line: breaking changes, new features, and provider
migration guidance across its releases.
- [TinkerPop 3.3.0](upgrade/_tinkerpop_3_3_0.md): Upgrade notes specific to
the TinkerPop 3.3.0 release: its breaking changes, new features, and changelog.
- [TinkerPop 3.3.x](upgrade/_tinkerpop_3_3_x.md): Upgrade notes for the
TinkerPop 3.3.x release line: breaking changes, new features, and provider
migration guidance across its releases.
- [TinkerPop 3.4.0](upgrade/_tinkerpop_3_4_0.md): Upgrade notes specific to
the TinkerPop 3.4.0 release: its breaking changes, new features, and changelog.
- [TinkerPop 3.4.x](upgrade/_tinkerpop_3_4_x.md): Upgrade notes for the
TinkerPop 3.4.x release line: breaking changes, new features, and provider
migration guidance across its releases.
- [TinkerPop 3.5.0](upgrade/_tinkerpop_3_5_0.md): Upgrade notes specific to
the TinkerPop 3.5.0 release: its breaking changes, new features, and changelog.
- [TinkerPop 3.5.x](upgrade/_tinkerpop_3_5_x.md): Upgrade notes for the
TinkerPop 3.5.x release line: breaking changes, new features, and provider
migration guidance across its releases.
- [TinkerPop 3.6.x](upgrade/_tinkerpop_3_6_x.md): Upgrade notes for the
TinkerPop 3.6.x release line: breaking changes, new features, and provider
migration guidance across its releases.
- [TinkerPop 3.7.0](upgrade/_tinkerpop_3_7_0.md): Upgrade notes specific to
the TinkerPop 3.7.0 release: its breaking changes, new features, and changelog.
- [TinkerPop 3.7.x](upgrade/_tinkerpop_3_7_x.md): Upgrade notes for the
TinkerPop 3.7.x release line: breaking changes, new features, and provider
migration guidance across its releases.
- [Upgrading for Providers](upgrade/upgrade-3.5.0-providers.md):
Provider-facing upgrade notes for TinkerPop 3.5.0: changes graph system and
driver providers must account for, including server authorization and strategy
changes.
```
Assisted-by: Kiro:claude-opus-5
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
