-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

Hi everyone,

TL;DR: DocImpact is changing, again, please review 276065

Some time ago, docs implemented a blueprint[1] to modify the behaviour of the 
DocImpact script. The agreed change was that all projects *with the exception 
of the five defcore projects* would have DocImpact bugs raised in their own 
repo. In other words, docs were anticipating continuing to handle DocImpact 
bugs for Nova, Glance, Swift, Keystone, and Cinder, but no other projects. In 
order to make this triaging process easier, we also wanted to enforce a 
description when DocImpact was used in a commit message. However, upon 
implementing this in Nova, as a trial, we discovered that it had a non-trivial 
impact on processing times, and the change was reverted[2]. After some 
discussion, we agreed[3] to try just resetting DocImpact to the individual 
groups, *including* the five defcore projects. This eliminates the need the run 
a check on the commit message for a description, as we're moving the burden of 
triage away from the docs team, and into the individual project teams. One of 
the ben
 e
fits of this change is that all product groups can now use DocImpact in a way 
that best suits their individual needs, rather than being tied to what Docs 
expects.

I've now gotten in-principle approval from each of the PTLs affected by this 
change, but wanted to ensure everyone had a chance to go over the new patch[4], 
and discuss these changes.

This is, as always, a reversible decision. If this solution happens to fall in 
a heap, I'm willing to try something different :)

Cheers,
Lana

1: 
http://specs.openstack.org/openstack/docs-specs/specs/mitaka/review-docimpact.html
2: https://review.openstack.org/#/c/259569/
3: http://lists.openstack.org/pipermail/openstack-dev/2016-January/083806.html
4: https://review.openstack.org/#/c/276065/ 

- -- 
Lana Brindley
Technical Writer
Rackspace Cloud Builders Australia
http://lanabrindley.com
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/

iQEcBAEBCAAGBQJWsviTAAoJELppzVb4+KUyz2EH/0IDHPOYzxjaypoJfFF7SopZ
fZLvGZ0EgcIZc39582N38BUW8INFTFG90YrqPbaaPSF0Ri0HBLcs9PuosUaoaQYe
BPe38zm11k5V8rQG6r7WA7vhMsTvHRhNNQpZ89cWkYMWLkFVDYA6LoKN+5RjDeEB
wCpb+4zef2L22UKffaxEZ2bCUYXMx1LCppMN2EFhDou9blZ1yBtAYqS9wPPuUzVB
DbSuRlZ6TMHiVntpJ1X/E8/PpErtaMkd3HPnbz3Ag2oT9O1qqdLCFdDkPaGsnkfJ
aEtPjpdgeDfSVJW5UEJLJdeGhqY7aOtVq/3suLKWf+D/UzY/YBLWHMYacDjabPE=
=0uUc
-----END PGP SIGNATURE-----

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

Reply via email to