[Feature Request]: Throw error when version is invalid in `applies_to`

[colleenmcginnis]

Prerequisites

• I have searched existing issues to ensure this feature hasn't already been requested
• I have tested using the latest version of docs-builder

What problem are you trying to solve?

Currently if a version is invalid (not semver), we just hide the version altogether without throwing an error, warning, or hint. This is causing the docs to be inaccurate. For example, this functionality was added in 9.1, but because the version in the source file is invalid, there's nothing to communicate to users that this is only available in 9.1 and later.

Proposed Solution

We should throw an error or warning when a version is invalid so the user is aware.

Examples and Research

No response

Alternative Solutions

No response

Additional Context

There are currently 3 instances across docs the following repos / files that use invalid versions in applies_to.

• integration-docs: docs/reference/cloud_asset_inventory.md https://github.com/elastic/integration-docs/pull/928
• docs-content: explore-analyze/elastic-inference/inference-api.md Fix invalid versions in applies_to docs-content#3613

I can fix these at the source. 🙂

How important is this feature to you?

Important

[florent-leborgne]

With the upcoming support of a range-friendly syntax and changes to how we handle patch information, this should wait for a few days or weeks

[theletterf]

True. Closing the draft PR for the time being, we can use it for inspiration later.