From 3d507419a21886f6c55c1ea438dbb93431a4ea4b Mon Sep 17 00:00:00 2001 From: Xiang Li Date: Fri, 26 Feb 2016 10:04:34 -0800 Subject: [PATCH] etcdctlv3: add compatibility section --- etcdctlv3/README.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/etcdctlv3/README.md b/etcdctlv3/README.md index 89e0684e1..a88625a86 100644 --- a/etcdctlv3/README.md +++ b/etcdctlv3/README.md @@ -323,3 +323,19 @@ Simple reply [etcdrpc]: ../etcdserver/etcdserverpb/rpc.proto [storagerpc]: ../storage/storagepb/kv.proto + +## Compatibility Support + +etcdctl is still in its early stage. We try out best to ensure fully compatible releases, however we might break compatibility to fix bugs or improve commands. If we intend to release a version of etcdctl with backward incompatibilities, we will provide notice prior to release and have instructions on how to upgrade. + +### Input Compatibility + +Input includes the command name, its flags, and its arguments. We ensure backward compatibility of the input of normal commands in non-interactive mode. + +### Output Compatibility + +Output includes output from etcdctl and its exit code. etcdctl provides `simple` output format by default. +We ensure compatibility for the `simple` output format of normal commands in non-interactive mode. Currently, we do not ensure +backward compatibility for `JSON` format and the format in non-interactive mode. Currently, we do not ensure backward compatibility of utility commands. + +### TODO: compatibility with etcd server