📖 Update in-place update implementation notes

[alexander-demicev]

What this PR does / why we need it:

This PR adds notes about KCP implementation and managed field refactoring. @sbueringer @fabriziopandini could you please verify that I didn't miss anything and got it all right, also I wasn't sure if we should move these notes into the proposal or keep them separated.

Which issue(s) this PR fixes (optional, in fixes #<issue number>(, fixes #<issue_number>, ...) format, will close the issue(s) when PR gets merged):
Fixes #

[alexander-demicev]

/area documentation

[neolit123]

thanks for the PR.
i've added some comments on grammar. note that this is not a implementation correctness pass.

Q: i know that the CAPI book has a lot of details, but this seems like it's going trough the controller source code and covering everything. is the average reader that interested in documentation verbosity ALA "i what to know exactly how this works"? for comparison, the k8s documentation doesn't do that.

[fabriziopandini]

great work!
lgtm pending comment above

[alexander-demicev]

@neolit123 Hey, I addressed your comments. A follow-up PR will be made to update the proposal and user-facing docs. These docs are for engineers working directly on the CAPI code to have a place to refer to in case knowledge transfer is needed.

[fabriziopandini]

/lgtm
/approve

[k8s-ci-robot]

LGTM label has been added.

Details

Git tree hash: 664a4048a68ed2679f0181b35d2e8507dd495823

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: fabriziopandini

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details

Needs approval from an approver in each of these files:

• OWNERS [fabriziopandini]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[fabriziopandini]

/cherry-pick release-1.12

[k8s-infra-cherrypick-robot]

@fabriziopandini: once the present PR merges, I will cherry-pick it on top of release-1.12 in a new PR and assign it to you.

Details

In response to this:

/cherry-pick release-1.12

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

[k8s-infra-cherrypick-robot]

@fabriziopandini: new pull request created: #13118

Details

In response to this:

/cherry-pick release-1.12

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.