@Experiments Doc Annotation

[Absolutionism]

Suggestion

Make an @Experiments annotation that can be used for docs. Then on the docs, display the pattern that correlates to the experiment(s)

Why?

Allows users to visually see on the docs that an element is experimental and requires a using + the pattern for the experiment.

Other

No response

Agreement

• I have read the guidelines above and affirm I am following them with this suggestion.

[Fusezion]

Can you give an example of what you mean? I'm not sure I am following the usage

[Absolutionism]

So like

@Experiments(Feature.FOR_EACH_LOOPS)
public class SecFor extends SecLoop implements ExperimentalSyntax {

Then not sure how it should be displayed on the docs, but you know, somewhere around the lines of "This syntax is experimental. To enable use using ..." with the pattern(s) of the experiments.

[Fusezion]

Then not sure how it should be displayed on the docs,

if we go based off the current design of paper related on the new docs it'll likely be a tag on the syntax maybe something like, Experimental: "for each loop"in which I would agree is fine, I rather not have it be a large part of the doc element.

I'm fine with that design decision