In particular, there has been an outstanding problem with doclet support for
filtering javadocs by annotation since JDK9 came out.
Could you give me a pointer to relevant Yetus JIRA or ML thread?
On 2021/09/28 1:17, Sean Busbey wrote:
I think consolidating on a common library and tooling for defining API
expectations for Hadoop would be great.
Unfortunately, the Apache Yetus community recently started a discussion around
dropping their maintenance of the audience annotations codebase[1] due to lack
of community interest. In particular, there has been an outstanding problem
with doclet support for filtering javadocs by annotation since JDK9 came out.
I think that means a necessary first step here would be to determine if we have
contributors willing to show up over in that project to get things into a good
state for future JDK adoption.
[1]:
https://s.apache.org/ybdl6
"[DISCUSS] Drop JDK8; audience-annotations" from d...@yetus.apache.org
On Sep 27, 2021, at 2:46 AM, Viraj Jasani <vjas...@apache.org> wrote:
Since the early days, Hadoop has provided Interface classification
annotations to represent the scope and stability for downstream
applications to select Hadoop APIs carefully. After some time, these
annotations (InterfaceAudience and InterfaceStability) have been migrated
to Apache Yetus. As of today, with increasing number of Hadoop ecosystem
applications using (or starting to use) Yetus stability annotations for
their own downstreamers, we should also consider using IA/IS annotations
provided by *org.apache.yetus.audience *directly in our codebase and retire
our *org.apache.hadoop.classification* package for the better separation of
concern and single source.
I believe we can go with this migration to maintain compatibility for
Hadoop downstreamers:
1. In Hadoop trunk (3.4.0+ releases), replace all usages of o.a.h.c
stability annotations with o.a.y.a annotations.
2. Deprecate o.a.h.c annotations, and provide deprecation warning that
we will remove o.a.h.c in 4.0.0 (or 5.0.0) release and the only source for
these annotations should be o.a.y.a.
Any thoughts?
---------------------------------------------------------------------
To unsubscribe, e-mail: common-dev-unsubscr...@hadoop.apache.org
For additional commands, e-mail: common-dev-h...@hadoop.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: hdfs-dev-unsubscr...@hadoop.apache.org
For additional commands, e-mail: hdfs-dev-h...@hadoop.apache.org
