X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Findex.rst;h=0580a9e65b7cd7b3cf13c7577df4de80a98f0b98;hb=refs%2Fheads%2Fmaster;hp=deac4d2df60c33674c0fac3d15e8b2eda57cadc3;hpb=efd104965f09ccfedc9efb5692cbd7a0e04ef6ce;p=aai%2Fsparky-be.git

diff --git a/docs/index.rst b/docs/index.rst
index deac4d2..0580a9e 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,88 +1,28 @@
 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. _master_index:
 
+=============================
 Sparky - Inventory UI Service
-==============================
+=============================
 
+.. image:: https://bestpractices.coreinfrastructure.org/projects/1737/badge
+   :height: 30px
+   :width: 200 px
+   :scale: 100 %
+   :alt: alternate text
+   :align: right
+   :target: https://bestpractices.coreinfrastructure.org/projects/1737
 
-***************
 Overview
-***************
-Sparky a service that interacts with AAI and provides users a UI to view and analyze AAI data. The main goal behind _Sparky_ is providing a more user friendly and clear view of AAI data.
+========
+Sparky is a service that interacts with resources and traversal microservices, and provides users with a user interface to view and analyze AAI data. The main goal behind Sparky is to provide a clear and user friendly view of AAI data.
 
-At this time, _Sparky_ has two views available for use:
+The key AAI repos for running the Sparky UI are:
 
-[View and Inspect](./VIEW_INSPECT.md) - Graph based view of entities within AAI.
+- aai/sparky-fe: This holds the code that constructs the GUI
+- aai/sparky-be: This holds the Java code and other technologies that provide the front-end with its data.
 
-[VNFs](./VNFS.md) - Aggregation based view of VNFs within AAI.
+.. toctree::
+   :maxdepth: 2
 
-
-===============
-Getting Started
-===============
-
-
-Building _Sparky_
------------------
-After cloning the project, execute the following Maven command from the project's top level directory to build the project:
-
-    > mvn clean install
-
-After a successful install, build the docker image:
-
-    > docker build -t onap/sparky target
-
-Deploying _Sparky_
-------------------
-
-Push the Docker image that you have built to your Docker repository and pull it down to the location that you will be running _Sparky_.
-
-**Create the following directories on the host machine:**
-
-    /logs
-    /opt/app/sparky/appconfig
-
-You will be mounting these as data volumes when you start the Docker container.
-
-Clone Configuration Repo
-------------------------
-
-Clone the "test-config" repo to a seperate directory.
-Navigate to <test-config repo location>/sparky/appconfig (will contain files such as aai.properties).
-Copy the entire contents of <test-config repo location>/sparky/appconfig into the /opt/app/sparky/appconfig directory you created in an above step.
-
-====================================================
-Edits to property files in /opt/app/sparky/appconfig
-====================================================
-
-Listed below are the values that will need to be updated to make _Sparky_ operate properly. The config files contain comments on the contents not listed here.
-
-**search-service.properties**
-
-search-service.ipAddress=<ip address / hostname of the search-data-service that this instance will use>
-search-service.httpPort=<http port of the search-data-service that this instance will use>
-
-**aai.properties**
-
-aai.rest.host=<ip address / hostname of the aai that this instance will use>
-aai.rest.port=<rest port of the aai that this instance will use>
-
-**elasticsearch.properties**
-
-elasticsearch.ipAddress=<ip address / hostname of the elasticsearch that this instance will use>
-elasticsearch.httpPort=<http port of the elasticsearch that this instance will use>
-elasticsearch.javaApiPort=<java api port of the elasticsearch that this instance will use>
-
-**portal/portal.properties**
-**portal/portal-authentication.properties**
-
-If this instance of _Sparky_ will be served in an ONAP Portal instance, use the two files above to configure against the proper Portal instance.
-
-============
-Dependencies
-============
-_Sparky_ requires:
-
-- AAI instance as the main driver behind data.
-- Elasticsearch instance for data storage.
-- search-data-service instance for search functionality.
-- ONAP Portal instance for authentication.
+   platform/index.rst