[docs] Fix broken Towards Data Science links#57191
Conversation
There was a problem hiding this comment.
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.
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>
152abd2 to
71d73de
Compare
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>
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>
|
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. |
## 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>
## 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>
## 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>
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.pydue to rate limiting, allowing broken links to accumulate undetected.Changes
doc/source/tune/index.rst:277doc/source/ray-overview/getting-started.md:779Original (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: