Don't render deprecated enum members in semconv tables

[lmolkova]

Came up in ##1006 (comment)

Deprecated enum members are not useful in semconv docs and should only appear in the registry.

Merge requirement checklist

• CONTRIBUTING.md guidelines followed.
• Change log entry added, according to the guidelines in When to add a changelog entry.
  • If your PR does not need a change log, start the PR title with [chore]
• schema-next.yaml updated with changes to existing conventions.

[ChrsMark]

I wonder if we'd rather preserve the deprecated ones in the semconv tables but only for limited period of time, i.e. for 2 releases before removing them.
However I don't know if that would be technically doable. Maybe if we were encoding the version that a member/attribute was deprecated, deprecated-1.26.0.

[lmolkova]

I wonder if we'd rather preserve the deprecated ones in the semconv tables but only for limited period of time, i.e. for 2 releases before removing them. However I don't know if that would be technically doable. Maybe if we were encoding the version that a member/attribute was deprecated, deprecated-1.26.0.

You're right, we don't have a way to express in which version a property was deprecated. It came up in the past and I created #1117 to track it. If we had an option to remove them after X releases, I'd be happy to keep them around for a bit.

Until we have this option, I'd prefer not to render them in the specific semconvs - that's what we do for the attributes.

[trisch-me]

nit: I might be late to the review, but filter usually filters things out, so I was stumbled upon usage, where we filter member but still continue to process it later
So semantically it should be False for good member and True for deprecated one.

[trisch-me]

Suggested change

	{% macro filter(member) %}{% if snippet_type is not defined or (member.deprecated is none or member.deprecated == "") %}{{ "True" }}{% else %}{{ "False" }}{% endif %}{% endmacro %}
	{% macro filter_deprecated(member) %}{% if snippet_type is not defined or (member.deprecated is none or member.deprecated == "") %}{{ "False" }}{% else %}{{ "True" }}{% endif %}{% endmacro %}

something like this