Hi Gabor, IMO, the change log is too detailed to be readable for users. There're no any highlights. It's hard for users to find significant changes. A summarized doc about new features and significant bug fixes (not any fixes for tests) will be more useful for them. Something like these: - https://kudu.apache.org/docs/release_notes.html - https://www.cloudera.com/documentation/enterprise/release-notes/topics/cdh_rn_new_in_cdh_516.html
However, the "Kudu 1.9.0 Release Notes" we pasted above looks like a draft. I think if we do so, we still need a document writer to polish and reorganize the doc. Thanks, Quanlong On Mon, Mar 18, 2019 at 8:23 PM Gabor Kaszab <gaborkas...@cloudera.com> wrote: > Hey, > > I recently had some time to give a second thought on the release notes doc > idea proposed above. The link Quanlong attached brings me to this doc that > contains a reduced list of features/bug fixes/ improvements and another > reduced list of the short descriptions of these: > > https://docs.google.com/document/d/1eeL4sfXvRxHvA7PcUw3SH2vA_5grb9-kRtL06Kzm5Cw/edit > > We already have an official release notes that contain a list of all the > changes in the release where you are one click away from reading the > details of a particular change. > https://impala.apache.org/docs/changelog-3.1.html > > All in all, currently I don't see the added value of creating another > release notes document. Any comments on this? > > Cheers, > Gabor > > > > On Mon, Mar 18, 2019 at 10:32 AM Gabor Kaszab <gaborkas...@cloudera.com> > wrote: > > > It wasn't late, no problem. I added it to the release alongside with the > > doc changes from Alex. > > I consider now the release content final and I move on with the next > steps > > of the release creation. > > > > Cheers, > > Gabor > > > > > > On Fri, Mar 15, 2019 at 8:18 PM Thomas Tauber-Marshall < > > tmarsh...@cloudera.com> wrote: > > > >> If its not too late, it would be great to include this fix: > >> https://issues.apache.org/jira/browse/IMPALA-8299 > >> > >> On Thu, Mar 14, 2019 at 5:38 AM Gabor Kaszab <gaborkas...@cloudera.com> > >> wrote: > >> > >> > (Sorry, accidentally sent out the mail too early) > >> > - Alex sent in a number of doc commits covering changes that are > already > >> > in, so I'll include them as well: > >> > - 76286bf2c0320cce0eb1bf0c269d344255b4dd0e IMPALA-7974 > >> > - 9cc75c59d5a09bd8cccc98bdf05cc64a98a70ffd IMPALA-8133 > >> > - 535d286ee16721a35bda1861e4d011ea99a8c02f IMPALA-8067 > >> > - 0d3d3258d2762887c61bf8e64e5df33dc2419817 IMPALA-8298 > >> > - 668bb73e1153afcb50ffc8b45267232b926a2258 IMPALA-7974 > >> > - ca98d6649d700517e90359d39c94d3356c6c092e IMPALA-7718 > >> > > >> > Alex, I see 2 doc changes remaining according to your list. Do you > feel > >> > they can get to the repo in the next 1-2 days? I can wait for them, > >> then. > >> > IMPALA-8296 > >> > IMPALA-8297 > >> > > >> > If no other request comes in until then, then I'll take the above > >> mentioned > >> > as the content of the 3.2.0 release and advance with the next steps of > >> > release creation. > >> > > >> > Cheers, > >> > Gabor > >> > > >> > > >> > On Thu, Mar 14, 2019 at 1:18 PM Gabor Kaszab < > gaborkas...@cloudera.com> > >> > wrote: > >> > > >> > > Hey, > >> > > > >> > > Just for the record I gather the requests and conclusions here in > one > >> > mail: > >> > > - It's fine to cut at 9686545bfd7236350d165813621bf783b42d1c18 > >> > IMPALA-6503: > >> > > Support reading complex types from ORC > >> > > < > >> > > >> > https://github.com/apache/impala/commit/9686545bfd7236350d165813621bf783b42d1c18 > >> > > > >> > > (inclusive) > >> > > - As Csaba requested, I'll > >> > > include 26639963e0ea66bea716c0238cdf1ff086159c7c IMPALA-8300 to > >> correct a > >> > > test issue introduced by the commit right above. > >> > > - Alex sent in a number of doc commits covering changes that are > >> already > >> > > in, so I'll include them as well: > >> > > > >> > > > >> > > On Mon, Mar 11, 2019 at 6:54 PM Alexandra Rodoni < > >> arod...@cloudera.com> > >> > > wrote: > >> > > > >> > >> I have 10 doc tickets for 3.2. Out of 18, 4 in progress, and 3 > still > >> > open. > >> > >> The rest is done. > >> > >> > >> > >> *In progress: * > >> > >> IMPALA-8133 > >> > >> IMPALA-8296 > >> > >> IMPALA-8297 > >> > >> IMPALA-7974 > >> > >> > >> > >> *Open:* > >> > >> IMPALA-8067 > >> > >> IMPALA-7718 > >> > >> IMPALA-8298 > >> > >> > >> > >> Thanks. > >> > >> alex > >> > >> > >> > >> On Mon, Mar 11, 2019 at 6:33 AM Gabor Kaszab < > >> gaborkas...@cloudera.com> > >> > >> wrote: > >> > >> > >> > >> > Thanks for the feedback! > >> > >> > No objections came agains the release so let me continue with the > >> next > >> > >> > steps. I see that the ORC complex types just got into the repo > so I > >> > >> propose > >> > >> > to cut the release there (inclusive): > >> > >> > > >> > >> > 9686545 IMPALA-6503: Support reading complex types from ORC > >> > >> > > >> > >> > In case there is anything before this commit that you are not > sure > >> and > >> > >> > prefer to omit from the release please let me know. Similarly, if > >> > there > >> > >> is > >> > >> > anything that is not ready but is right around the corner and you > >> > >> insist to > >> > >> > include it to the release, let me know. > >> > >> > > >> > >> > From doc's perspective I'm curious how far we are from having > >> coverage > >> > >> for > >> > >> > the proposed changes. > >> > >> > > >> > >> > Having a release notes doc is a good idea. Once we agree on the > >> > content > >> > >> > I'll create one and share it with the community so that each > >> > contributor > >> > >> > can fill in their change's description. > >> > >> > > >> > >> > Cheers, > >> > >> > Gabor > >> > >> > > >> > >> > > >> > >> > On Mon, Mar 4, 2019 at 11:28 PM Tim Armstrong < > >> > tarmstr...@cloudera.com> > >> > >> > wrote: > >> > >> > > >> > >> > > +1 - what Jim said! > >> > >> > > > >> > >> > > On Mon, Mar 4, 2019 at 9:53 AM Jim Apple <jbap...@cloudera.com > > > >> > >> wrote: > >> > >> > > > >> > >> > > > +1 to both a release and a habit of curated release notes as > >> > >> Quanlong > >> > >> > > > suggests. > >> > >> > > > > >> > >> > > > On Mon, Mar 4, 2019 at 6:54 AM Quanlong Huang < > >> > >> huangquanl...@gmail.com > >> > >> > > > >> > >> > > > wrote: > >> > >> > > > > > >> > >> > > > > +1. Thanks for your volunteer! > >> > >> > > > > > >> > >> > > > > If we decide to release, could we manage a doc that > everyone > >> can > >> > >> > write > >> > >> > > > down > >> > >> > > > > his/her notable works in this version? Got this idea from > the > >> > Kudu > >> > >> > > > > community and feel it very helpful: > >> > >> > > > > > >> > >> > > > > >> > >> > > > >> > >> > > >> > >> > >> > > >> > https://lists.apache.org/thread.html/8a10a4d244369f43b97c79513f13766c393a98252d3a2dade7611cc3@%3Cdev.kudu.apache.org%3E > >> > >> > > > > > >> > >> > > > > Thanks, > >> > >> > > > > Quanlong > >> > >> > > > > > >> > >> > > > > On Mon, Mar 4, 2019 at 10:18 PM Gabor Kaszab < > >> > >> > gaborkas...@cloudera.com > >> > >> > > > > >> > >> > > > > wrote: > >> > >> > > > > > >> > >> > > > > > Hey, > >> > >> > > > > > > >> > >> > > > > > 3.1.0 has been released at the beginning of December and > I > >> > feel > >> > >> > that > >> > >> > > > since > >> > >> > > > > > then there are a number of bug fixes and improvements > >> checked > >> > >> in. > >> > >> > > > > > What do you think about releasing 3.2.0 soon? I volunteer > >> as a > >> > >> > > release > >> > >> > > > > > manager in case no one is against. > >> > >> > > > > > > >> > >> > > > > > Cheers, > >> > >> > > > > > Gabor > >> > >> > > > > > > >> > >> > > > > >> > >> > > > >> > >> > > >> > >> > >> > > > >> > > >> > > >
