[libvirt] [PATCH for 5.10.0] news: Update for 5.10.0 release

[Ján Tomko]

On Wed, Nov 27, 2019 at 12:38:00PM +0000, Daniel P. Berrangé wrote:
>On Wed, Nov 27, 2019 at 01:34:12PM +0100, Michal Privoznik wrote:
>> On 11/27/19 1:19 PM, Peter Krempa wrote:
>> > On Wed, Nov 27, 2019 at 12:08:01 +0000, Daniel Berrange wrote:
>> > > On Wed, Nov 27, 2019 at 01:05:04PM +0100, Ján Tomko wrote:
>> > > > On Wed, Nov 27, 2019 at 11:24:56AM +0100, Michal Privoznik wrote:
>> > > > > Signed-off-by: Michal Privoznik <mprivozn at redhat.com>
>> > > > > ---
>> > > > > docs/news.xml | 124 ++++++++++++++++++++++++++++++++++++++++++++++++++
>> > > > > 1 file changed, 124 insertions(+)
>> > > > >
>> > > > > diff --git a/docs/news.xml b/docs/news.xml
>> > > > > index 72c0edb317..b6782df136 100644
>> > > > > --- a/docs/news.xml
>> > > > > +++ b/docs/news.xml
>> > > > > @@ -81,8 +81,132 @@
>> > > > >        </change>
>> > > > >      </section>
>> > > > >      <section title="Improvements">
>> > > >
>> > > > [...]
>> > > >
>> > > > > +      <change>
>> > > > > +        <summary>
>> > > > > +          More GLib integration
>> > > > > +        </summary>
>> > > > > +        <description>
>> > > > > +          More patches were merged that replace our internal functions with
>> > > > > +          GLib ones. Also some effort was invested in replacing gnulib modules
>> > > > > +          with GLib functions.
>> > > > > +        </description>
>> > > > > +      </change>
>> > > > > +      <change>
>> > > > > +        <summary>
>> > > > > +          Rewrite of Perl scripts into Python
>> > > > > +        </summary>
>> > > > > +        <description>
>> > > > > +          Libvirt used Perl scripts to check for coding style, generate some
>> > > > > +          code and things like that. To bring the number of languages used
>> > > > > +          down, these scripts were rewritten into Python.
>> > > > > +        </description>
>> > > > > +      </change>
>> > > >
>> > > > IIUC users are the target audience for the news. So far, these are just
>> > > > internal refactors that mostly benefit developers.
>> > >
>> > > The target is also distro packagers, so they learn of things that
>> > > might affect packaging design.
>> >
>> > Well in this case we didn't really remove anything yet so even distro
>> > packagers may get saturated by these entries if we do it too
>> > often without any real change.
>> >
>> > https://en.wikipedia.org/wiki/The_Boy_Who_Cried_Wolf
>> >
>>
>> I view news.xml not only as a way of communicating changes to
>> users/packagers but also as a way of giving credit to developers of some
>> important features. If we don't want to advertise these two, that's fine.
>> But then we should also consider blockdev paragraph - it's a change that's
>> transparent to users, isn't it? Should they care that we implemented it?

On its own it should be transparent, but the switch to blockdev did fix
some actual user-visible bugs that depended on it. Peter should have the
list.

>
>Even though these changes are "internal" they can still be visible to
>users by virtue of having a high liklihood of introducing new bugs. I
>think it is worth highlight these kind of major internal refactorings
>for this reason.

Okay, can we put them into a new "Refactors" section instead?

Jano

>
>Regards,
>Daniel
>-- 
>|: https://berrange.com      -o-    https://www.flickr.com/photos/dberrange :|
>|: https://libvirt.org         -o-            https://fstop138.berrange.com :|
>|: https://entangle-photo.org    -o-    https://www.instagram.com/dberrange :|
>
>--
>libvir-list mailing list
>libvir-list at redhat.com
>https://www.redhat.com/mailman/listinfo/libvir-list
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 488 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20191127/25c929b5/attachment-0001.sig>