istio.io icon indicating copy to clipboard operation
istio.io copied to clipboard

Add FAQ on "which api version should I use"

Open howardjohn opened this issue 1 year ago • 3 comments

See https://blog.howardjohn.info/posts/crd-versioning/

tl;dr: it usually doesn't matter as much as people think. Always use the latest if you are a user; use the oldest version you need to support for integration authors

howardjohn avatar Jun 24 '24 22:06 howardjohn

hey @howardjohn , i would like to work on this issue , since i am new to open source , can you provide me some guidance for solving this issue.

priyanshsao avatar Jun 26 '24 06:06 priyanshsao

@priyanshsao : There is already a PR up for review for this from @darshan174

kfaseela avatar Jun 26 '24 07:06 kfaseela

@priyanshsao Please see https://github.com/istio/istio.io/pull/15329#issuecomment-2191280978.

I don't actually think this is a good first issue, because you need to understand (a) something pretty complex about Kubernetes (b) how Istio implements it (c) how to explain it trivially to a new user.

I should be able to do all 3, but I suspect it will take me an hour or so of thought to get something that is well crafted.

craigbox avatar Jun 26 '24 09:06 craigbox