Re: Release notes and changelogs

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

 



Alfredo Deza <adeza@xxxxxxxxxx> writes:

> 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

Dropping these, don't know whether we should drop them from the source
tree, I don't have strong feelings towards removing them from earlier
releases though wouldn't oppose if anyone has strong reasons for this
> 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
I'd rather do doc/releases/<release-name>  or <release-major-version>
and then adding an index to the release page for every major release 
>
> These would be easier/faster to load on a browser as well since it
> would need to just have enough info for the release.

-- 
Abhishek 
--
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