docs: fix broken external and internal links in Groovydocs#15327
docs: fix broken external and internal links in Groovydocs#15327sanjana2505006 wants to merge 1 commit intoapache:7.0.xfrom
Conversation
|
A small number of residual 'broken' links remain (approx. 30 reports). |
|
@sanjana2505006 Thank you. On this issue would it be possible to use the python scripts to identify the source of the broken link and fix them either in the javadoc/groovy doc in each .groovy or .java file and Gradle configuration for the build? This is preferable to having a script fix them each time the project is built. After that, if we still need to have a script, since our project is based on the Groovy programming language we prefer Groovy Scripts vs Python scripts. I don't think this should be need though, if we fix the root sources of the broken links. The broken references just built up over the last 20 years as the whole Java ecosystem has evolved significantly. |
596f765 to
8df9833
Compare
|
@jamesfredley Thank you for the clarification. I’ve updated the PR to align with your suggestions. I’ve also squashed everything into a single commit. The docs now build cleanly with improved link resolution using the project’s native tooling. |
|
@jamesfredley Whenever you get a chance, please review and let me know if any changes are needed |
|
Hello @jamesfredley, just a gentle follow-up on this PR. Whenever you have time, could you please share your feedback or let me know if any further changes are needed from my side? Happy to update anything required. Thank you |
8df9833 to
5f0ecad
Compare
✅ All tests passed ✅🏷️ Commit: 5f0ecad Learn more about TestLens at testlens.app. |
|
There are license failures on this branch and unnecessary formatting to |
Changes i did:
Surgical Link Correction: Modernized the
docs-dependencies.gradleresolution logic and added a professional post-processing script (
fix_groovydoc_links.py) to repair malformed relative paths for inner classes and map 20+ external API roots (Spring, Hibernate, Jakarta, GORM, etc.).Verification Tooling: Included a parallelized
check_links.pyutility for high-speed documentation validation.This PR fixes issue #14991