This message was deleted.
# k3sa
adamant-kite-43734
07/06/2022, 8:43 PMThis message was deleted.
h
hundreds-state-15112
07/06/2022, 8:45 PMSide question, I found #k3s-contributor, is that a better place for me to post these things?
c
creamy-pencil-82913
07/06/2022, 9:40 PMnah here is fine
creamy-pencil-82913
07/06/2022, 9:41 PMbut I might also note that at the moment, that feature is available on all supported versions of K3s. 1.21 has been end of support since 1.24 came out.
h
hundreds-state-15112
07/07/2022, 5:58 PMAre you saying it was back-ported at the same time it came out? I just wanted to make it clear which version introduced the feature so people could easily identify why it might not be working in previous features.
c
creamy-pencil-82913
07/07/2022, 6:04 PMno, just saying that it’s been available so long that there are no longer any supported versions where it doesn’t work
h
hundreds-state-15112
07/07/2022, 11:11 PMYeah I was thinking there might be some people who have older versions, try it, it doesn’t work and they maybe file an issue. You can reject this though if you don’t think it’ll be a problem. I also just like to know myself what version features are introduced in ¯\_(ツ)_/¯
hundreds-state-15112
07/11/2022, 5:51 PMShould I just close this then? @creamy-pencil-82913
c
creamy-pencil-82913
07/11/2022, 6:03 PM@nutritious-tomato-14686 is actually working on reorganizing the docs a bit, I think as part of that we might come out with a better convention for denoting what versions support what features
n
nutritious-tomato-14686
07/11/2022, 6:05 PMI am actually fine with this PR, I haven't yet decided/designed a better system to handle this yet.
nutritious-tomato-14686
07/11/2022, 6:07 PMI think your right Austin, when people on older versions see a feature in the docs and want to try it out, we should help them identify what minimum version they need to upgrade to.
c
creamy-pencil-82913
07/11/2022, 6:08 PMour current backport policy makes that a bit more interesting, things are now likely to be added to 3 branches at once which is a lot of visual clutter for docs.
n
nutritious-tomato-14686
07/11/2022, 6:10 PMYeah I kinda look at that as "the oldest version we support it", but that does leave gaps in the matrix, because we may introduce a feature in 1.22.9 and 1.23.2, but it wont be in 1.23.1, even though the docs say "Available as of 1.22.9+".
nutritious-tomato-14686
07/11/2022, 6:11 PMSaying "Available in 1.22.9+, 1.23.4+, 1.24.1+" is somewhat wordy, but is still short enough of a note IMO
h
hundreds-state-15112
07/11/2022, 6:14 PMOne example I think of is the way the k8s docs do it with “FEATURE STATE”. Only somewhat applicable for k3s but maybe that’s a good starting point.
hundreds-state-15112
07/11/2022, 6:15 PMI think being explicit in the versions and backporting in general is very user friendly and helps save lots of people’s time on both sides.
hundreds-state-15112
07/11/2022, 6:17 PMI don’t work with GitHub almost at all so I don’t know if there’s a way to do any kind of like, badge linking on these pages that could do some kind of dynamicish update?
hundreds-state-15112
07/11/2022, 6:18 PMI’ve also never done any kind of automatic change log generation so I’m not sure what’s possible.
hundreds-state-15112
07/11/2022, 6:21 PMAnd I’m assuming there’s a reason the k3s/rke docs aren’t versioned in the same way the Rancher Server is, which is also a kind of way this could be handled.
hundreds-state-15112
07/11/2022, 6:22 PMThis might be overkill but I like badges 😎
n
nutritious-tomato-14686
07/11/2022, 6:25 PMWe don't use Github for generating/displaying the documentation (we are moving to docusaurus for k3s) so no badges 😞
6 Views