docs: reference page for KeptnTaskDefinition

[StackScribe]

This PR moves existing information about tasks into the new structure. Additional work is required for all this material but this is a first step. Specifics:

• Moves the info in the concepts/task page to the KeptnTaskDefinition ref page
  • Big sections about secrets and context are still on this page but I think each of them should be discussed on their own page in "Implementing" -- merge with info that is currently in the "Working with tasks" page
• Deletes the concepts/task file
• Moves the tasks/write-tasks file into integrating/task.md
  • Delete material that absolutely duplicates what is in the KeptnTaskDefinition ref page
  • Did a quick rewrite of what was left, basically "Parameterizing functions" and "Using secrets"
  • The KeptnTaskDefinition ref page also has some info about parameters and secrets. I think all the "secrets" information needs to be pulled into its own page in the "Implementing..." section

This PR supercedes #1083, which also attempted to move the autogenerated files from the crd-ref directory to api-ref.

[netlify]

✅ Deploy Preview for keptn-lifecycle-toolkit ready!

Name	Link
🔨 Latest commit	fc3bc33
🔍 Latest deploy log	https://app.netlify.com/sites/keptn-lifecycle-toolkit/deploys/644c5e61dc26de0008cd465d
😎 Deploy Preview	https://deploy-preview-1194--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.

[codecov]

Codecov Report

Merging #1194 (d11b797) into main (2261a4a) will decrease coverage by 0.42%.
The diff coverage is n/a.

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

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1194      +/-   ##
==========================================
- Coverage   59.76%   59.35%   -0.42%     
==========================================
  Files         138      137       -1     
  Lines       10444    10267     -177     
==========================================
- Hits         6242     6094     -148     
+ Misses       3967     3948      -19     
+ Partials      235      225      -10     

see 10 files with indirect coverage changes

Flag	Coverage Δ
certificate-operator	64.15% <ø> (ø)
component-tests	60.57% <ø> (+0.26%)	⬆️
lifecycle-operator	78.03% <ø> (-0.25%)	⬇️
metrics-operator	77.80% <ø> (ø)
scheduler	21.75% <ø> (ø)

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

[mowies]

this PR has changes in far more files than the task definition. i think those changes don't belong in this PR but in #1224 right?

[StackScribe]

About all those files that don't belong in the PR... Between rebases and markdownlint -fix, files got pulled in here that don't belong. I think the same files are in PR1224 -- I have no idea how things got so messed up!

[mowies]

@StackScribe please either revert the changes that don't belong here via git or manually by copying over the original content

[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 corrupted and so I am deleting it. It is replaced by #1392 .