[openstack-dev] [doc] DocImpact vs. reno

Andreas Jaeger aj at suse.com
Fri Dec 18 18:34:38 UTC 2015


On 12/18/2015 07:03 PM, Sean Dague wrote:
> Recently noticed that a new job ended up on all nova changes that was
> theoertically processing commit messages for DocImpact. It appears to be
> part of this spec -
> http://specs.openstack.org/openstack/docs-specs/specs/mitaka/review-docimpact.html

Lana talked with John Garbutt about this and announced this also in 
several 'What's up' newsletters like 
http://lists.openstack.org/pipermail/openstack-dev/2015-December/081522.html

> First, a heads up would be good. Nova burns a lot of nodes (i.e. has a
> lot of patch volume), so this just decreased everyone's CI capacity
> noticably.

I understand this reasoning and Joshua worked on a superior solution, 
see 
https://review.openstack.org/#/q/status:open+project:openstack-infra/zuul+branch:master+topic:skip-commit,n,z 


>
> Secondly, this all seems like the wrong direction. We've got reno now,
> which is extremely useful for documenting significant changes in the
> code base that need to be reflected up. We've dropped UpgradeImpact for
> an upgrade comment in reno, which is *so* much better.
>
> It seems like using reno instead of commit message tags would be much
> better for everyone here.

The goal of DocImpact is to notify the Documentation team about changes 
- currently done via bugs in launchpad so that manuals can be easily 
updated. How would this tracking work with docimpact?

Andreas
-- 
  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
   SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
    GF: Felix Imendörffer, Jane Smithard, Graham Norton,
        HRB 21284 (AG Nürnberg)
     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126




More information about the OpenStack-dev mailing list