diff options
| -rw-r--r-- | contributors/devel/sig-architecture/api-conventions.md | 9 |
1 files changed, 6 insertions, 3 deletions
diff --git a/contributors/devel/sig-architecture/api-conventions.md b/contributors/devel/sig-architecture/api-conventions.md index 7be33259..68f304c9 100644 --- a/contributors/devel/sig-architecture/api-conventions.md +++ b/contributors/devel/sig-architecture/api-conventions.md @@ -491,9 +491,12 @@ particularly in an edge-based manner. #### Lists of named subobjects preferred over maps -Discussed in [#2004](http://issue.k8s.io/2004) and elsewhere. There are no maps -of subobjects in any API objects. Instead, the convention is to use a list of -subobjects containing name fields. +Discussed in [#2004](http://issue.k8s.io/2004) and elsewhere. There are +no maps of subobjects in any API objects. Instead, the convention is to +use a list of subobjects containing name fields. These conventions, and +how one can change the semantics of lists, structs and maps are +described in more details in the Kubernetes +[documentation](https://kubernetes.io/docs/reference/using-api/server-side-apply/#merge-strategy). For example: |