Hi Randall, Thanks for your comments.
I definitely missed updating https://github.com/apache/kafka/blob/2.8.1-rc0/docs/js/templateData.js. I will fix this. I will cut a new RC to address this. Regarding https://github.com/apache/kafka-site/tree/asf-site/28, I did not update the documentation there yet. The issue is that it would update the current live documentation (2.8) with references to an unreleased version. We can't really do this, right? I could publish the doc in a temporary directory (e.g. 281) for the time being. What do you think? Best, David On Tue, Sep 14, 2021 at 12:19 AM Randall Hauch <rha...@gmail.com> wrote: > Thanks, David. > > I was able to successfully complete the following: > > - Build release archive from the tag, installed locally, and ran a portion > of quickstart > - Installed 2.8.1 RC0 and performed quickstart for broker and Connect > - Verified signatures and checksums > - Verified the tag > - Compared the release notes to JIRA > - Manually spotchecked the Javadocs > > However, generated docs at > https://kafka.apache.org/28/documentation.html incorrectly > reference the 2.8.0 version in the following sections: > > * https://kafka.apache.org/28/documentation.html#quickstart > * https://kafka.apache.org/28/documentation.html#producerapi > * https://kafka.apache.org/28/documentation.html#consumerapi > * https://kafka.apache.org/28/documentation.html#streamsapi > * https://kafka.apache.org/28/documentation.html#adminapi > > The way these are updated during the release process has changed recently. > IIUC they are generated as part of the release build via the > https://github.com/apache/kafka/blob/2.8.1-rc0/docs/js/templateData.js > file, which appears to have not been updated in the tag: > https://github.com/apache/kafka/blob/2.8.1-rc0/docs/js/templateData.js#L22 > . > Maybe > the https://cwiki.apache.org/confluence/display/KAFKA/Release+Process > needs > to be tweaked to update this file even when cutting a patch release RC (it > currently says to update this file in the section for major and minor > releases). > > Also, the https://github.com/apache/kafka-site/tree/asf-site/28 history > shows no updates since July. I guess that's possible, but might be worth > double checking. > > Thanks! > > Randall > > On Fri, Sep 10, 2021 at 5:15 AM David Jacot <dja...@confluent.io.invalid> > wrote: > > > Hello Kafka users, developers and client-developers, > > > > This is the first candidate for release of Apache Kafka 2.8.1. > > > > Apache Kafka 2.8.1 is a bugfix release and fixes 49 issues since the > 2.8.0 > > release. Please see the release notes for more information. > > > > Release notes for the 2.8.1 release: > > https://home.apache.org/~dajac/kafka-2.8.1-rc0/RELEASE_NOTES.html > > > > *** Please download, test and vote by Friday, September 17, 9am PT > > > > Kafka's KEYS file containing PGP keys we use to sign the release: > > https://kafka.apache.org/KEYS > > > > * Release artifacts to be voted upon (source and binary): > > https://home.apache.org/~dajac/kafka-2.8.1-rc0/ > > > > * Maven artifacts to be voted upon: > > https://repository.apache.org/content/groups/staging/org/apache/kafka/ > > > > * Javadoc: > > https://home.apache.org/~dajac/kafka-2.8.1-rc0/javadoc/ > > > > * Tag to be voted upon (off 2.8 branch) is the 2.8.1 tag: > > https://github.com/apache/kafka/releases/tag/2.8.1-rc0 > > > > * Documentation: > > https://kafka.apache.org/28/documentation.html > > > > * Protocol: > > https://kafka.apache.org/28/protocol.html > > > > * Successful Jenkins builds for the 2.8 branch: > > Unit/integration tests: > > https://ci-builds.apache.org/job/Kafka/job/kafka/job/2.8/80/ > > System tests: > > https://jenkins.confluent.io/job/system-test-kafka/job/2.8/214/ > > > > /************************************** > > > > Thanks, > > David > > >
