Currently putting them in the repo is how we get release notes into the source and binary artifacts we vote on. It's really convenient for making sure folks who download things have some version of the notes.
We've been including the bare file in the dist area as well, so we'd face the same issue around distributing a large file (probably more likely to face it since it's compressed in the tarballs). I agree we should have an up to date rendered version on the website (it's been an outstanding doc jira). But the files usually aren't very large and having them shipped in the release is nice. On Tue, Jun 4, 2019, 12:04 Andrew Purtell <apurt...@apache.org> wrote: > What do you think about linking to a remote site-based release notes file > instead of checking them into the main repo? > > On Mon, Jun 3, 2019 at 10:12 PM Guanghao Zhang <zghao...@gmail.com> wrote: > > > Sorry. This large RELEASENOTES.md may be introduced by me. I committed a > > big RELEASENOTES.md to branch-2.2 yesterday. I fixed it today. And roll a > > new 2.2.0RC5. Thanks. > > > > Andrew Purtell <apurt...@apache.org> 于2019年6月4日周二 上午3:24写道： > > > > > remote: warning: GH001: Large files detected. You may want to try Git > > Large > > > File Storage - https://git-lfs.github.com. > > > remote: warning: See http://git.io/iEPt8g for more information. > > > remote: warning: File RELEASENOTES.md is 85.80 MB; this is larger than > > > GitHub's recommended maximum file size of 50.00 MB > > > > > > The object is cb0e9bb95599 86MiB RELEASENOTES.md > > > > > > Incidentially, the next largest file is also a markup release notes > file. > > > > > > 61e9de9b82a9 14MiB RELEASENOTES.md > > > > > > As far as I can tell cb0e9bb95599 is not referenced from anywhere. So > > > eventually garbage collection both on the github side and in local > > > repositories will clear it out? > > > > > > This leads to the natural question of whether we should be checking in > > such > > > really large autogenerated files. There are release policy > implications. > > > Perhaps we can check in very small release notes files containing only > a > > > URL to an online resource? Put the release notes objects in hbase-site > ? > > > > > > -- > > > Best regards, > > > Andrew > > > > > > Words like orphans lost among the crosstalk, meaning torn from truth's > > > decrepit hands > > > - A23, Crosstalk > > > > > > > > -- > Best regards, > Andrew > > Words like orphans lost among the crosstalk, meaning torn from truth's > decrepit hands > - A23, Crosstalk >
