> On Jul 14, 2019, at 3:27 PM, Francis Chuang <francischu...@apache.org> wrote:
>
> In the past, the Javadocs were only ever built right after finalizing a
> release. So, in general, the javadocs do not reflect snapshot versions.
>
> Can Julian confirm if the javadocs must be for the latest final release?
That has been the policy. I don’t think we ever debated it. We can of course we
can debate it.
Remember that “snapshot versions” are not releases, and we should not encourage
people to believe that the code in Github’s master branch is approved.
The policy has been that the web site contains documentation and API docs for
the latest release. So, the release manager would roll out the site immediately
after a release is final. Other aspects of the web site (e.g. committer list,
upcoming talks, and process documents) are changed as and when needed. I
believe that is the most useful thing for our users.
Julian
