docs: updates to managed k9s caep

The managed k8s caep has been updated to reflect the contract changes
proposed for managed k8s. The recommendations remain the same from the
original proposal.

Additionally, formatting changes have been made and some updates on the
current state of managed k8s in CAPI.

Signed-off-by: Richard Case <[email protected]>

Author: richardcase