Update documentation from feedback

[jotak]

No description provided.

[openshift-ci]

[APPROVALNOTIFIER] This PR is NOT APPROVED

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

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

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

[codecov]

Codecov Report

Attention: Patch coverage is 0% with 5 lines in your changes missing coverage. Please review.

Project coverage is 66.60%. Comparing base (bc0bcef) to head (864d36b).

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #672   +/-   ##
=======================================
  Coverage   66.60%   66.60%           
=======================================
  Files          70       70           
  Lines        8115     8115           
=======================================
  Hits         5405     5405           
  Misses       2315     2315           
  Partials      395      395           

Flag	Coverage Δ
unittests	66.60% <0.00%> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

Files	Coverage Δ
apis/flowcollector/v1beta2/flowcollector_types.go	100.00% <ø> (ø)
apis/flowmetrics/v1alpha1/flowmetric_types.go	100.00% <ø> (ø)
...s/flowcollector/v1beta1/zz_generated.conversion.go	39.27% <0.00%> (ø)
...pis/flowcollector/v1beta2/zz_generated.deepcopy.go	43.76% <0.00%> (ø)

[skrthomas]

There's a few lingering nits from peer review:

• line 540 -certFile needs period
• line 548 - name needs period
• line 557 - type needs period
• Netobserv API doc regeneration openshift/openshift-docs#76593 (comment)
• A couple places where Kerry asks about the capitalization, where I think we may need to add an "Operator": Netobserv API doc regeneration openshift/openshift-docs#76593 (comment)

[jotak]

given that the downstream PR was merged, I'll go ahead and merge this one