summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authork8s-ci-robot <k8s-ci-robot@users.noreply.github.com>2018-06-08 14:36:58 -0700
committerGitHub <noreply@github.com>2018-06-08 14:36:58 -0700
commitae96a02466c121a375ea5fc7ee8ddd8ac8e41482 (patch)
tree7982986e35eb85a6a1f8dc0a31bfdc65b1b1452f
parent7a5847556c75d44ac36c81d27a88814c729d2c87 (diff)
parente886303310e362d8e062ccddd6adb89a0e745c1a (diff)
Merge pull request #2235 from lavalamp/api-conv
Proto is our default storage serialization; we can't break it
-rw-r--r--contributors/devel/api-conventions.md4
1 files changed, 3 insertions, 1 deletions
diff --git a/contributors/devel/api-conventions.md b/contributors/devel/api-conventions.md
index 0243dbd8..7a614fff 100644
--- a/contributors/devel/api-conventions.md
+++ b/contributors/devel/api-conventions.md
@@ -742,7 +742,9 @@ APIs may return alternative representations of any resource in response to an
Accept header or under alternative endpoints, but the default serialization for
input and output of API responses MUST be JSON.
-Protobuf serialization of API objects are currently **EXPERIMENTAL** and will change without notice.
+A protobuf encoding is also accepted for built-in resources. As proto is not
+self-describing, there is an envelope wrapper which describes the type of
+the contents.
All dates should be serialized as RFC3339 strings.