Skip to content

Use intersphinx references#966

Merged
webknjaz merged 3 commits intopypa:mainfrom
dukecat0:patch-2
Aug 27, 2021
Merged

Use intersphinx references#966
webknjaz merged 3 commits intopypa:mainfrom
dukecat0:patch-2

Conversation

@dukecat0
Copy link
Copy Markdown
Member

@dukecat0 dukecat0 commented Aug 25, 2021

I ignored some links as I can't find the references for them.

@webknjaz
Copy link
Copy Markdown
Member

Have you checked intersphinx-untangled for missing references?

@dukecat0
Copy link
Copy Markdown
Member Author

dukecat0 commented Aug 25, 2021 via email

@webknjaz
Copy link
Copy Markdown
Member

Yes, I have checked. Actually, references used in the docs are found in intersphinx-untangled.

I see. So if some links aren't there, it means that the linked sites got restructured. The best way to fix this is to find new/alternative locations for the content. Because currently, they point to the wrong pages. For example, there's https://setuptools.readthedocs.io/en/latest/setuptools.html#automatic-script-creation but that page doesn't have the title "Automatic Script Creation" anymore. I think we need to integrate sphinx's linkcheck to catch such broken links early.

@webknjaz webknjaz merged commit 72c1ceb into pypa:main Aug 27, 2021
@dukecat0 dukecat0 deleted the patch-2 branch August 27, 2021 11:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants