-
Notifications
You must be signed in to change notification settings - Fork 3.1k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Enable managing RTD redirects in-tree #11652
Conversation
a186f60
to
e68f016
Compare
e68f016
to
7a2290d
Compare
This is designed as a script and a data file (in YAML format), and meant to manage the RTD redirects with a version controlled file. This makes it possible for pull requests to this repository to update the redirects for this project's documentation (eg: for better error urls) and for this evolution to be tracked as a part of version control history.
This makes it possible for pip's documentation's redirects to be automatically synchronised with the `main` branch.
7a2290d
to
8328135
Compare
/dev/news-entry-failure: >- | ||
https://pip.pypa.io/en/stable/development/contributing/#news-entries | ||
/errors/resolution-impossible: >- | ||
https://pip.pypa.io/en/latest/topics/dependency-resolution/#dealing-with-dependency-conflicts | ||
/surveys/backtracking: >- | ||
https://forms.gle/LkZP95S4CfqBAU1N6 | ||
/warnings/backtracking: >- | ||
https://pip.pypa.io/en/stable/topics/dependency-resolution/#possible-ways-to-reduce-backtracking |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is the stable/latest difference intended? I feel the /dev/ one should use latest, while the other two should use stable.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not really. I want us to fix these issues, but I wanted to do it separately from moving the source of truth into the repository source tree; to make sure that we make changes in a separate step from the migration to this.
I'm gonna merge this, but please holler if there's any concerns around this. :) |
Womp Womp. The one piece that I can't test locally failed (CI config). |
https://github.com/pypa/pip/actions/runs/3818209726/jobs/6494960476 has the first successful run. |
This is designed as a script and a data file (in YAML format), and meant
to manage the RTD redirects with a version controlled file.
This makes it possible for pull requests to this repository to update
the redirects for this project's documentation (eg: for better error
urls) and for this evolution to be tracked as a part of version control
history.