Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add terminology for Declarative clients #1186

Merged
merged 5 commits into from
Aug 4, 2023

Conversation

slevenick
Copy link
Contributor

@slevenick slevenick commented Jul 24, 2023

Add terms for upcoming AIP 129

This is split from #1144 to make review easier

PR feedback, clarifications

Rework AIP 129, add accepted normalizations

Semantic string --> field values

Add naming section for effective values

Remove 129
@slevenick slevenick requested a review from a team as a code owner July 24, 2023 19:01
@noahdietz
Copy link
Collaborator

There are a few other instances of IaC elsewhere, can we update them in this PR as well? I like this name better :)

Copy link
Contributor

@toumorokoshi toumorokoshi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for breaking the PR out! a couple comments.

@@ -147,7 +151,16 @@ An API that operates across a network of computers. Network APIs communicate
using network protocols including HTTP, and are frequently produced by
organizations separate from those that consume them.

[IaC]: #iac
### Single Owner Fields
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think single-owner fields should be a glossary term. See https://github.com/aip-dev/google.aip.dev/pull/1144/files#r1272461411.

at minimum the guidance needs to be moved to an AIP that's not the glossary.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed from this PR, will add back to the 129 PR

aip/general/0009.md Outdated Show resolved Hide resolved
Copy link
Contributor

@toumorokoshi toumorokoshi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Thanks for this change.

aip/general/0009.md Outdated Show resolved Hide resolved
aip/general/0009.md Outdated Show resolved Hide resolved
aip/general/0009.md Outdated Show resolved Hide resolved
Copy link
Contributor

@bgrant0607 bgrant0607 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! LGTM

@toumorokoshi toumorokoshi changed the title Add terminology for State-Driven clients and Single Owner Fields Add terminology for Declarative clients Aug 4, 2023
@toumorokoshi toumorokoshi merged commit f420852 into aip-dev:master Aug 4, 2023
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants