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