David, I am working on a solution for this that would allow us to validate the site docs locally with Docker containers without having to point to a LIVE location
I will share an update soon On Tue, Sep 14, 2021 at 5:15 AM David Jacot <dja...@confluent.io.invalid> wrote: > 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 > > > > > >
