summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEvan Anderson <evan.k.anderson@gmail.com>2020-03-27 14:41:41 -0700
committerEvan Anderson <evan.k.anderson@gmail.com>2020-03-27 14:41:41 -0700
commit5cab966cc53280e68213b428d1a146dc10e2b470 (patch)
treeb4156256a3b7c388f3127d7e3e2eb9741d8d385e
parentf0fdf1c9145760a246d38dfed5119a9c78b0f521 (diff)
Drop positive-polarity exception for Ready
-rw-r--r--contributors/devel/sig-architecture/api-conventions.md12
1 files changed, 6 insertions, 6 deletions
diff --git a/contributors/devel/sig-architecture/api-conventions.md b/contributors/devel/sig-architecture/api-conventions.md
index 578046b5..986dfd74 100644
--- a/contributors/devel/sig-architecture/api-conventions.md
+++ b/contributors/devel/sig-architecture/api-conventions.md
@@ -391,12 +391,12 @@ we define comprehensive state machines for objects, nor behaviors associated
with state transitions. The system is level-based rather than edge-triggered,
and should assume an Open World.
-An example of an oscillating condition type is `Ready` (despite it running
-afoul of current guidance), which indicates the object was believed to be fully
-operational at the time it was last probed. A possible monotonic condition
-could be `Succeeded`. A `True` status for `Succeeded` would imply completion
-and that the resource was no longer active. An object that was still active
-would generally not have a `Succeeded` condition.
+An example of an oscillating condition type is `Ready`, which indicates the
+object was believed to be fully operational at the time it was last probed. A
+possible monotonic condition could be `Succeeded`. A `True` status for
+`Succeeded` would imply completion and that the resource was no longer
+active. An object that was still active would generally not have a `Succeeded`
+condition.
Some resources in the v1 API contain fields called **`phase`**, and associated
`message`, `reason`, and other status fields. The pattern of using `phase` is