Open Stack

I like the idea. When writing release notes, the more information we have
the better. I usually look at the blueprints that were completed or our
specs, but having an additional source (a commit message I could query) is
always good.

Thanks,

Steve Martinelli
OpenStack Keystone Core



From:	Matt Riedemann <mriedem at linux.vnet.ibm.com>
To:	"OpenStack Development Mailing List (not for usage questions)"
            <openstack-dev at lists.openstack.org>
Date:	2015/07/07 12:13 PM
Subject:	[openstack-dev] Thoughts on ReleaseNoteImpact git commit
            message tag



While reviewing a change in nova [1] I mentioned that we should have
something in the release notes for Liberty on the change.  Typically for
this I ask that the UpgradeImpact tag is added to the commit message
because at the end of a release I search git/gerrit for any commits that
have UpgradeImpact in them since the last major release (Kilo in this
case) and then we should see if those need mentioning in the release
notes upgrade impacts section for Nova (which they usually do).

The thing is, UpgradeImpact isn't always appropriate for the change, but
DocImpact is used too broadly and as far as I can tell, it's not really
for updating release notes [2].  It's for updating stuff found in
docs.openstack.org.

So we kicked around the idea of a ReleaseNoteImpact tag so that we can
search for those at the end of the release in addition to UpgradeImpact.

Are any other projects already doing something like this?  Or do we just
stick with UpgradeImpact?  Per the docs [3] it mentions release notes
but for configuration changes - which not everything in the release
notes for an upgrade impact requires a config change, some are
behavior/usage changes.  In this specific case in [1], it's actually
probably an APIImpact, albeit indirectly.

Anyway, just putting this out there to see how other projects are
handling tagging changes for inclusion in the release notes.

[1] https://review.openstack.org/#/c/189632/
[2] https://wiki.openstack.org/wiki/Documentation/DocImpact
[3] http://docs.openstack.org/infra/manual/developers.html#peer-review

--

Thanks,

Matt Riedemann


__________________________________________________________________________
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20150707/507d9b6b/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: graycol.gif
Type: image/gif
Size: 105 bytes
Desc: not available
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20150707/507d9b6b/attachment.gif>