Skip to content

Priority non-experimental types, properties ahead in markdown and meta schema yaml#412

Merged
jack-berg merged 2 commits intoopen-telemetry:mainfrom
jack-berg:non-experimental-first
Nov 18, 2025
Merged

Priority non-experimental types, properties ahead in markdown and meta schema yaml#412
jack-berg merged 2 commits intoopen-telemetry:mainfrom
jack-berg:non-experimental-first

Conversation

@jack-berg
Copy link
Copy Markdown
Member

We have a lot of experimental parts of the schema, which muddy the waters of the (soon to be) stable important bits:

  • Users consuming schema-docs.md see a big chunk of experimental types right after ExemplarFilter because that's where lexigraphical sorting puts them.
  • Maintainers updating meta_schema_language_{language}.yaml similarly see a big chunk after ExemplarFilter.

This PR adjusts the sorting mechanisms to prioritize stable over experimental, then apply lexographical sorting, for both experimental types and properties. For schema-docs.md, I've split out a new Experimental Types section to further emphasize.

@jack-berg jack-berg requested a review from a team as a code owner November 15, 2025 01:40
- type: ExemplarFilter
status: not_implemented
enumOverrides: []
- type: ExperimentalComposableAlwaysOffSampler
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All the changes to meta_schema_* files are automatically generated by the small changes in scripts/*.js.

@jack-berg jack-berg merged commit 8e72a86 into open-telemetry:main Nov 18, 2025
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants