Open Stack

Hello

I cannot tox api-site now. (my workaround patch is end of this mail.)
Would you consider fixing this problem?

Merge "Add error response codes to Orchestration API"
https://github.com/openstack/api-site/commit/ae78d1bd04647ed325ff132e6ff22ad8f37eaa16

toxing error is like this
===========
Testing patch:
  Title: Merge "Add error response codes to Orchestration API"
  Author: Jenkins
  Branch: master
Checking files for syntax...
api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl:0:0:ERROR:SCHEMASV:SCHEMAV_ELEMENT_CONTENT: Element 'doc': This element is not expected. Expected is one of ( {http://wadl.dev.java.net/2009/02}doc, {http://wadl.dev.java.net/2009/02}param, {http://wadl.dev.java.net/2009/02}representation, ##other{http://wadl.dev.java.net/2009/02}* ).
api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl:0:0:ERROR:SCHEMASV:SCHEMAV_ELEMENT_CONTENT: Element 'doc': This element is not expected. Expected is one of ( {http://wadl.dev.java.net/2009/02}doc, {http://wadl.dev.java.net/2009/02}param, {http://wadl.dev.java.net/2009/02}representation, ##other{http://wadl.dev.java.net/2009/02}* ).
api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl:0:0:ERROR:SCHEMASV:SCHEMAV_ELEMENT_CONTENT: Element 'doc': This element is not expected. Expected is one of ( {http://wadl.dev.java.net/2009/02}doc, {http://wadl.dev.java.net/2009/02}param, {http://wadl.dev.java.net/2009/02}representation, ##other{http://wadl.dev.java.net/2009/02}* ).
api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl:0:0:ERROR:SCHEMASV:SCHEMAV_ELEMENT_CONTENT: Element 'doc': This element is not expected. Expected is one of ( {http://wadl.dev.java.net/2009/02}doc, {http://wadl.dev.java.net/2009/02}param, {http://wadl.dev.java.net/2009/02}representation, 
===========



For my case, I can avoid this case by applying following patch????

==========
diff --git a/api-ref/src/wadls/orchestration-api/src/v1/common.ent b/api-ref/src/wadls/orchestr
index 7f0b307..c00d6a4 100644
--- a/api-ref/src/wadls/orchestration-api/src/v1/common.ent
+++ b/api-ref/src/wadls/orchestration-api/src/v1/common.ent
@@ -282,25 +282,35 @@
 </param> '>
 <!ENTITY commonFaults '
 <response status="400" xmlns="http://wadl.dev.java.net/2009/02">
-<wadl:doc xmlns="http://docbook.org/ns/docbook" title="Bad Request"
+<wadl:doc xmlns="http://docbook.org/ns/docbook"
+   xmlns:wadl="http://wadl.dev.java.net/2009/02"
+   title="Bad Request"
    xml:lang="EN" />
 </response>
 <response status="401" xmlns="http://wadl.dev.java.net/2009/02">
-<wadl:doc xmlns="http://docbook.org/ns/docbook" title="Unauthorized"
+<wadl:doc xmlns="http://docbook.org/ns/docbook"
+   xmlns:wadl="http://wadl.dev.java.net/2009/02"
+   title="Unauthorized"
    xml:lang="EN" />
 </response> '>
 <!ENTITY notFound '
 <response status="404" xmlns="http://wadl.dev.java.net/2009/02">
-<wadl:doc xmlns="http://docbook.org/ns/docbook" title="Not Found"
+<wadl:doc xmlns="http://docbook.org/ns/docbook"
+   xmlns:wadl="http://wadl.dev.java.net/2009/02"
+   title="Not Found"
    xml:lang="EN" />
 </response> '>
 <!ENTITY conflict '
 <response status="409" xmlns="http://wadl.dev.java.net/2009/02">
-<wadl:doc xmlns="http://docbook.org/ns/docbook" title="Conflict"
+<wadl:doc xmlns="http://docbook.org/ns/docbook"
+   xmlns:wadl="http://wadl.dev.java.net/2009/02"
+   title="Conflict"
    xml:lang="EN" />
 </response> '>
 <!ENTITY intServerErr '
 <response status="500" xmlns="http://wadl.dev.java.net/2009/02">
-<wadl:doc xmlns="http://docbook.org/ns/docbook" title="Internal Server Error"
+<wadl:doc xmlns="http://docbook.org/ns/docbook"
+   xmlns:wadl="http://wadl.dev.java.net/2009/02"
+   title="Internal Server Error"
    xml:lang="EN" />
 </response> '>
========== 

Thanks
Atsushi SAKAI