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 -- devel mailing list devel@xxxxxxxxxxxxxxxxxxxxxxx https://admin.fedoraproject.org/mailman/listinfo/devel
