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.

Sign up for GitHub

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

Jump to bottom

maybe redirect readme era docs/ to stable docs #318

Open

cburroughs opened this issue Feb 3, 2025 · 0 comments

Contributor

cburroughs commented Feb 3, 2025

Currently (as of #35) the old readme era urls point to 2.18 docs, which were the live version at the time of the cutover. So for example https://pantsbuild.org/docs/rules-api-concepts/ redirects to https://www.pantsbuild.org/2.18/docs/writing-plugins/the-rules-api/concepts with a "This is documentation for Pantsbuild 2.18 (deprecated), which is no longer actively maintained." banner.

Since #256 we now have semi stable docs urls, not just versioned docs. So if one clicks through the above banner one eventually taken to https://www.pantsbuild.org/stable/docs/writing-plugins/the-rules-api/concepts

Maybe we should cutout the middle and redirect https://pantsbuild.org/docs/rules-api-concepts/ to https://www.pantsbuild.org/stable/docs/writing-plugins/the-rules-api/concepts ?

Pro: This is almost certainly what people want in most cases.
Con: Eventual linkrot as doc urls change.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment