search

aip-dev / google.aip.dev

API Improvement Proposals. https://aip.dev/
Other
1.1k stars 501 forks source link

google.aip.dev/181 - Google Cloud no longer uses Alpha and Beta, instead they use Private Preview and Public Preview #1042

Open rachelsaunders opened 1 year ago

rachelsaunders commented 1 year ago

There's a note at the top of the page for https://google.aip.dev/181 about how the guidelines in https://google.aip.dev/181 relate to the guidelines for Google Cloud.

Google Cloud no longer uses the terms "alpha" and "beta". Instead they use "private preview" and "public preview". See https://cloud.google.com/products#section-23

Also, as an aside, "GCP" is no longer how Google Cloud refers to itself. We should change all instances of GCP to Google Cloud :-)

toumorokoshi commented 1 year ago

Thanks! This might be a good one for @jskeet to weigh in on - he's been discussing versioning quite a bit recently.

jskeet commented 1 year ago

TL;DR: There's one sentence I'd be happy to change right away. Everything else seems very fluid, and I don't know what we should do.

Hmm. I'm reluctant to go too far at the moment, given that the preview story isn't really "there" at the moment, and there are other versioning discussions which might change AIP-181 as well (very significantly).

We could definitely change "These stability levels roughly correspond to the product launch stages (alpha, beta, GA) in Google Cloud, but are not identical." to "These stability levels roughly correspond to the product launch stages (private preview, public preview, GA) in Google Cloud, but are not identical."

Would that be enough of a change for now with an expectation that this AIP will change further in the next six months?

There's an interesting question about how Google-specific these AIPs might be, too... there's an argument to be made that the AIP will still be correct (modulo the note mentioned above) in terms of the concepts of alpha/beta/stable, but how that's expressed may change significantly.