.. ===============LICENSE_START=======================================================
.. O-RAN SC CC-BY-4.0
.. %%
-.. Copyright (C) 2019 AT&T Intellectual Property and Nokia
+.. Copyright (C) 2019 AT&T Intellectual Property
.. %%
.. Licensed under the Apache License, Version 2.0 (the "License");
.. you may not use this file except in compliance with the License.
RIC Dashboard Developer Guide
=============================
-This document provides a quickstart for developers of the O-RAN SC RIC Dashboard web application.
+This document provides a quickstart for developers of the O-RAN SC RIC Dashboard web
+application.
Prerequisites
-------------
1. Java development kit (JDK), version 11 or later
2. Maven dependency-management tool, version 3.4 or later
-Other tools including the Node Package Manager (npm) are fetched dynamically.
+Other required tools including the Node Package Manager (npm) are fetched dynamically.
+
+Clone and Update Submodules
+---------------------------
+
+After cloning the repository, initialize and update all git submodules like this::
+
+ git submodule init
+ git submodule update
+
+Check the submodule status at any time like this::
+
+ git submodule status
+
Angular Front-End Application
-----------------------------
The server uses the ONAP Portal's "EPSDK-FW" library to support a
single-sign-on (SSO) feature, which requires users to authenticate
-at the ONAP Portal UI.
+at the ONAP Portal UI. The RIC Dashboard can be on-boarded as an
+application on the ONAP Portal using its application on-boarding UI.
The server authenticates requests using cookies that are set
by the ONAP Portal::