The current os-api-ref and Sphinx packages warn about a couple of
problems. Fix them all:
* wrong order of entries in parameters.yaml
* missing parameter
* too short underline
Also, treat warnings as errors for Sphinx to avoid regressions.
Change-Id: Id129cc709df38385a8cfe6dc12ffca6d4ba4857e
b027aa0a77