On Mon, Jul 01, 2013 at 11:25:51AM -0700, Adam Williamson wrote:
On 2013-07-01 1:28, Richard W.M. Jones wrote:
>Since this topic comes up every few months, and no one's pointed
>out the obvious answer yet, I'll say it:
>
>* Instead of making up more rules, make the tooling better so
>we don't have to repeat update descriptions in multiple places. *
You appear to be missing the contention made by me and others that
the update description is not and should not be a simple repetition
of any other content. It is not the RPM changelog. It is not the git
commit log. It is not the upstream changelog.
As I think I said pretty clearly, there are two streams of
documentation: the detailed changelogs and the release notes (which
summarise changes in a human-readable form for a whole release).
These should already exist, upstream.
No need for them to be duplicated, *if* we had better tooling.
Rich.
--
Richard Jones, Virtualization Group, Red Hat
http://people.redhat.com/~rjones
libguestfs lets you edit virtual machines. Supports shell scripting,
bindings from many languages.
http://libguestfs.org