Add additional API incubator docs #6356
Merged
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
I've responded to several questions lately about how to use various incubating API features, and the only thing I can respond with is a link to the PR where the feature was added.
This PR adds little blurbs of code which demonstrate simple usage patterns of the experimental API features. The code is put in test classes so we can verify it compiles and that the minimal set of assertions work. The incubator API readme links to these usage test classes.
With this, we can funnel anyone interested to the incubator readme and they should be able to self-help most of the time.
Once a particular feature is stable, we can delete these usage tests and consider moving the documentation to opentelemetry.io. In an experimental state, there's too great an opportunity for breaking API changes and drift between static opentelemetry.io content.