[CT-1807] Metrics should show yaml instead of compiled SQL in documentations

[kalanyuz]

Describe the feature

Since we write metric definitions in yaml to create semantic layer, the code section of metrics show the yaml definition and not compile SQL code.

Describe alternatives you've considered

Add another tab for YAML instead of replacing the code section entirely.

Are you interested in contributing this feature?

Yes. I would need a lead on where should I look to add this feature.

[callum-mcdata]

Hi @kalanyuz! I think we're directionally aligned on the fact that we want to expose more metric information inside the documentation but diverge slightly on how we'd like to do so. Instead of showing the yaml in the code section, we'd rather introduce all of the elements as details.

Given the dynamic nature of metrics, we may also want to remove the code section, as the sql associated with each metric is entirely dependent on how it is queried.

[kalanyuz]

@callum-mcdata I'm happy to help out with this if you could point me to where to look.

[github-actions]

This issue has been marked as Stale because it has been open for 180 days with no activity. If you would like the issue to remain open, please comment on the issue or else it will be closed in 7 days.

[github-actions]

Although we are closing this issue as stale, it's not gone forever. Issues can be reopened if there is renewed community interest. Just add a comment to notify the maintainers.