Clearly it doesn't make sense to have a blank line in the middle of a
paragraph.
Change-Id: I962c8abdd8a3e73291c5863bb2b4b96d458c58d0
Signed-off-by: Adam Spiers <aspiers@suse.com>
The path of the jsonschema definitions has been changed already,
so this patch applies the change to the template file.
Change-Id: I2d9f0de3eb1506c70e57a8f094d9bb94cffd8954
During nova-specs reviews, it is difficult to check all API changes
for following api-wg guideline because there is a lot of nova-specs
patches. There are some common mistakes against following guideline[1],
then this patch adds a part of the guideline to the template file for
avoiding these mistakes.
REST API resource names
* Resource names may include hyphens.
* Resource names should not include underscores or other punctuation
(sole exception is the hyphen).
Fields in an API request or response body
* Field names should use snake_case style, not CamelCase or MixedCase
style.
[1]: https://github.com/openstack/api-wg/blob/master/guidelines/naming.rst
Change-Id: I20039ad1f7882cd5341431690b82dadab3cd1588
The "Project priority" section in the spec template is a source
of persistent confusion and mis-use. A large portion of spec
authors believe that it is a section to fill with their own
opinions on why their spec is important. In fact, pretty much
all specs should put the words "None" in this section. This is
particularly true earlier in the cycle, since the actual project
priorities do not get finalized / agreed on until the design
summit. Even once the priorities are agreed, this section of
the spec is still fairly pointless, since we've moved to tracking
priority specs in a separate etherpad. eg
https://etherpad.openstack.org/p/mitaka-nova-priorities-tracking
Just remove this source of confusion since it doesn't serve any
particularly useful purpose anymore, given the external tracking
done.
Change-Id: I808227fe71210abc64270f53ef3d3d62f176ff24
As discussed at the Liberty mid-cycle, we should open the Mitaka specs so
that people can start targeting changes, either new or deferrals from
Liberty.
Change-Id: I6fe26e5665dcfd4e1a7fc6c0f7b7a9532e825640