docs: fix the table display issue in metrics.md

[jswxstw]

Motivation

Fix the table display issue in metrics.md

Modifications

Verification

[jswxstw]

argo-workflows/Makefile

Line 632 in 514ea37

go run ./util/telemetry/builder --metricsDocs $@

@Joibel Please take a look at this when you have time. This will cause the tables in the documentation to not display correctly, which also makes docs ci task failure.

[terrytangyuan]

I wonder if we can catch this kind of issues with markdown linter

[jswxstw]

I wonder if we can catch this kind of issues with markdown linter

Markdownlint does not have a rule to recognize this type of case.
MkDocs uses a Markdown parser that strictly adheres to the CommonMark specification by default, while other parsers like GitHub Flavored Markdown (GFM) do not.

[Joibel]

Thanks for noticing this @jswxstw. I've fixed the generator to do the correct thing with table breaks, and also made it double space the "No attributes" lines for consistency.

I can't trivially make the generator layout the lines with ⚠️ correctly, it should really done with a fix to https://github.com/nao1215/markdown, but I don't think it's worth the effort. Let me know if you disagree.