Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Rename "/legacy" url to something else #2285
Original concern and Donald's reply below:
FWIW, something like "/api/v1" seems reasonable. I do think "/legacy" is confusing and renaming it now will be less confusing than keeping it.
referenced this issue
Jan 4, 2018
@rsyring Thank you very much for suggesting this, and sorry for the slow response! I brought this issue up in a meeting of Warehouse developers today I want to walk you (and other Python developers reading this in the future) through what Warehouse's maintainers currently think about this question.
(For context: the folks working on Warehouse have gotten limited funding to concentrate on improving and deploying Warehouse, and have kicked off work towards our development roadmap -- the most urgent task is to improve Warehouse to the point where we can redirect pypi.python.org to pypi.org so the site is more sustainable and reliable.)
When I put this item on the meeting agenda, I was initially thinking: yes, it's currently a confusing URL, and as long as we're trying to get a lot of package maintainers to change their workflows, we should do this and coordinate with the distribution tools/docs folks so it changes everywhere at once.
As we were talking today, two counterarguments came up.
So this needs further thought. And since this issue isn't a blocker to shutting down the old site, I've moved it to a future milestone.
Thanks and sorry again for the wait.
FWIW, I added an explanation of the
Note that our main recommendation is to upgrade
So while we could add the
pypa/python-packaging-user-guide#479 highlights a remaining case where the
That currently looks like:
I think part of the problem in that case is that the phrasing of the legacy URL explanation at https://packaging.python.org/guides/using-testpypi/#using-test-pypi is confusing, but I also think it would likely be clearer with
Alternatively, we could stick an