X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=docs%2Fapi-docs.rst;h=7c6b6c2561c423e16af63db66bc5715098ed37d5;hb=2918bef3d237c99e6cf7e9c1ab1722781128617b;hp=a2964601d0f7e8f7572fcceb383306da50479a66;hpb=e94200843789d401cd13a3b87dc19ae0cc73974f;p=nonrtric.git

diff --git a/docs/api-docs.rst b/docs/api-docs.rst
index a2964601..7c6b6c25 100644
--- a/docs/api-docs.rst
+++ b/docs/api-docs.rst
@@ -1,51 +1,86 @@
 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
 .. http://creativecommons.org/licenses/by/4.0
+.. Copyright (C) 2021 Nordix
 
+.. _api_docs:
 
+.. |swagger-icon| image:: ./images/swagger.png
+                  :width: 40px
 
+.. |yaml-icon| image:: ./images/yaml_logo.png
+                  :width: 40px
+
+
+========
 API-Docs
 ========
 
-This is the API-docs of Non-RT RIC.
+Here we describe the APIs to access the Non-RT RIC functions.
+
+The core Non-RT RIC consists of several parts, with available APIs described in the sections below:
+
+* The A1 Policy Management Service
+* The Information Coordinator Service
+* DMaaP Adaptor
+* K8S Helm Chart LCM Manager (Initial) **<ToDo>**
+
+A1 Policy Management Service
+============================
+
+For information about the A1 Policy Management Service that is implemented in ONAP, see `ONAP docs <https://docs.onap.org/projects/onap-ccsdk-oran/en/latest/index.html>`_ and `wiki <https://wiki.onap.org/pages/viewpage.action?pageId=84672221>`_.
+
+Information Coordinator Service
+===============================
+
+See `A1 Information Information Coordination Service API <./ics-api.html>`_ for full details of the API.
+
+The API is also described in Swagger-JSON and YAML:
+
+.. csv-table::
+   :header: "API name", "|swagger-icon|", "|yaml-icon|"
+   :widths: 10,5,5
 
-.. contents::
-   :depth: 3
-   :local:
+   "A1 Information Coordination Service API", ":download:`link <../information-coordinator-service/api/ics-api.json>`", ":download:`link <../information-coordinator-service/api/ics-api.yaml>`"
 
-API Introduction
------------------
+DMaaP Adaptor
+=============
 
-The Non-RT RIC dashboard is an interface that allows human users to create, edit and delete policy instances, for each existing policy type. The policy types are owned by the Near-RT RIC, Non-RT RIC can just query them, so it's not possible to act on them.
+The DMaaP Adaptor provides support for push delivery of any data received from DMaaP or Kafka.
 
+See `DMaaP Adaptor API <./dmaap-adaptor-api.html>`_ for full details of the API.
 
-API Functions
--------------
+The API is also described in Swagger-JSON and YAML:
 
-To run the dashboard locally, you can follow these steps:
 
-- Fetch the latest code from `gerrit`_
+.. csv-table::
+   :header: "API name", "|swagger-icon|", "|yaml-icon|"
+   :widths: 10,5, 5
 
-.. _gerrit: https://gerrit.nordix.org/c/oransc/nonrtric/+/2747/
+   "DMaaP Adaptor API", ":download:`link <../dmaap-adaptor-java/api/api.json>`", ":download:`link <../dmaap-adaptor-java/api/api.yaml>`"
 
-- Before compiling, run the following commands::
+K8S Helm Chart LCM Manager (Initial)
+====================================
 
-    git submodule init
+**<ToDo>**
 
-    git submodule update
+See Also: Non-RT RIC Control Panel
+==================================
 
-- Start the backend (you might have to build it first)::
+The Non-RT RIC Control Panel provides a user interface that allows the user to interact with the Non-RT RIC.
 
-    mvn clean install
+Documentation for the Control Panel can be found here: `Non-RT RIC Control Panel <https://docs.o-ran-sc.org/projects/o-ran-sc-portal-nonrtric-controlpanel/en/latest/>`_.
 
-    mvn -Dorg.oransc.ric.portal.dashboard=mock -Dtest=DashboardTestServer -DfailIfNoTests=false test
+It can be downloaded from here: ::
 
+  git clone "https://gerrit.o-ran-sc.org/r/portal/nonrtric-controlpanel".
 
-- Now you can open URL:  `localhost:8080`_ in a browser. 
+See Also: A1 / Near-RT RIC simulator
+====================================
 
-.. _localhost:8080: localhost:8080
+The Near-RT RIC simulator simulates an A1 protocol termination endpoint.
 
-From the main page, click on the "Policy Control" card. From here, it is possible to create or list instances for each existing policy type.
+Documentation for the simulator can be found here: `A1 Interface Simulator <https://docs.o-ran-sc.org/projects/o-ran-sc-sim-a1-interface/en/latest/>`_.
 
-When the instances are listed, it is possible to edit or delete each instance from the expanded view.
+It can be downloaded from here: ::
 
-.. image:: ./images/non-RT_RIC_dashboard.png
\ No newline at end of file
+  git clone "https://gerrit.o-ran-sc.org/r/sim/a1-interface"