Reorganize api-ref: v3-ext federation projects-domains

Change-Id: Ie8e520dbc845f6e77195a59848a43483e8c855f1

api-ref/source/v3-ext/federation/projects-domains/parameters.yaml

@@ -11,7 +11,7 @@ domains:
     The list of domains the authenticated user may scope to
   in: body
   required: true
-  type: object
+  type: array
 
 links_domains:
   description: |
@@ -32,4 +32,4 @@ projects:
     The list of projects the authenticated user may scope to
   in: body
   required: true
-  type: object
+  type: array

api-ref/source/v3-ext/federation/projects-domains/projects-domains.inc

@@ -8,10 +8,6 @@ List projects a federated user can access
 
 .. rest_method::  GET /v3/OS-FEDERATION/projects
 
-Relationship: ``https://docs.openstack.org/api/openstack-identity/3/ext/OS-FEDERATION/1.0/rel/projects``
-
-Normal response codes: 200
-
 **Deprecated in v1.1**. Use core ``GET /auth/projects``. This call has the same
 response format.
 
@@ -20,16 +16,28 @@ to access. To access this resource, an unscoped token is used, the user can
 then select a project and request a scoped token. Note that only enabled
 projects will be returned.
 
+Relationship: ``https://docs.openstack.org/api/openstack-identity/3/ext/OS-FEDERATION/1.0/rel/projects``
+
 Response
 --------
 
+Parameters
+~~~~~~~~~~
+
 .. rest_parameters:: federation/projects-domains/parameters.yaml
 
    - links: links_projects
    - projects: projects
 
-Response Example
-----------------
+Status Codes
+~~~~~~~~~~~~
+
+.. rest_status_code:: success ../v3/status.yaml
+
+   - 200
+
+Example
+~~~~~~~
 
 .. literalinclude:: federation/projects-domains/samples/project-list-response.json
    :language: javascript
@@ -40,10 +48,6 @@ List domains a federated user can access
 
 .. rest_method::  GET /v3/OS-FEDERATION/domains
 
-Relationship: ``https://docs.openstack.org/api/openstack-identity/3/ext/OS-FEDERATION/1.0/rel/domains``
-
-Normal response codes: 200
-
 **Deprecated in v1.1**. Use core ``GET /auth/domains``. This call has the same
 response format.
 
@@ -52,16 +56,28 @@ to access. To access this resource, an unscoped token is used, the user can
 then select a domain and request a scoped token. Note that only enabled domains
 will be returned.
 
+Relationship: ``https://docs.openstack.org/api/openstack-identity/3/ext/OS-FEDERATION/1.0/rel/domains``
+
 Response
 --------
 
+Parameters
+~~~~~~~~~~
+
 .. rest_parameters:: federation/projects-domains/parameters.yaml
 
    - domains: domains
    - links: links_domains
 
-Response Example
-----------------
+Status Codes
+~~~~~~~~~~~~
+
+.. rest_status_code:: success ../v3/status.yaml
+
+   - 200
+
+Example
+~~~~~~~
 
 .. literalinclude:: federation/projects-domains/samples/domain-list-response.json
    :language: javascript