diff options
| author | Evan Anderson <evan.k.anderson@gmail.com> | 2020-03-27 14:41:41 -0700 |
|---|---|---|
| committer | Evan Anderson <evan.k.anderson@gmail.com> | 2020-03-27 14:41:41 -0700 |
| commit | 5cab966cc53280e68213b428d1a146dc10e2b470 (patch) | |
| tree | b4156256a3b7c388f3127d7e3e2eb9741d8d385e | |
| parent | f0fdf1c9145760a246d38dfed5119a9c78b0f521 (diff) | |
Drop positive-polarity exception for Ready
| -rw-r--r-- | contributors/devel/sig-architecture/api-conventions.md | 12 |
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 |
