Experimental definitions in scaladoc

[nicolasstucki]

Compiler version

3.3.0-RC1-bin-20221128-8fba321-NIGHTLY

Issue

Generated docs do not indicate if a definition is experimental. All definitions are shown the same.

Expectation

At least we should explicitly mark which definitions are experimental.

• Write experimental explicitly or put them in an experimental section
• Tune down the colors of the experimental definition (grayscale or halfway to grayscale)

We should also have a way to filter them out with a toggle. These should not be shown by default as most programmers will not be able to use them.

Example

• https://dotty.epfl.ch/api/scala/annotation.html (or http://web.archive.org/web/20221130075251/https://dotty.epfl.ch/api/scala/annotation.html)

  

• https://dotty.epfl.ch/api/scala/annotation/newMain.html (or http://web.archive.org/web/20221130075342/https://dotty.epfl.ch/api/scala/annotation/newMain.html)

[prolativ]

I think we've already discussed this and the conclusion was that @experimental definitions should be marked in a similar way to @deprecated

[szymon-rd]

Addressed in #16310 (new section)