Annotations on "top-level" public members can break scaladoc 3

[armanbilge]

Just to track this. If it's not deemed a Scala 3 issue (and I'm not sure if it would be) then we may need to rethink our implementation.

Bug (?):

• scaladoc errors if compile-only-intended annotation is not available on classpath at downstream usesite scala/scala3#18487

Workaround:

• Localize @nowarn212 to method parameters fs2#3291

[satorg]

@armanbilge , can the scala/scala3#18487 issue be worked around by adding scalac-compat-annotation directly to the doc task (which otherwise failing) as a regular Compile dependency?

[armanbilge]

Not sure, but the issue is that we shouldn't require downstream, non-sbt-typelevel users to have to modify their build in these ways just so they can use our libraries.

[armanbilge]

For now, the fix is to treat scalac-compat-annotation as a Provided library.

• removes the "compile-time" config in favor of "provided" sbt-typelevel#655