diff options
| author | Antoine Pelisse <apelisse@gmail.com> | 2021-04-05 15:42:41 -0700 |
|---|---|---|
| committer | Antoine Pelisse <apelisse@gmail.com> | 2021-04-05 15:42:41 -0700 |
| commit | 27e1a810294b76b80d7258ca3fe5a9096f070cf8 (patch) | |
| tree | 72a521f92c8ea57515986a30394eeaa5ed7fe2db | |
| parent | cbe877940c83a5743f4e7304ca00bad63167bd31 (diff) | |
Include documentation for listTypes in api conventions
| -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: |