From 492e5103ea40a443409cf0025bd6010ac827be5f Mon Sep 17 00:00:00 2001
From: Hongbin Lu <hongbin.lu@huawei.com>
Date: Wed, 14 Feb 2018 19:34:53 +0000
Subject: [PATCH] Fix the description of some parameters

The parameter 'id' is the ID of the subnetpool instead of subnet.
The parameter 'shared' applies for the subnetpool (and others)
instead of network.

Change-Id: If360645f37acfe11bedb65d9e5ab2512f1db08f5
---
 api-ref/source/v2/networks.inc    |  6 +++---
 api-ref/source/v2/parameters.yaml | 16 ++++------------
 2 files changed, 7 insertions(+), 15 deletions(-)

diff --git a/api-ref/source/v2/networks.inc b/api-ref/source/v2/networks.inc
index 3a8b573ef..02f6e27cc 100644
--- a/api-ref/source/v2/networks.inc
+++ b/api-ref/source/v2/networks.inc
@@ -206,7 +206,7 @@ Request
    - qos_policy_id: qos_policy_id-request
    - router:external: router:external-request
    - segments: segments
-   - shared: network-shared-request
+   - shared: shared
    - description: description-request
    - is_default: network_is_default-request
 
@@ -407,7 +407,7 @@ Request
    - qos_policy_id: qos_policy_id-request
    - router:external: router:external-request
    - segments: segments-request
-   - shared: network-shared-request
+   - shared: shared
    - tenant_id: project_id-request
    - vlan_transparent: vlan_transparent-request
    - description: description-request
@@ -514,7 +514,7 @@ Request
    - qos_policy_id: qos_policy_id-request
    - router:external: router:external-request
    - segments: segments-request
-   - shared: network-shared-request
+   - shared: shared
    - tenant_id: project_id-request
    - vlan_transparent: vlan_transparent-request
    - description: description-request
diff --git a/api-ref/source/v2/parameters.yaml b/api-ref/source/v2/parameters.yaml
index 7012947af..9a570026f 100644
--- a/api-ref/source/v2/parameters.yaml
+++ b/api-ref/source/v2/parameters.yaml
@@ -2816,13 +2816,6 @@ network-shared:
   in: body
   required: true
   type: boolean
-network-shared-request:
-  description: |
-    Indicates whether this network is shared across all tenants. By default,
-    only administrative users can change this value.
-  in: body
-  required: false
-  type: boolean
 network-status:
   description: |
     The network status. Values are ``ACTIVE``, ``DOWN``, ``BUILD`` or ``ERROR``.
@@ -4075,15 +4068,14 @@ service_type:
   type: string
 shared:
   description: |
-    Admin-only. Indicates whether this network is
-    shared across all projects.
+    Indicates whether this resource is shared across all projects.
+    By default, only administrative users can change this value.
   in: body
   required: false
   type: boolean
 shared-response:
   description: |
-    Admin-only. Indicates whether this network is
-    shared across all tenants.
+    Indicates whether this resource is shared across all projects.
   in: body
   required: true
   type: boolean
@@ -4380,7 +4372,7 @@ subnetpool:
   type: object
 subnetpool_id_body:
   description: |
-    The ID of the subnet.
+    The ID of the subnet pool.
   in: body
   required: true
   type: string