Re: [RFC] Toward a better NEWS file

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hello,

I'm quite new in libvirt community so I don't know all requirements
which community have but did You know about reno project from Openstack:
http://docs.openstack.org/developer/reno/ ? It's used for managing
releae notes which are added in git as separate files. Maybe it can be
some solution for You also :)

-- 
Best regards / Pozdrawiam
Sławek Kapłoński
slawek@xxxxxxxxxxxx

On Fri, 21 Oct 2016, Michal Privoznik wrote:

> On 19.10.2016 19:58, Daniel P. Berrange wrote:
> > On Wed, Oct 19, 2016 at 01:53:41PM +0200, Andrea Bolognani wrote:
> >> Hi,
> >>
> >> <snip/>
> > 
> > Why don't we simply have a NEWS file in GIT, and require that
> > non-trivial commits or patch series include an update to NEWS,
> > so the NEWS file gets populated at time the feature/bug fix
> > gets merged.
> 
> I'm up for this one. While introducing a new feature (which touches a
> lot of code anyway) we will just update one file more. I see no problem
> with that. Having to provide news per developer later, trying to recall
> what have I done, might be harder. Therefore NEWS (or news.html.in)
> should be updated among with a major change in the code.
> 
> But let me also provide another reason why this is important (thank you
> Andrea for starting the thread). I spoke to people who test our software
> and sometimes they are just lost with current form of NEWS. It is very
> hard for them to even understand new features in the release so that
> they cannot really update their test cases (or they do so partially). If
> we make NEWS format more readable it will be easier for them to
> implement new tests and subsequently it will increase quality of our
> project.
> 
> Michal
> 
> --
> libvir-list mailing list
> libvir-list@xxxxxxxxxx
> https://www.redhat.com/mailman/listinfo/libvir-list

Attachment: signature.asc
Description: PGP signature

--
libvir-list mailing list
libvir-list@xxxxxxxxxx
https://www.redhat.com/mailman/listinfo/libvir-list

[Index of Archives]     [Virt Tools]     [Libvirt Users]     [Lib OS Info]     [Fedora Users]     [Fedora Desktop]     [Fedora SELinux]     [Big List of Linux Books]     [Yosemite News]     [KDE Users]     [Fedora Tools]