docs: [WIP] PoC draft of CRD reference pages

[StackScribe]

This is a quick rough draft of what I envision as a reference page for a CRD, presented for discussion.

Caveats:

• I can't get my local build to display this file so formatting errors are a possibility. I'll get this sraightened out
• I used information in the existing docs but then made up some info that is not currently provided just as an example of the sort of info we might use. If we agree to go this way, we'll correct the info before publishing.
• I will add some more samples to this PR but wanted to get one sample available quickly.

#778

[mowies]

content-wise, this looks good, but i think we can put most of the content of this file into the actual docs comments in the code and then auto generate the markdown from there 🤷🏼

[mowies]

we have code examples of our CRDs already prepared (mostly). I would use a link here instead of actual code.
You can find the examples here: #888

[StackScribe]

I would love to embed this content in the source and have it autogenerated! But I figured I needed to hand-write a few pages to work things out and then we know what we want the tools to do.

[StackScribe]

I would very much like the "Synopsis" to show on the reference page that is displayed in the documentation, with a format similar to what I have here. But it would be ideal if that were pulled from the software source so it does not need to be maintained manually! I very much like the idea of just pointing to existing examples -- that allows people to see how this CRD fits in the "big picture" as it were.

[codecov]

Codecov Report

Merging #889 (1f60366) into main (c366739) will decrease coverage by 0.04%.
The diff coverage is n/a.

❗ Current head 1f60366 differs from pull request most recent head a1b78e7. Consider uploading reports for the commit a1b78e7 to get more accurate results

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #889      +/-   ##
==========================================
- Coverage   58.64%   58.60%   -0.04%     
==========================================
  Files          97       97              
  Lines        7552     7552              
==========================================
- Hits         4429     4426       -3     
- Misses       2933     2935       +2     
- Partials      190      191       +1     

Impacted Files	Coverage Δ
...ator/controllers/lifecycle/keptntask/controller.go	54.94% <0.00%> (-3.30%)	⬇️

Flag	Coverage Δ
component-tests	42.20% <ø> (-0.14%)	⬇️
keptn-lifecycle-operator	54.67% <ø> (ø)
klt-cert-manager	67.50% <ø> (ø)
scheduler	21.17% <ø> (ø)

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

[sonarqubecloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

No Coverage information
No Duplication information

[StackScribe]

This PR is superceded by #1083 .