Re: [openstack-dev] [TripleO] Spec Template Change Proposal

2014-05-22 Thread Derek Higgins
On 21/05/14 22:56, James Slagle wrote: On Wed, May 21, 2014 at 4:37 PM, Jay Dobies jason.dob...@redhat.com wrote: Currently, there is the following in the template: Proposed change === [snip] Alternatives [snip] Security impact --- The unit

Re: [openstack-dev] [TripleO] Spec Template Change Proposal

2014-05-22 Thread Jay Dobies
Merging a few of the replies into a single response: I like all of this plan, except for the name Overview. To me, Overview suggests a high-level summary rather than being one of the beefier sections of a spec. Something like Detail or Detailed overview (because the low-level detail will

[openstack-dev] [TripleO] Spec Template Change Proposal

2014-05-21 Thread Jay Dobies
Currently, there is the following in the template: Proposed change === [snip] Alternatives [snip] Security impact --- The unit tests assert the top and second level sections are standard, so if I add a section at the same level as Alternatives under

Re: [openstack-dev] [TripleO] Spec Template Change Proposal

2014-05-21 Thread James Polley
On Wed, May 21, 2014 at 4:37 PM, Jay Dobies jason.dob...@redhat.com wrote: Currently, there is the following in the template: Proposed change === [snip] Alternatives [snip] Security impact --- The unit tests assert the top and second level

Re: [openstack-dev] [TripleO] Spec Template Change Proposal

2014-05-21 Thread James Slagle
On Wed, May 21, 2014 at 4:37 PM, Jay Dobies jason.dob...@redhat.com wrote: Currently, there is the following in the template: Proposed change === [snip] Alternatives [snip] Security impact --- The unit tests assert the top and second level

Re: [openstack-dev] [TripleO] Spec Template Change Proposal

2014-05-21 Thread Robert Collins
We just landed a change to permit the third level subsections, but the intent AIUI of requiring exact titles to constrain the expression space in the interests of clarity. We can (and should) add more standard sections as needed. -Rob On 22 May 2014 08:37, Jay Dobies jason.dob...@redhat.com