listExtensions, adminListExtensions, DocBook

[Karen Bradshaw]

I am looking into warnings for missing tags and found two in
api-site/api-ref/src/docbkx/ch_identity-admin-v2.xml
api-site/api-ref/src/docbkx/ch_identity-v2.xml

There is a section, COMMENTED OUT, in each file for the identity and identity-admin Extensions.
The method and method href are listed in the adjoining .wadl files.

What is the reasoning for commenting out the Extension sections in the .xml files?

[Diane Fleming (diane-fleming)]

Karen, I don't remember why these were commented out. Try putting them back in and see what happens. I vaguely remember that the PDF files didn't build correctly, but I honestly don't remember!

[Karen Bradshaw (kbhawkey)]

Hi. I have gone through the two files and put the extension(s), getExtension and listExtensions, back into the xml. Yes, the pdf generation fails with these resources added. I noticed that the resources in question have a type attribute which refers to a resource_type element. It is the same pattern for the resource_type, VersionDetails, getExtension. The resource_type also has a method.
See ExtensionList in v2.0/wadl/identity.wadl.

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/263076

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/263076
Committed: https://git.openstack.org/cgit/openstack/api-site/commit/?id=177098c90cf19664d1bd1825549746951f7c9d18
Submitter: Jenkins
Branch: master

commit 177098c90cf19664d1bd1825549746951f7c9d18
Author: Diane Fleming <email address hidden>
Date: Sun Jan 3 18:45:49 2016 -0600

    Fix extensions for Identity v2.0

    Change-Id: Ic5c719f7b816c3b837be9a2489329fe271635a6e
    Closes-Bug: #1490655