Huh, that's surprising to me given that site-docs are part of the artifacts voted on. Having a way to update docs between releases is actually different from considering a known docs bug an issue w/ the release if someone cares about the site-docs artifacts being correct. But the site-docs seem somewhat pointless anyway. As a standalone package they don't work properly because they import files that only exist in the kafka-site repo...
I've tracked down all but one of the issues w/ docs. One was a bad rule in the .htaccess file which I've fixed (and that isn't in the release artifacts). A few others are changes that got made to kafka-site but weren't properly ported back to the docs/ directory in the main repo. As soon as I sort out the last problem (the double menu issue) I will submit a PR to get us back in sync w/ kafka-site. -Ewen On Wed, Feb 1, 2017 at 5:05 PM, Gwen Shapira <g...@confluent.io> wrote: > Note that doc fixes do not require new RC (we fix docs between > releases). So unless bugs are found, you won't need to do another. > > On Wed, Feb 1, 2017 at 4:10 PM, Ewen Cheslack-Postava <e...@confluent.io> > wrote: > > Thanks for testing Vahid. Let me check in with Derrick, who made some > > adjustments to our handling of docs and other versions. I'm wondering if > > this could only affecting this page due to changes that were made in > > kafka-site and not included in the main Kafka repo. I found some other > > changes where they differed when doing some other docs updates. > > > > I'm seeing now that the protocol link doesn't seem to work on the > previous > > release either. We'll have to figure out when that change to a fragment > > happened. > > > > I figured we'd end up w/ more RCs. Please still test the other artifacts > > since a docs change like this will be a trivial next RC. > > > > -Ewen > > > > On Wed, Feb 1, 2017 at 4:05 PM, Vahid S Hashemian < > vahidhashem...@us.ibm.com > >> wrote: > > > >> Ewen, > >> > >> Thanks a lot for running the release. I checked some of the links in the > >> email and noticed a couple of issues: > >> > >> When I go to the documentation link ( > >> http://kafka.apache.org/0102/documentation.html) and scroll down I get > a > >> second left-nav when I reach the end of list of content (try this link: > >> http://kafka.apache.org/0102/documentation.html#gettingStarted). I see > >> this on both Safari and Firefox. > >> > >> The link for protocol (http://kafka.apache.org/0102/protocol.html) > >> redirects me to (http://kafka.apache.org/0102/documentation#protocol) > >> which doesn't seem to be valid. > >> > >> Regards. > >> --Vahid > >> > >> > >> > >> From: Ewen Cheslack-Postava <e...@confluent.io> > >> To: dev@kafka.apache.org, "us...@kafka.apache.org" > >> <us...@kafka.apache.org>, "kafka-clie...@googlegroups.com" > >> <kafka-clie...@googlegroups.com> > >> Date: 02/01/2017 03:45 PM > >> Subject: [VOTE] 0.10.2.0 RC0 > >> > >> > >> > >> Hello Kafka users, developers and client-developers, > >> > >> This is the first candidate for release of Apache Kafka 0.10.2.0. > >> > >> This is a minor version release of Apache Kafka. It includes 19 new > KIPs. > >> See the release notes and release plan ( > >> https://cwiki.apache.org/confluence/display/KAFKA/Release+Plan+0.10.2.0 > ) > >> for more details. A few feature highlights: SASL-SCRAM support, improved > >> client compatibility to allow use of clients newer than the broker, > >> session > >> windows and global tables in the Kafka Streams API, single message > >> transforms in the Kafka Connect framework. > >> > >> Release notes for the 0.10.2.0 release: > >> http://home.apache.org/~ewencp/kafka-0.10.2.0-rc0/RELEASE_NOTES.html > >> > >> *** Please download, test and vote by Monday February 6th 5pm PST *** > >> (Note the longer window to vote to account for the normal 7 days ending > in > >> the middle of the weekend.) > >> > >> Kafka's KEYS file containing PGP keys we use to sign the release: > >> http://kafka.apache.org/KEYS > >> > >> * Release artifacts to be voted upon (source and binary): > >> http://home.apache.org/~ewencp/kafka-0.10.2.0-rc0/ > >> > >> * Maven artifacts to be voted upon: > >> https://repository.apache.org/content/groups/staging/ > >> > >> * Javadoc: > >> http://home.apache.org/~ewencp/kafka-0.10.2.0-rc0/javadoc/ > >> > >> * Tag to be voted upon (off 0.10.2 branch) is the 0.10.2.0 tag: > >> https://git-wip-us.apache.org/repos/asf?p=kafka.git;a=tag;h= > >> 33ebac1f138f17b86002df05e55a9f5cff47f48a > >> > >> > >> > >> * Documentation: > >> http://kafka.apache.org/0102/documentation.html > >> > >> * Protocol: > >> http://kafka.apache.org/0102/protocol.html > >> > >> * Successful Jenkins builds for the 0.10.2 branch: > >> Unit/integration tests: > >> https://builds.apache.org/job/kafka-0.10.2-jdk7/60/ > >> System tests: > >> https://jenkins.confluent.io/job/system-test-kafka-branch-builder/697 > >> > >> Thanks, > >> Ewen Cheslack-Postava > >> > >> > >> > >> > >> > > > > -- > Gwen Shapira > Product Manager | Confluent > 650.450.2760 | @gwenshap > Follow us: Twitter | blog >
