Skip to content

GH-51148: [Docs] Repoint three dead links - #51149

Merged
thisisnic merged 1 commit into
apache:mainfrom
rawsun007:fix-dead-doc-links
Sep 3, 2026
Merged

thisisnic merged 1 commit into
apache:mainfrom
rawsun007:fix-dead-doc-links

Conversation

@rawsun007

@rawsun007 rawsun007 commented Sep 3, 2026 •

Copy link
Copy Markdown
Contributor

Rationale for this change

Three links in the docs return 404. Each one is the reference target for advice the page is giving, so following it leaves the reader with nothing:

  • the checkstyle config a Java contributor is told to follow,
  • the conda install guide in the Crossbow setup instructions,
  • the ROCm reference in the C device data interface spec.

What changes are included in this PR?

Three URL strings.

  • developers/java/development.rst: apache/arrow/blob/main/java/dev/checkstyle/checkstyle.xml becomes apache/arrow-java/blob/main/dev/checkstyle/checkstyle.xml. The file moved with the Java split and the java/ path segment went with it; it is 10,851 bytes on arrow-java@main. This was the last remaining apache/arrow/.../java/... link under docs/source.
  • developers/continuous_integration/crossbow.rst: conda.io/docs/user-guide/install/index.html becomes docs.conda.io/projects/conda/en/latest/user-guide/install/index.html.
  • format/CDeviceDataInterface.rst: the _ROCm: target becomes amd.com/en/products/software/rocm.html, since AMD retired en/graphics/servers-solutions-rocm.

Are these changes tested?

Not by the test suite; nothing outside docs/source changed and no code is touched. Each old URL was requested and returns 404, each new one returns 200, and the two GitHub paths were checked through the contents API rather than the HTML pages, because github.com rate-limits a bulk sweep and a 429 is indistinguishable from a 404. I did not build the docs locally.

Are there any user-facing changes?

Documentation only. Three links that were broken now resolve.

Disclosure: prepared with AI assistance (Claude, via Claude Code), per the AI-generated Code Guidance in the contributing overview. I reviewed the diff; it introduces no third-party material.

- developers/java/development.rst: the checkstyle config moved to
  apache/arrow-java with the Java split, dropping the java/ path segment.
- developers/continuous_integration/crossbow.rst: the conda install guide is
  on docs.conda.io, not conda.io/docs.
- format/CDeviceDataInterface.rst: AMD retired the servers-solutions-rocm URL.

Generated-by: Claude (Claude Code)
@rawsun007
rawsun007 requested a review from pitrou as a code owner September 3, 2026 04:05
@github-actions

github-actions Bot commented Sep 3, 2026

Copy link
Copy Markdown

⚠️ GitHub issue #51148 has been automatically assigned in GitHub to PR creator.

@thisisnic thisisnic left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks very much for fixing this @rawsun007 !

@thisisnic
thisisnic merged commit 8eadad7 into apache:main Sep 3, 2026
31 of 32 checks passed
@thisisnic thisisnic removed the awaiting review Awaiting review label Sep 3, 2026
@github-actions github-actions Bot added the awaiting merge Awaiting merge label Sep 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants