docs(antora): fix version-currency + broken links across all pages#758
Merged
Conversation
Audited every Antora page (50 .adoc) for version-currency and link validity. Version-currency — dependency snippets bumped to the current release 0.32.1: - skainet-bom: io-readers, minerva-export, image-data-getting-started, java-getting-started - Maven version: java-getting-started (<skainet.version>), java-model-training (<version>) - (Historical "introduced in 0.21/0.22" etc. left as-is.) Links — all xref/image/include targets already resolve; fixed broken `link:`/macros: - README-port `.md` link: -> Antora xref: (java-getting-started, java-model-training) - hlo-getting-started: `link:./OPTIMIZATION.md` + `link:./examples/hlo/` -> GitHub URLs; dead `docs.skainet.sk/hlo/` -> xref:reference/api.adoc; tensorflow.org/xla -> openxla.org - dtype-model: dead repo-root `rfc.md` refs -> the tracking issue #615 - benchmarks: dropped dead `bench-prd.md` PRD link (+ unused :url-prd:); fixed `ainet-sk/SKaiNET` -> `SKaiNET-developers/SKaiNET` in the runner-register example Not touched (generated, "do not edit by hand"): ops-status-matrix / operators/generated (stamped 0.27.0) and kernel-support-matrix (0.31.2) — these refresh via `./gradlew generateOperatorDocs generateKernelMatrix` after a build regenerates their source JSON; that's a release-pipeline step, flagged separately. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
📖 Documentation Preview The documentation has been built successfully for this PR. Generated Files:
Artifacts:
This comment will be updated automatically when the PR is updated. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Audited every Antora page (50
.adocacross ROOT + skeep) for version-currency and link validity.Version-currency
Bumped dependency snippets to the current release 0.32.1 (BOM + Maven version) in
io-readers,minerva-export,image-data-getting-started,java-getting-started(×2),java-model-training. Left historical "introduced in 0.21/0.22" references intact.Links
All
xref:/image::/include::targets already resolve (0 broken). Fixed brokenlink:/macros — mostly README-port artifacts:.mdlink:→ Antoraxref:(java tutorials cross-links)link:./OPTIMIZATION.md,link:./examples/hlo/→ GitHub blob/tree URLsdocs.skainet.sk/hlo/→xref:reference/api.adoctensorflow.org/xla(moved) →openxla.org/xlarfc.md→ the tracking issue RFC: Hybrid adaptive DSL with optional dtype constraints — easy-wins implementation #615bench-prd.mdPRD link; fixedainet-sk/SKaiNET→SKaiNET-developers/SKaiNETin the runner exampleFlagged, not touched
The generated docs are stamped at old versions —
ops-status-matrix+operators/generated/*(0.27.0) andkernel-support-matrix(0.31.2). They're marked "do not edit by hand"; refresh via./gradlew generateOperatorDocs generateKernelMatrixonce a build regenerates their source JSON (a release-pipeline step).🤖 Generated with Claude Code