api-ref: reorder parameters.yaml

This reorder's parameters.yaml to the correct sort order, and turns
the info message about incorrect ordering into a warning. After this
lands parameters.yaml changes will always require that the items stay
in the sorted order enforced by the extension.

Part of bp:api-ref-in-rst

Change-Id: Ib890d369a8b50a8cd920f7b19ef13f44b3e657df

api-ref/ext/rest_parameters.py

@@ -181,7 +181,7 @@ class RestParametersDirective(Table):
             current_section = value['in']
             last_section = last[1]['in']
             if sections[current_section] < sections[last_section]:
-                self.app.info(
+                self.app.warn(
                     "Section out of order. All parameters in section ``%s`` "
                     "should be after section ``%s``. (see ``%s``)" % (
                         last_section,
@@ -189,7 +189,7 @@ class RestParametersDirective(Table):
                         last[0]))
             if (sections[value['in']] == sections[last[1]['in']] and
                 key.lower() < last[0].lower()):
-                self.app.info(
+                self.app.warn(
                     "Parameters out of order ``%s`` should be after ``%s``" % (
                         last[0], key))
             last = (key, value)