📖 Proposal: Improving status in CAPI resources (#10897)

* First draft

* First round of comments

* nits

Co-authored-by: Stefan Büringer [email protected]

* small improvements to the API and to replica counters transition

Co-authored-by: Stefan Büringer [email protected]

* Add changes to MachinePool resources

* Add Changes to Cluster API contract

* Add missing paragraphs from the proposal template

* More nits, feedbacks, small improvements

* More nits and cleanup

Co-authored-by: Stefan Büringer [email protected]
Co-authored-by: Christian Schlotter [email protected]

* Drop replica failure, we can surface this on scaling up

* Bubble up Machine Available instead of Machine Ready

* Clarify timeline

* Add topology reconciled condition to Cluster Availability (only for Classy Clusters)

* Clarify the definition of the `--remote-conditions-grace-period` flag

* Rollback on dropping status.phases

* Rename MachinesAvailable to MachinesReady

* More refinements to `MachinesUpToDate`, `Remediating`, `Deleting`

* Introduce nested struct to for a cleaner API surface in phase 1 and 2

* nits

* Align replica counters in control plane contract + add a note about in place updated fields

* Clarify MinReadySeconds transformation for MS, MD, MP

* fix review findings