refactor idp to its own file

for comparison

Change-Id: Ia1becc2fa36f095e30f306c6436bd180fb8760a2

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

@@ -294,6 +294,8 @@ If a value is not specified by the client, the service will default this value
 to ``ss:mem:``.
 
 
+.. include:: federation/identity-provider/idp.inc
+
 .. TODO(samueldmq): This is the Mapping API, move it to its own file.
 
 Create a mapping

api-ref/source/v3-ext/federation/identity-provider/idp.inc

@@ -1,13 +1,5 @@
 .. -*- rst -*-
 
-=====================================
- OS-FEDERATION IDENTITY PROVIDER API
-=====================================
-
-Provide the ability for users to manage Identity Providers (IdPs). Requires
-v3.0+ of the Identity API.
-
-
 Register an Identity Provider
 =============================
 

api-ref/source/v3-ext/federation/index.inc

@@ -1,2 +0,0 @@
-
-.. include:: federation/identity-provider/index.inc

api-ref/source/v3-ext/index.rst

@@ -12,7 +12,6 @@ This page describes these Identity API v3 extensions:
 * `OS-REVOKE API`_
 * `OS-EP-FILTER API`_
 * `OS-FEDERATION API`_
-* `OS-FEDERATION IDENTITY PROVIDER API`_
 
 .. rest_expand_all::
 
@@ -22,4 +21,3 @@ This page describes these Identity API v3 extensions:
 .. include:: revoke.inc
 .. include:: ep-filter.inc
 .. include:: federation.inc
-.. include:: federation/index.inc