Make `@Order` a stable API

[sbrannen]

Discussed in #2909

^{Originally posted by skohlmann May 6, 2022}
Hi,

the @Order annotation is marked as EXPERIMENTAL where the type annotation value OrderAnnotation implementation is not marked as EXPERIMENTAL. So I guess, it‘s stable. The documentation of OrderAnnotation also refers to @Order.

On the other hand, if OrderAnnotation implicitly takes the API state of @Order, this indirection is semantically difficult to detect. This also in view of the fact that @Order has been in the EXPERIMENTAL state for many versions, and within this time period certainly

1. a realization with regard to 👍 or 👎 has arisen.
2. the use in projects is certainly established, after 4 minor releases.

I would be happy if the situation is clarified by the team in the next minor release. Whereby I plead for @Order to be transferred to the state STABLE.

Have fun :-)

-sascha