summaryrefslogtreecommitdiff
path: root/contributors
diff options
context:
space:
mode:
authorpospispa <ppospisi@redhat.com>2017-10-12 19:03:33 +0200
committerpospispa <ppospisi@redhat.com>2017-10-12 19:03:33 +0200
commit1cd86bd62678ab9c276cc44bf03be2e532ef0099 (patch)
tree66a3fd78787914285f49ead625898a5421aeddf7 /contributors
parent65ef42fe656698027d023b53a0225176c86533f1 (diff)
Update deletionTimestamp with information about finalizer effect.
Diffstat (limited to 'contributors')
-rw-r--r--contributors/devel/api-conventions.md9
1 files changed, 6 insertions, 3 deletions
diff --git a/contributors/devel/api-conventions.md b/contributors/devel/api-conventions.md
index a29fd9f0..c69617c1 100644
--- a/contributors/devel/api-conventions.md
+++ b/contributors/devel/api-conventions.md
@@ -225,9 +225,12 @@ an object was created
after which this resource will be deleted. This field is set by the server when
a graceful deletion is requested by the user, and is not directly settable by a
client. The resource will be deleted (no longer visible from resource lists, and
-not reachable by name) after the time in this field. Once set, this value may
-not be unset or be set further into the future, although it may be shortened or
-the resource may be deleted prior to this time.
+not reachable by name) after the time in this field except when the object has
+a finalizer set. In case the finalizer is set the deletion of the object is
+postponed at least until the finalizer is removed.
+Once the deletionTimestamp is set, this value may not be unset or be set further
+into the future, although it may be shortened or the resource may be deleted
+prior to this time.
* labels: a map of string keys and values that can be used to organize and
categorize objects (see [the labels docs](https://kubernetes.io/docs/user-guide/labels/))
* annotations: a map of string keys and values that can be used by external