Merge "Clean-up using onap section"

1 files changed, 49 insertions, 4 deletions

diff --git a/docs/guides/onap-user/platformadmin.rst b/docs/guides/onap-user/platformadmin.rst
index 8c1fb2e6b..c0db9d6b1 100644
--- a/docs/guides/onap-user/platformadmin.rst
+++ b/docs/guides/onap-user/platformadmin.rst
@@ -2,10 +2,55 @@
 .. http://creativecommons.org/licenses/by/4.0
 .. Copyright 2017 AT&T Intellectual Property.  All rights reserved.
 
-User Portal
+
+ONAP Portal
 ===========
-.. note::
-   Until this section is migrated to gerrit/readthedocs, use the link below.
+The ONAP Portal integrates different ONAP applications in one place.
+The Portal platform provides common management services and
+connectivity, while the applications run separately.
+
+From the Portal, users access applications. Administrators
+onboard and manage applications and widgets, and manage user access.
+
+The Portal SDK for application developers includes bundled tools,
+technologies, and built-in capabilities such as services, APIs,
+and UI controls. Existing applications can migrate to the Portal
+with the provided APIs and libraries.
+See :ref:`Portal SDK <portal-sdk>`
+
+Access the ONAP Portal
+----------------------
+
+Access the ONAP Portal using a browser such as Mozilla Firefox or
+Google Chrome. The URL is dependent on a specific ONAP platform
+deployment.
+
+From the Portal, users access applications directly or by
+function using the Manage menu.
+
+.. figure:: onap-portal-home.png
+   :width: 900 px
+   :height: 600 px
+
+
+Roles in the ONAP Portal
+------------------------
+The Portal displays different menus for the following roles:
+
+* User
+
+* Portal Administrator
+
+* Application Administrator
+
+* Governor
+
+* Operator
+
+Each application also defines a distinct set of user roles.
+See Users.
 
-* `User Portal  <https://wiki.onap.org/x/fIsP>`_
+See also
+--------
 
+* `Applications in the Portal <https://wiki.onap.org/x/h4sP>`_