📖 Add rebase documentation

[ncdc]

Summary

Add documentation on the rebase process.

[stevekuznetsov]

This looks like all the highlights - nice write-up!

[openshift-ci]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: stevekuznetsov

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

The pull request process is described here

Needs approval from an approver in each of these files:

• docs/OWNERS [stevekuznetsov]

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

[xrstf]

This is great and will be an amazing help in the future :-)

[waltforme]

Maybe a dumb question: Why does kcp-dev/apimachinery requires k8s.io/api? Sounds like a 'reversed' dependency? Thanks!

[stevekuznetsov]

@waltforme I don't know where the kcp-dev/apimachinery name came from in the beginning, to be honest. It's not related to k8s.io/apimachinery and untangling it might be a good use of time. The contents in the repo are related like this:

• kcp-dev/apimachinery/pkg/cache is similar to k8s.io/client-go/tools/cache
• kcp-dev/apimachinery/pkg/client is the machinery behind the cross-cluster clients generated by kcp-dev/code-generator and committed to kcp-dev/client-go

Perhaps deleting the repo and subsuming the content into the more appropriate places would be good.

[waltforme]

I see. Now the dependency makes sense. Also it explains why the repository is so small.
Maybe I should take a closer look before asking this.
Thanks for the detailed explanations! @stevekuznetsov