docs(source): autogenerate docs for sources with go-doc like style

[ivankatliarchuk]

What does it do ?

Go doc style added to sources. So that it should be easier to keep documentation in sync

Follow-up:

• add annotations support, aka which source supports which annotations

follow-up

• add sources tags support in mkdocs to make it simple to find all sources related

Motivation

Documentation in sync with code. This should simplify identifying which sources supports what functionality.

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 20698076285

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.
• 540 unchanged lines in 20 files lost coverage.
• Overall coverage increased (+0.02%) to 78.818%

---

Files with Coverage Reduction	New Missed Lines	%
empty.go	2	75.0%
fake.go	2	96.23%
connector.go	3	80.0%
pod.go	9	95.14%
node.go	10	92.37%
istio_gateway.go	16	89.2%
f5_transportserver.go	17	77.42%
f5_virtualserver.go	19	79.21%
openshift_route.go	20	85.0%
ingress.go	21	88.6%

Totals
Change from base Build 20636734136:	0.02%
Covered Lines:	15922
Relevant Lines:	20201

---

💛 - Coveralls

[vflaux]

Great addition to the doc imo.
(XXL PR => XXL Review 😄)

[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