docs(source): autogenerate docs for events

[ivankatliarchuk]

What does it do ?

Autogenerate docs for sources that do or do not support events. Added few example annotations.

Follow-up PR https://github.com/kubernetes-sigs/external-dns/pull/6099/changes#diff-11a48066892ef7176ddc61b21bcc6b421a62c745702e8b8a3948cf456daf8362

Motivation

Autogenerate docs for sources

More

• Yes, this PR title follows Conventional Commits
• Yes, I added unit tests
• Yes, I updated end user documentation accordingly

[coveralls]

Pull Request Test Coverage Report for Build 21206677659

Warning: This coverage report may be inaccurate.

This pull request's base commit is no longer the HEAD commit of its target branch. This means it includes changes from outside the original pull request, including, potentially, unrelated coverage changes.

• For more information on this, see Tracking coverage changes with pull request builds.
• To avoid this issue with future PRs, see these Recommended CI Configurations.
• For a quick fix, rebase this PR at GitHub. Your next report should be accurate.

Details

• 0 of 0 changed or added relevant lines in 0 files are covered.
• 89 unchanged lines in 8 files lost coverage.
• Overall coverage decreased (-0.06%) to 79.01%

---

Files with Coverage Reduction	New Missed Lines	%
fake.go	1	96.23%
openshift_route.go	1	84.78%
zonefinder.go	3	90.0%
controller.go	9	92.56%
crd.go	10	66.45%
ambassador_host.go	13	82.67%
gen/docs/sources/main.go	13	81.7%
ovh/ovh.go	39	91.75%

Totals
Change from base Build 21060483362:	-0.06%
Covered Lines:	16058
Relevant Lines:	20324

---

💛 - Coveralls

[vflaux]

Could you also add this in the Annotation Reference section?

[ivankatliarchuk]

Added. Will think of how to make sure docs and code is in sync for this section

[vflaux]

/lgtm

[ivankatliarchuk]

/approve

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: ivankatliarchuk

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 [ivankatliarchuk]

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