docs: reference page for KeptnTaskDefinition

[StackScribe]

Part of #1078 .

This sets up the crd-ref directory and provides a draft of the KeptnTaskDefinition page. This is largely for discussion and PoC although I think this is the beginning of a page that should be completed. It currently has a bit of information I made up and some embedded questions that need to be either answered or removed.

The "CRD Reference Section" title may not be what we want. We discussed having this under Concepts but, with the existing "Concepts" section, this gets messy. So I created this section to be new; we can eventually rename it, although I think having it identified as a Reference section is a good thing.

Note that this PR does not add links from the API Reference pages to these pages. I will do those in a separate PR.

[netlify]

✅ Deploy Preview for keptn-lifecycle-toolkit ready!

Name	Link
🔨 Latest commit	c8d1daf
🔍 Latest deploy log	https://app.netlify.com/sites/keptn-lifecycle-toolkit/deploys/64264644e9b0810008258866
😎 Deploy Preview	https://deploy-preview-1083--keptn-lifecycle-toolkit.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site settings.

[mowies]

Left some comments. If you really want to move the auto generated API reference, you also need to adjust all other occurrences of that path in all other files in the project.

[sonarcloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

No Coverage information
No Duplication information

[codecov]

Codecov Report

Merging #1083 (c8d1daf) into main (8e93f88) will increase coverage by 20.65%.
The diff coverage is 100.00%.

Additional details and impacted files

@@             Coverage Diff             @@
##             main    #1083       +/-   ##
===========================================
+ Coverage   58.88%   79.53%   +20.65%     
===========================================
  Files         126      119        -7     
  Lines       10003     7452     -2551     
===========================================
+ Hits         5890     5927       +37     
+ Misses       3894     1309     -2585     
+ Partials      219      216        -3     

Impacted Files	Coverage Δ
...is/lifecycle/v1alpha3/keptntaskdefinition_types.go	100.00% <ø> (ø)
operator/controllers/common/helperfunctions.go	100.00% <ø> (ø)
...ontrollers/common/providers/dynatrace/dynatrace.go	81.66% <100.00%> (+3.66%)	⬆️
...r/apis/lifecycle/v1alpha3/keptnappversion_types.go	97.61% <100.00%> (+0.02%)	⬆️
...perator/apis/lifecycle/v1alpha3/keptntask_types.go	97.59% <100.00%> (+0.12%)	⬆️
.../lifecycle/v1alpha3/keptnworkloadinstance_types.go	95.37% <100.00%> (+0.04%)	⬆️
operator/controllers/common/evaluationhandler.go	77.53% <100.00%> (ø)
operator/controllers/common/taskhandler.go	79.71% <100.00%> (+3.19%)	⬆️
...ator/controllers/lifecycle/interfaces/phaseitem.go	94.82% <100.00%> (ø)
...cle/keptnappversion/reconcile_prepostdeployment.go	81.81% <100.00%> (ø)
... and 6 more

... and 9 files with indirect coverage changes

Flag	Coverage Δ
certificate-operator	64.15% <ø> (ø)
component-tests	59.97% <78.57%> (+0.14%)	⬆️
keptn-lifecycle-operator	?
lifecycle-operator	78.52% <96.29%> (+0.12%)	⬆️
metrics-operator	77.57% <100.00%> (+0.22%)	⬆️
scheduler	21.17% <ø> (ø)

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

[StackScribe]

This PR is superceeded by #1194 , which just modifies doc content/structure and leaves the auto-generated files in the crd-ref directory rather than attempting to move them to the api-directory.