Re: Release notes and changelogs

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Wed, 21 Feb 2018, Alfredo Deza wrote:
> For every release we have a file like "v<version number>.txt" added to
> doc/changelog/ directory
> 
> These seem to be a direct copy of git log for the commits of the
> referred release. 12.2.3 is at about ten thousand lines.
> 
> What is it that we need from this to be added to the doc tree? I don't
> see what the benefit is from listing all the commits in exactly how
> `git log` would. Can we drop this?

No opinion.  I started doing it for point releases ages ago because other 
projects seemed to do it, but I have no idea if anyone ever looks at 
it.
 
> The file which I would think more of a changelog, which we call the
> 'release-notes.rst'  would benefit from being split per version, it is
> about 2MB and 20,000 lines. Maybe following the structure of the
> changelog files, it could be something like:
> 
> doc/releases/v<release-version>.rst
> 
> These would be easier/faster to load on a browser as well since it
> would need to just have enough info for the release.

Yes please!  :)

sage
--
To unsubscribe from this list: send the line "unsubscribe ceph-devel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [CEPH Users]     [Ceph Large]     [Information on CEPH]     [Linux BTRFS]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]
  Powered by Linux