Skip to content

[docs] Fix broken Towards Data Science links#57191

Merged
matthewdeng merged 3 commits into
ray-project:masterfrom
thc1006:fix/broken-tds-links-issue-57187
Oct 4, 2025
Merged

[docs] Fix broken Towards Data Science links#57191
matthewdeng merged 3 commits into
ray-project:masterfrom
thc1006:fix/broken-tds-links-issue-57187

Conversation

@thc1006

@thc1006 thc1006 commented Oct 4, 2025

Copy link
Copy Markdown
Contributor

Summary

This PR fixes broken links to Towards Data Science (TDS) articles that are now inaccessible. The articles have been republished on Medium's TDS Archive publication and links have been updated accordingly.

Problem

During investigation of #57187, discovered that Ray documentation contains broken TDS links that redirect to homepage or return 404 errors. Root cause: TDS links are excluded from automated linkcheck in doc/source/conf.py due to rate limiting, allowing broken links to accumulate undetected.

Changes

  • Updated Ray Tune blog link in doc/source/tune/index.rst:277
  • Updated Ray Tune blog link in doc/source/ray-overview/getting-started.md:779

Original (broken): https://towardsdatascience.com/fast-hyperparameter-tuning-at-scale-d428223b081c
Replacement (working): https://medium.com/data-science/fast-hyperparameter-tuning-at-scale-d428223b081c

Article: "Ray Tune: a Python library for fast hyperparameter tuning at any scale"
Author: Richard Liaw
Status: Verified accessible (HTTP 200)

Testing

Manually verified replacement URLs return HTTP 200 and contain correct content.

Related Issues

Related to #57187 (broken link in external Anyscale blog)

Notes

Note that the primary issue in #57187 is in an external Anyscale blog post (not under Ray project control). That link should be updated separately by the Anyscale team:

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Code Review

This pull request addresses broken links to a 'Towards Data Science' article by updating them to a new location. The changes are correct in fixing the immediate issue. My review suggests using a more canonical and stable link from the Anyscale blog, as the proposed Medium link currently redirects to a third-party aggregator site. This will improve the long-term stability of the documentation links. The investigation into the root cause of broken links not being detected by the link checker is also a valuable contribution.

Comment thread doc/source/ray-overview/getting-started.md
Comment thread doc/source/tune/index.rst Outdated
This PR fixes broken links to Towards Data Science (TDS) articles that
are now inaccessible (404 or redirecting to homepage). The articles have
been republished on Medium's TDS Archive publication.

Changes:
- Updated Ray Tune blog link in doc/source/tune/index.rst
- Updated Ray Tune blog link in doc/source/ray-overview/getting-started.md

Original (broken): https://towardsdatascience.com/fast-hyperparameter-tuning-at-scale-d428223b081c
Replacement (working): https://medium.com/data-science/fast-hyperparameter-tuning-at-scale-d428223b081c

Article: "Ray Tune: a Python library for fast hyperparameter tuning at any scale"
Author: Richard Liaw
Status: Verified accessible (HTTP 200)

Related to ray-project#57187

Signed-off-by: thc1006 <84045975+thc1006@users.noreply.github.com>
@thc1006 thc1006 force-pushed the fix/broken-tds-links-issue-57187 branch from 152abd2 to 71d73de Compare October 4, 2025 16:53
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Signed-off-by: 蔡秀吉 <84045975+thc1006@users.noreply.github.com>
cursor[bot]

This comment was marked as outdated.

The previous commit changed the link to Anyscale blog, but we prefer
to use the Medium/TDS Archive link which is more stable and accessible.

Changed back from:
https://www.anyscale.com/blog/ray-tune-a-python-library-for-fast-hyperparameter-tuning-at-any-scale

To:
https://medium.com/data-science/fast-hyperparameter-tuning-at-scale-d428223b081c

Both links are accessible, but Medium link is preferred for consistency
with other documentation references.

Signed-off-by: thc1006 <84045975+thc1006@users.noreply.github.com>

@matthewdeng matthewdeng left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

thanks!

@matthewdeng matthewdeng enabled auto-merge (squash) October 4, 2025 17:03
@github-actions github-actions Bot added the go add ONLY when ready to merge, run all tests label Oct 4, 2025
@thc1006

thc1006 commented Oct 4, 2025

Copy link
Copy Markdown
Contributor Author

The Anyscale blog link is broken and returns a 307 redirect to the blog homepage, indicating that the article has been removed or the URL has changed.

The Medium link is fully functional, returning a 200 and accessing the article content normally.

@matthewdeng matthewdeng merged commit 61b9ed6 into ray-project:master Oct 4, 2025
7 of 8 checks passed
dstrodtman pushed a commit to dstrodtman/ray that referenced this pull request Oct 6, 2025
## Summary

This PR fixes broken links to Towards Data Science (TDS) articles that
are now inaccessible. The articles have been republished on Medium's TDS
Archive publication and links have been updated accordingly.

## Problem

During investigation of ray-project#57187, discovered that Ray documentation
contains broken TDS links that redirect to homepage or return 404
errors. Root cause: TDS links are excluded from automated linkcheck in
`doc/source/conf.py` due to rate limiting, allowing broken links to
accumulate undetected.

## Changes

- Updated Ray Tune blog link in `doc/source/tune/index.rst:277`
- Updated Ray Tune blog link in
`doc/source/ray-overview/getting-started.md:779`

**Original (broken):**
https://towardsdatascience.com/fast-hyperparameter-tuning-at-scale-d428223b081c
**Replacement (working):**
https://medium.com/data-science/fast-hyperparameter-tuning-at-scale-d428223b081c

**Article:** "Ray Tune: a Python library for fast hyperparameter tuning
at any scale"
**Author:** Richard Liaw
**Status:** Verified accessible (HTTP 200)

## Testing

Manually verified replacement URLs return HTTP 200 and contain correct
content.

## Related Issues

Related to ray-project#57187 (broken link in external Anyscale blog)

## Notes

Note that the primary issue in ray-project#57187 is in an external Anyscale blog
post (not under Ray project control). That link should be updated
separately by the Anyscale team:
- Broken:
https://towardsdatascience.com/how-to-scale-python-on-every-major-cloud-provider-5e5df3e88274
- Working:
https://medium.com/distributed-computing-with-ray/how-to-scale-python-on-every-major-cloud-provider-12b3bde01208

---------

Signed-off-by: thc1006 <84045975+thc1006@users.noreply.github.com>
Signed-off-by: 蔡秀吉 <84045975+thc1006@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Signed-off-by: Douglas Strodtman <douglas@anyscale.com>
landscapepainter pushed a commit to landscapepainter/ray that referenced this pull request Nov 17, 2025
## Summary

This PR fixes broken links to Towards Data Science (TDS) articles that
are now inaccessible. The articles have been republished on Medium's TDS
Archive publication and links have been updated accordingly.

## Problem

During investigation of ray-project#57187, discovered that Ray documentation
contains broken TDS links that redirect to homepage or return 404
errors. Root cause: TDS links are excluded from automated linkcheck in
`doc/source/conf.py` due to rate limiting, allowing broken links to
accumulate undetected.

## Changes

- Updated Ray Tune blog link in `doc/source/tune/index.rst:277`
- Updated Ray Tune blog link in
`doc/source/ray-overview/getting-started.md:779`

**Original (broken):**
https://towardsdatascience.com/fast-hyperparameter-tuning-at-scale-d428223b081c
**Replacement (working):**
https://medium.com/data-science/fast-hyperparameter-tuning-at-scale-d428223b081c

**Article:** "Ray Tune: a Python library for fast hyperparameter tuning
at any scale"
**Author:** Richard Liaw  
**Status:** Verified accessible (HTTP 200)

## Testing

Manually verified replacement URLs return HTTP 200 and contain correct
content.

## Related Issues

Related to ray-project#57187 (broken link in external Anyscale blog)

## Notes

Note that the primary issue in ray-project#57187 is in an external Anyscale blog
post (not under Ray project control). That link should be updated
separately by the Anyscale team:
- Broken:
https://towardsdatascience.com/how-to-scale-python-on-every-major-cloud-provider-5e5df3e88274
- Working:
https://medium.com/distributed-computing-with-ray/how-to-scale-python-on-every-major-cloud-provider-12b3bde01208

---------

Signed-off-by: thc1006 <84045975+thc1006@users.noreply.github.com>
Signed-off-by: 蔡秀吉 <84045975+thc1006@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Future-Outlier pushed a commit to Future-Outlier/ray that referenced this pull request Dec 7, 2025
## Summary

This PR fixes broken links to Towards Data Science (TDS) articles that
are now inaccessible. The articles have been republished on Medium's TDS
Archive publication and links have been updated accordingly.

## Problem

During investigation of ray-project#57187, discovered that Ray documentation
contains broken TDS links that redirect to homepage or return 404
errors. Root cause: TDS links are excluded from automated linkcheck in
`doc/source/conf.py` due to rate limiting, allowing broken links to
accumulate undetected.

## Changes

- Updated Ray Tune blog link in `doc/source/tune/index.rst:277`
- Updated Ray Tune blog link in
`doc/source/ray-overview/getting-started.md:779`

**Original (broken):**
https://towardsdatascience.com/fast-hyperparameter-tuning-at-scale-d428223b081c
**Replacement (working):**
https://medium.com/data-science/fast-hyperparameter-tuning-at-scale-d428223b081c

**Article:** "Ray Tune: a Python library for fast hyperparameter tuning
at any scale"
**Author:** Richard Liaw
**Status:** Verified accessible (HTTP 200)

## Testing

Manually verified replacement URLs return HTTP 200 and contain correct
content.

## Related Issues

Related to ray-project#57187 (broken link in external Anyscale blog)

## Notes

Note that the primary issue in ray-project#57187 is in an external Anyscale blog
post (not under Ray project control). That link should be updated
separately by the Anyscale team:
- Broken:
https://towardsdatascience.com/how-to-scale-python-on-every-major-cloud-provider-5e5df3e88274
- Working:
https://medium.com/distributed-computing-with-ray/how-to-scale-python-on-every-major-cloud-provider-12b3bde01208

---------

Signed-off-by: thc1006 <84045975+thc1006@users.noreply.github.com>
Signed-off-by: 蔡秀吉 <84045975+thc1006@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Signed-off-by: Future-Outlier <eric901201@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

go add ONLY when ready to merge, run all tests

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants