[DISCUSS] use of Apache Yetus Audience Annotations

[Sean Busbey <bu...@apache.org>]

Hi!

Heads up that a discussion has started in Apache Yetus about dropping
the Audience Annotations and associated javadoc tooling due to lack of
community support[1]. The current cutting issue AFAICT is that things
there haven't been updated for the changes in how doclets are handled
in JDK9+.

We still center all of our API scoping on this library. In general it
has been solid and required relatively little investment on our part.

Personally, I think this has worked really well for us so far and we
ought to try to keep the shared resource going. Unfortunately, I don't
currently have the cycles to personally step up in the Yetus project.

What do folks think? Anyone able to help out in Yetus? Should we start
moving to maintain this tooling internal to HBase?

[1]:
https://s.apache.org/ybdl6
"[DISCUSS] Drop JDK8; audience-annotations" from dev@yetus.apache.org

Re: [DISCUSS] use of Apache Yetus Audience Annotations

[Nick Dimiduk <nd...@apache.org>]

On the one hand, I agree that it's nice to have a common pattern and point
of reference across hadoop projects. On the other hand, we have deviated
from the meanings of the annotations, and so the javadocs on the yetus
classes do not match our usage. It's also strange and kind of a code smell
that we have another project namespace in our public API.

If we want to continue using the Yetus annotations, I can volunteer some
time to their care and feeding for JDK9+.

On Mon, Sep 27, 2021 at 9:13 AM Sean Busbey <bu...@apache.org> wrote:

> Hi!
>
> Heads up that a discussion has started in Apache Yetus about dropping
> the Audience Annotations and associated javadoc tooling due to lack of
> community support[1]. The current cutting issue AFAICT is that things
> there haven't been updated for the changes in how doclets are handled
> in JDK9+.
>
> We still center all of our API scoping on this library. In general it
> has been solid and required relatively little investment on our part.
>
> Personally, I think this has worked really well for us so far and we
> ought to try to keep the shared resource going. Unfortunately, I don't
> currently have the cycles to personally step up in the Yetus project.
>
> What do folks think? Anyone able to help out in Yetus? Should we start
> moving to maintain this tooling internal to HBase?
>
> [1]:
> https://s.apache.org/ybdl6
> "[DISCUSS] Drop JDK8; audience-annotations" from dev@yetus.apache.org
>