More unhelpful update descriptions
Richard W.M. Jones
rjones at redhat.com
Mon Jul 1 20:12:27 UTC 2013
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
More information about the devel
mailing list