https://pantsbuild.org/ logo
#development
Title
# development
h

happy-kitchen-89482

04/22/2022, 9:59 AM
The version selection dropdown in the docs has become unwieldy, so I'll hide (but not delete) some of those versions. Can always restore them if people prefer.
👍 1
Screen Shot 2022-04-22 at 5.58.11 AM.png
After:
Screen Shot 2022-04-22 at 6.01.06 AM.png
We should probably also deprecate 2.7
👍 1
c

curved-television-6568

04/22/2022, 10:09 AM
There’s no policy in place that “automatically” deprecates x stable releases older than the current stable?
Also, what are the implications of deprecating a release, besides that pill in the docs menu?
h

happy-kitchen-89482

04/22/2022, 1:33 PM
Basically just that 🙂
👍 1
It informally communicates that we don't backport bugfixes I guess
😁 2
w

witty-crayon-22786

04/22/2022, 4:07 PM
oh! how did you do that? i had looked before but not seen it
hm: note that the most obvious way to potentially do this breaks old links…
h

happy-kitchen-89482

04/22/2022, 4:43 PM
There's a config option to hide versions
Does that also hide all the pages for that version?
w

witty-crayon-22786

04/22/2022, 4:43 PM
last i checked it made the URLs inaccessible
h

happy-kitchen-89482

04/22/2022, 4:44 PM
I mean we break default-version links all the time, but breaking version-specific links isn't great
w

witty-crayon-22786

04/22/2022, 4:44 PM
right. because we pin them in older versions.
h

happy-kitchen-89482

04/22/2022, 4:44 PM
We can file that with readme.com as feature request
Hide from the menu but don't hide the underlying links
👍 2
h

hundreds-father-404

04/22/2022, 4:48 PM
In the meantime, should we revert this change? (I think it's safe to still use for the V1 versions because I don't think we had that doc URL helper function yet.)
w

witty-crayon-22786

04/22/2022, 5:04 PM
yea, i think so. if you’re logged out and/or in a private window, hidden versions are 404s
1
(last i checked)
h

happy-kitchen-89482

04/22/2022, 5:14 PM
Realistically though, we can't maintain old docs versions in perpetuity
w

witty-crayon-22786

04/22/2022, 5:14 PM
why not?
(aside from the dropdown)
h

happy-kitchen-89482

04/22/2022, 5:15 PM
The dropdown is mostly what I meant
w

witty-crayon-22786

04/22/2022, 5:16 PM
sure: agree on filing a bug there.
h

happy-kitchen-89482

04/22/2022, 5:16 PM
We can leave old docs lying around to not break links but I'm not sure we're required to
w

witty-crayon-22786

04/22/2022, 5:17 PM
imo, it’s the least we can do to not abandon folks who fall behind. particularly since we suggest upgrading through each version
1
h

hundreds-father-404

04/22/2022, 5:18 PM
I strongly agree with Stu. It makes sense to hide from the drop-down, but I think it is important when you change the URL to 2.2 etc that things work like normal
w

wide-midnight-78598

04/22/2022, 6:29 PM
While that menu is being worked on, I have a slight request - can it be made to be descending, rather than asc? Mitigates the problem of having too many old docs cluttering up, as I'd wager new or active Pants users are somewhat up-to-date, so would always be near the top of the dropdown Edit: I say this as someone who has projects on 3 recent-ish versions of Pants, so I'm being completely selfish 😈
1
h

happy-kitchen-89482

04/22/2022, 7:45 PM
I don't think we have control over that unfortunately
😢 1