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.

There’s no policy in place that “automatically” deprecates x stable releases older than the current stable?

Basically just that 🙂

oh! how did you do that? i had looked before but not seen it

There's a config option to hide versions

last i checked it made the URLs inaccessible

I mean we break default-version links all the time, but breaking version-specific links isn't great

right. because we pin them in older versions.

We can file that with readme.com as feature request

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.)

yea, i think so. if you’re logged out and/or in a private window, hidden versions are 404s

Realistically though, we can't maintain old docs versions in perpetuity

why not?

The dropdown is mostly what I meant

sure: agree on filing a bug there.

We can leave old docs lying around to not break links but I'm not sure we're required to

imo, it’s the least we can do to not abandon folks who fall behind. particularly since we suggest upgrading through each version

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

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 😈

I don't think we have control over that unfortunately