Research: How can we add linting for front matter

[imsingh]

We should add frontmatter linting or validation to make sure certain frontmatter is always on each doc page. For instance, if we want a description on every page, we can add a linter to make sure everyone follows this guideline.

cc @iamrajiv @oleg-nenashev @vadasambar

[oleg-nenashev]

To be honest I would be careful with standardizing content formatting in a big community. Some maintenance of integration services may have strong and different opinions of how the content should be formatted. And these opinions might be different.

We could of course enforce some rules that impact the stability and visualization, but I would be careful with just syntax.

A solution for that could be a set of template GitHub action checks with some usage documentation. There are plenty of markdown lint steps out there, so having a common template in .github would be nice anyway.

[aepfli]

regarding markdownlint, I can also highlight keptn/keptn.github.io#1235 - which would also provide a make target for local development, hence that makes it easier for local usage. Regarding rules I have to agree with @oleg-nenashev, I would use it to prevent general structural errors, but would not go too heavy on standard formatting.