[OAS][DOCS] Adds linting rule for missing property descriptions

[natasha-moore-elastic]

Summary

Resolves https://github.com/elastic/docs-projects/issues/237 by adding a custom linting rule for missing property descriptions.

[elasticmachine]

Pinging @elastic/kibana-docs (Team:Docs)

[lcawl]

This rule only looks at properties in the components.schemas section of the OpenAPI document, so it won't catch any properties listed directly in the operations. Given how many hits already occur, however, I think this is okay as a starting point for cleanup.

I've also added a new make command in case folks want to be able to see errors only, since I've been thinking of this for quick debugging purposes.

[kibana-ci]

💛 Build succeeded, but was flaky

• Buildkite Build
• Commit: 0afb3fb

Failed CI Steps

• FTR Configs #81

Test Failures

• [job] [logs] FTR Configs #81 / Cloud Security Posture Test adding Cloud Security Posture Integrations CSPM AWS CIS_AWS Organization Manual Direct Access CIS_AWS Organization Manual Direct Access Workflow

Metrics [docs]

✅ unchanged

History

• 💚 Build #230384 succeeded b229fa7

To update your PR or re-run it, just comment with:
@elasticmachine merge upstream