diff --git a/aip/general/0128.md b/aip/general/0128.md index 14baa48724..08cec99883 100644 --- a/aip/general/0128.md +++ b/aip/general/0128.md @@ -75,14 +75,13 @@ is a comprehensive reference to declarative-friendly guidance in other AIPs: - Resources **should** provide change validation: see AIP-163. - Resources **should not** implement soft-delete. If the id cannot be re-used, the resource **must** implement soft-delete and the undelete RPC: see AIP-164 - - -### Annotations - -See [AIP-148 annotations][]. +- Resources **must** include a +`map annotations` field to allow clients to store small amounts +of arbitrary data: see AIP-148 ## Changelog +- **2024-01-29**: Clarify usage of `annotations`. - **2023-07-13**: Move `annotations` from AIP-148. - **2023-06-17**: Definition of plane was removed and incorporated into AIP-111. - **2023-05-11**: Removed must on resource_id, which was upstreamed to a general diff --git a/aip/general/0148.md b/aip/general/0148.md index e75599e831..633420960c 100644 --- a/aip/general/0148.md +++ b/aip/general/0148.md @@ -116,7 +116,7 @@ field **may** be added. The `annotations` field **must** use the [Kubernetes limits][] to maintain wire compatibility, and **should** require dot-namespaced annotation keys to prevent -tools from trampling over one another. +tools from trampling over one another. [Declarative-friendly resources][] **must** include this field. Examples of information that might be valuable to store in annotations include: @@ -175,6 +175,7 @@ Before 2023-07, `purge_time` for soft-deleted resources was also called ## Changelog +- **2024-01-29**: Clarify usage of `annotations` in `Declarative-friendly resources`. - **2023-10-05**: Introduce well known string fields with IP Address and `uid`. - **2023-08-14**: Introduce the term `annotations` from AIP-128. - **2023-07-13**: Introduce the term `purge_time`. @@ -185,4 +186,4 @@ Before 2023-07, `purge_time` for soft-deleted resources was also called [aip-202]: ./0202.md [declarative-friendly resources]: ./0128.md#resources [kubernetes limits]: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/#syntax-and-character-set -[uuid4]: https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_4_(random) \ No newline at end of file +[uuid4]: https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_4_(random)