Skip to content
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

Merged
merged 2 commits into from
Dec 30, 2022
Merged

Conversation

pradyunsg
Copy link
Member

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.

@pradyunsg pradyunsg added the type: maintenance Related to Development and Maintenance Processes label Dec 9, 2022
@pradyunsg pradyunsg self-assigned this Dec 9, 2022
@pradyunsg pradyunsg added the skip news Does not need a NEWS file entry (eg: trivial changes) label Dec 9, 2022
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.
Comment on lines +4 to +11
/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
Copy link
Member

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.

Copy link
Member Author

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.

@pradyunsg
Copy link
Member Author

I'm gonna merge this, but please holler if there's any concerns around this. :)

@pradyunsg pradyunsg merged commit c987c68 into pypa:main Dec 30, 2022
@pradyunsg pradyunsg deleted the rtd-redirects branch December 30, 2022 23:05
@pradyunsg
Copy link
Member Author

Womp Womp. The one piece that I can't test locally failed (CI config).

@pradyunsg
Copy link
Member Author

https://github.com/pypa/pip/actions/runs/3818209726/jobs/6494960476 has the first successful run.

@github-actions github-actions bot locked as resolved and limited conversation to collaborators Jan 17, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
skip news Does not need a NEWS file entry (eg: trivial changes) type: maintenance Related to Development and Maintenance Processes
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants