docs: combine API and CRD reference index pages into one

[geoffrey1330]

Fixes #2670

Checks

• My PR fulfills the Definition of Done of the corresponding issue and not more (or parts if the issue is separated
  into multiple PRs)
• I used descriptive commit messages to help reviewers understand my thought process
• I signed off all my commits according to the Developer Certificate of Origin (DCO)(
  see Contribution Guide)
• My PR title is formatted according to the semantic PR conventions described in
  the Contribution Guide
• My content follows the style guidelines of this project (YAMLLint, markdown-lint)
• I regenerated the auto-generated docs for Helm and the CRD documentation (if applicable)
• I have performed a self-review of my content including grammar and typo errors and also checked the rendered page
  from the Netlify deploy preview
• My changes result in all-green PR checks (first-time contributors need to ask a maintainer to approve their test runs)

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (7175d11) 53.14% compared to head (012289f) 85.75%.

❗ Current head 012289f differs from pull request most recent head ddb9d8c. Consider uploading reports for the commit ddb9d8c to get more accurate results

Additional details and impacted files

@@             Coverage Diff             @@
##             main    #2849       +/-   ##
===========================================
+ Coverage   53.14%   85.75%   +32.61%     
===========================================
  Files          22      161      +139     
  Lines        1767    10202     +8435     
===========================================
+ Hits          939     8749     +7810     
- Misses        735     1171      +436     
- Partials       93      282      +189     

see 150 files with indirect coverage changes

Flag	Coverage Δ
certificate-operator	67.42% <ø> (?)
component-tests	56.97% <ø> (+0.82%)	⬆️
lifecycle-operator	84.68% <ø> (?)
metrics-operator	87.63% <ø> (?)
scheduler	36.53% <ø> (ø)

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

[StackScribe]

@geoffrey1330 You need to run make markdownlint-fix on your local branch then commit and push the resulting changes. I think that will fix the markdown errors you are getting.

[StackScribe]

Nicely done! Just a couple little wordsmithing suggestions...

[geoffrey1330]

@geoffrey1330 You need to run make markdownlint-fix on your local branch then commit and push the resulting changes. I think that will fix the markdown errors you are getting.

Alright thanks.

[mowies]

pls don't put links into headlines

[mowies]

LGTM

[sonarqubecloud]

Quality Gate passed

Kudos, no new issues were introduced!

0 New issues
0 Security Hotspots
No data about Coverage
0.0% Duplication on New Code

See analysis details on SonarCloud

[sonarqubecloud]

Quality Gate passed

Kudos, no new issues were introduced!

0 New issues
0 Security Hotspots
No data about Coverage
0.0% Duplication on New Code

See analysis details on SonarCloud