Update docs for 5G SON usecase

Issue-ID: REQ-970
Signed-off-by: krishnaa96 <krishna.moorthy6@wipro.com>
Change-Id: I2a4e8e7706c1853e691f65c3bf008f431ff6d343

2 files changed, 23 insertions, 35 deletions

diff --git a/docs/docs_5G_oof_pci.rst b/docs/docs_5G_oof_son.rst
index 695521026..5d97982f4 100644
--- a/docs/docs_5G_oof_pci.rst
+++ b/docs/docs_5G_oof_son.rst
@@ -11,48 +11,36 @@ OOF-SON
 Description
 ~~~~~~~~~~~
 
-The 5G OOF-SON (earlier name was OOF-PCI) use case is an implementation of a **SON (Self-Organizing Networks)**
-algorithm for Physical Cell ID (PCI) optimization and the centralized Automatic Neighbor Relations
-(ANR) function (blacklisting a neighbor for handovers) in a 4G/5G network using the ONAP
-Optimization Framework (OOF).
-
-The use case is a multi-releases effort initiated in Casablanca release.
-This use case began with the implementation of PCI optimization in Casablanca.
-In Dublin release, the SON-Handler MS was onboarded as a
-micro-service in DCAE. Enhancements were made to Policy and SDN-C components.
-
-In Frankfurt release, the following are the main enhancements:
-
-- Introduction of Control Loop Coordination functionality, wherein a second control loop execution is
-  denied by Policy component when another control loop is in progress.
-- Introduction of adaptive SON, wherein a set of cells whose PCI values are fixed (i.e., cannot be changed
-  during PCI optimization) are considered during the PCI optimization.
-- In addition, the first step towards O-RAN alignment is being taken with SDN-C (R) being able to receive a DMaaP
-  message containing configuration updates (which would be triggered when a neighbor-list-change occurs in the RAN
-  and is communicated to ONAP over VES). `Details of this implementation <https://wiki.onap.org/display/DW/CM+Notification+Support+in+ONAP>`_
+The 5G OOF-SON (earlier name was OOF-PCI) use case is an implementation of a **SON (Self-Organizing Networks)** algorithm for Physical Cell ID (PCI) optimization and the centralized Automatic Neighbor Relations (ANR) function (blacklisting a neighbor for handovers) in a 4G/5G network using the ONAP Optimization Framework (OOF).
+
+The use case is a multi-releases effort initiated in Casablanca release. This use case began with the implementation of PCI optimization in Casablanca. In Dublin release, the SON-Handler MS was onboarded as a micro-service in DCAE. Enhancements were made to Policy and SDN-C components.
+
+In Frankfurt release, the following were the main enhancements:
+
+- Introduction of Control Loop Coordination functionality, wherein a second control loop execution is denied by Policy component when another control loop is in progress.
+- Introduction of adaptive SON, wherein a set of cells whose PCI values are fixed (i.e., cannot be changed during PCI optimization) are considered during the PCI optimization.
+- In addition, the first step towards O-RAN alignment is being taken with SDN-C (R) being able to receive a DMaaP message containing configuration updates (which would be triggered when a neighbor-list-change occurs in the RAN and is communicated to ONAP over VES). `Details of this implementation <https://wiki.onap.org/display/DW/CM+Notification+Support+in+ONAP>`_
+
 
 In the Istanbul release, the following are the main enhancements:
 
-- Updates in FM reporting and fault handling to be in line with VES 7.2,
-  3GPP and smoother future alignment with O-RAN O1
+- Updates in FM reporting and fault handling to be in line with VES 7.2, 3GPP and smoother future alignment with O-RAN O1
 - Alignment with 3GPP NRM/O-RAN yang models for SON use case
-- Use CPS for storing/retrieving RAN config data for this use case (stretch goal)
-- Configuration Management (CM) notifications over VES based on VES 7.2 (stretch goal)
+- Use CPS for storing/retrieving RAN config data for this use case (was stretch goal, partially addressed)
+- Configuration Management (CM) notifications over VES based on VES 7.2 (was stretch goal, partially addressed)
 
-The end-to-end setup for the use case requires a database which stores the cell related details of the RAN.
-This database is ConfigDB till we complete the transition to using CPS DB/TBDMT.
-The database is updated by SDN-C (R), and is accessed by SON-Handler MS and OOF for fetching (e.g., neighbor list, PNF id, etc):
+
+
+The end-to-end setup for the use case requires a database which stores the cell related details of the RAN. This database is ConfigDB till we complete the transition to using CPS DB/TBDMT. The database is updated by SDN-C (R), and is accessed by SON-Handler MS and OOF for fetching (e.g., neighbor list, PNF id, etc):
 
 - `The Config DB implementation <https://github.com/onap-oof-pci-poc/sdnc/tree/master/ConfigDB/Dublin>`_
 - `Swagger JSON API documentation <https://github.com/onap-oof-pci-poc/sdnc/blob/master/ConfigDB/Dublin/SDNC_ConfigDB_API_v3.0.0.json>`_
 
-As part of Istanbul release work, progress was made towards the goal of transitioning from ConfigDB to CPS DB.
-CPS DB is fully based on yang models, and we have developed a modeling approach using two yang models:
-- Primary model: (e.g., ran-network). This is a modular sub-set of, and fully aligned with, ORAN/3GPP 28.541 NRM yang model
-  This aligns with Device models, Vendor models (base and extensions)
-- Secondary model: (e.g, cps-ran-schema-model) This model captures ata which is not present in ORAN model,
-  e.g., region-to-cell (CU) mapping, latitude/longitude of DU. This also has derived information for
-  API/query efficiency, e.g., list of neighbor cells. This aligns with Operator network model for use cases and applications
+As part of Istanbul release work, progress was made towards the goal of transitioning from ConfigDB to CPS DB. CPS DB is fully based on yang models, and we have developed a modeling approach using two yang models:
+
+- Primary model: (e.g., ran-network). This is a modular sub-set of, and fully aligned with, ORAN/3GPP 28.541 NRM yang model. This aligns with device models and vendor models (base and extensions)
+
+- Secondary model: (e.g, cps-ran-schema-model) This model captures information which is not present in ORAN model, e.g., region-to-cell (CU) mapping, latitude/longitude of DU. This also has derived information for API/query efficiency, e.g., list of neighbor cells. This aligns with operator network model for use cases and applications.
 
 As part of this use case work, a RAN Simulator providing a simulated Radio Access Network
 (RAN) with a number of netconf servers simulating PNF elements has been implemented. The
@@ -101,4 +89,4 @@ Known Issues and Resolutions
     Loop tries to operate on the same target (in this case, a PNF) is successfully tested. The CLC is also applied at Control
     Loop level only. However, some code updates are required in Policy to properly update the Operations History DB entry, and
     to check the existence of active Control Loops by Policy. This will be addressed in Jakarta release, and tracked via
-    https://jira.onap.org/browse/POLICY-2484
+    https://jira.onap.org/browse/POLICY-2484
\ No newline at end of file
diff --git a/docs/files/csv/usecases.csv b/docs/files/csv/usecases.csv
index 429d2d394..ad91ffd54 100644
--- a/docs/files/csv/usecases.csv
+++ b/docs/files/csv/usecases.csv
@@ -1,4 +1,4 @@
 Ref;Summary;Link;Contacts
 REQ-440;E2E Network Slicing;:ref:`official doc <docs_E2E_network_slicing>`;Lin Meng
-REQ-429;5G OOF SON;:ref:`official doc <docs_5G_oof_pci>`;Swaminathan Seetharaman
+REQ-429;5G OOF SON;:ref:`official doc <docs_5G_oof_son>`;Swaminathan Seetharaman
 REQ-459;CCVPN-Transport Slicing;:ref:`official doc <docs_ccvpn>`;Henry Yu