📖 docs: Add examples to all marker types.

[camilamacedo86]

Add comprehensive usage examples and improved field documentation to all marker types (validation, CRD, webhook, RBAC, topology).

Generated-by: Cursor/Claude

Closes: #1054

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: camilamacedo86
Once this PR has been reviewed and has the lgtm label, please assign joelanford for approval. For more information see the Code Review Process.

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

Details

Needs approval from an approver in each of these files:

• OWNERS

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

[camilamacedo86]

/test pull-controller-tools-test-main

[camilamacedo86]

Hi @JoelSpeed @sbueringer,

Kubebuilder generates the marker documentation automatically, but for a long time we’ve wanted to ensure we provide valid examples for all markers.

To address that, I used an AI to help draft example snippets and validate the existing docs/changes. I then manually reviewed everything that was generated/updated and didn’t spot any issues.

Could you give a hand on this to review?
Thanks! 🙌