[openstack-dev] Divergence of *-specs style checking

Alexis Lee alexisl at hp.com
Mon May 19 16:38:28 UTC 2014


We're seeing the spread of various *-specs projects now, which is great
to see. Some of these (nova, neutron and tripleo) include a Python unit
test (tests/test_titles.py) to check the specs follow the template. The
test has been copy-pasted between projects and it's diverging already.
Nova has a couple of extra tests; Neutron has some custom directives;
TripleO disallows additional sections.

It seems reasonable that while the specific allowed sections and
subsections may vary, the general guidance should apply across all
OpenStack projects much as code shares HACKING.

I put up a review here: https://review.openstack.org/#/c/91801/
which makes it more data-driven. Potentially the TITLES structure could
be read from a per-project YAML file and the test itself could be drawn
from some common area?


Alexis
-- 
Nova Engineer, HP Cloud.  AKA lealexis, lxsli.



More information about the OpenStack-dev mailing list