diff --git a/docs/guides/onap-operator/index.rst b/docs/guides/onap-operator/index.rst
index e464c24..ed11438 100644
--- a/docs/guides/onap-operator/index.rst
+++ b/docs/guides/onap-operator/index.rst
@@ -16,3 +16,4 @@
    settingup/index.rst
    platformoperations.rst
    cloud_site/index.rst
+   onap-portal-admin/onap-portal-admin.rst
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/1018906_ep_home_editwidget.png b/docs/guides/onap-operator/onap-portal-admin/attachments/1018906_ep_home_editwidget.png
new file mode 100644
index 0000000..6490e9c
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/1018906_ep_home_editwidget.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/1018932_ep_trash_icon.png b/docs/guides/onap-operator/onap-portal-admin/attachments/1018932_ep_trash_icon.png
new file mode 100644
index 0000000..77ce4ad
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/1018932_ep_trash_icon.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/1018942_ep_editmenu_edit.png b/docs/guides/onap-operator/onap-portal-admin/attachments/1018942_ep_editmenu_edit.png
new file mode 100644
index 0000000..c628abe
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/1018942_ep_editmenu_edit.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004284_image2017-10-27_14-14-37.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004284_image2017-10-27_14-14-37.png
new file mode 100644
index 0000000..1178279
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004284_image2017-10-27_14-14-37.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004288_image2017-10-27_14-17-0.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004288_image2017-10-27_14-17-0.png
new file mode 100644
index 0000000..317f1e7
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004288_image2017-10-27_14-17-0.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004295_image2017-10-27_14-23-38.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004295_image2017-10-27_14-23-38.png
new file mode 100644
index 0000000..a68086f
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004295_image2017-10-27_14-23-38.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004297_image2017-10-27_14-26-38.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004297_image2017-10-27_14-26-38.png
new file mode 100644
index 0000000..dc5ede8
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004297_image2017-10-27_14-26-38.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004301_image2017-10-27_14-30-33.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004301_image2017-10-27_14-30-33.png
new file mode 100644
index 0000000..17f40be
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004301_image2017-10-27_14-30-33.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004303_image2017-10-27_14-30-51.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004303_image2017-10-27_14-30-51.png
new file mode 100644
index 0000000..17f40be
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004303_image2017-10-27_14-30-51.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004306_image2017-10-27_14-35-46.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004306_image2017-10-27_14-35-46.png
new file mode 100644
index 0000000..c02a775
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004306_image2017-10-27_14-35-46.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004309_image2017-10-27_14-41-13.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004309_image2017-10-27_14-41-13.png
new file mode 100644
index 0000000..50cf6e7
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004309_image2017-10-27_14-41-13.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004321_image2017-10-27_15-21-13.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004321_image2017-10-27_15-21-13.png
new file mode 100644
index 0000000..2f5e756
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004321_image2017-10-27_15-21-13.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004324_image2017-10-27_15-24-5.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004324_image2017-10-27_15-24-5.png
new file mode 100644
index 0000000..e08ea6b
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004324_image2017-10-27_15-24-5.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004327_image2017-10-27_15-27-1.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004327_image2017-10-27_15-27-1.png
new file mode 100644
index 0000000..fa976c7
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004327_image2017-10-27_15-27-1.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004329_image2017-10-27_15-28-31.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004329_image2017-10-27_15-28-31.png
new file mode 100644
index 0000000..ea17b5c
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004329_image2017-10-27_15-28-31.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004338_image2017-10-27_15-51-18.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004338_image2017-10-27_15-51-18.png
new file mode 100644
index 0000000..90de6ee
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004338_image2017-10-27_15-51-18.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004340_image2017-10-27_15-52-28.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004340_image2017-10-27_15-52-28.png
new file mode 100644
index 0000000..9d181e8
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004340_image2017-10-27_15-52-28.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004343_image2017-10-27_15-56-53.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004343_image2017-10-27_15-56-53.png
new file mode 100644
index 0000000..4e89725
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004343_image2017-10-27_15-56-53.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004915_image2017-10-31_10-49-27.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004915_image2017-10-31_10-49-27.png
new file mode 100644
index 0000000..5d9240c
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004915_image2017-10-31_10-49-27.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004934_image2017-10-31_11-12-22.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004934_image2017-10-31_11-12-22.png
new file mode 100644
index 0000000..5bbd737
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004934_image2017-10-31_11-12-22.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004936_image2017-10-31_11-16-14.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004936_image2017-10-31_11-16-14.png
new file mode 100644
index 0000000..45b76fa
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004936_image2017-10-31_11-16-14.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004943_image2017-10-31_11-21-2.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004943_image2017-10-31_11-21-2.png
new file mode 100644
index 0000000..06f476d
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004943_image2017-10-31_11-21-2.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004944_image2017-10-31_11-23-15.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004944_image2017-10-31_11-23-15.png
new file mode 100644
index 0000000..c3f2c3c
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004944_image2017-10-31_11-23-15.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004954_image2017-10-31_11-29-12.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004954_image2017-10-31_11-29-12.png
new file mode 100644
index 0000000..7d3bae6
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004954_image2017-10-31_11-29-12.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004962_image2017-10-31_11-34-8.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004962_image2017-10-31_11-34-8.png
new file mode 100644
index 0000000..05bf69d
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004962_image2017-10-31_11-34-8.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004980_image2017-10-31_12-21-53.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004980_image2017-10-31_12-21-53.png
new file mode 100644
index 0000000..454c6b9
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004980_image2017-10-31_12-21-53.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/20086818_image2017-12-5_14-53-43.png b/docs/guides/onap-operator/onap-portal-admin/attachments/20086818_image2017-12-5_14-53-43.png
new file mode 100644
index 0000000..e7b808d
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/20086818_image2017-12-5_14-53-43.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/20086819_image2017-12-5_14-57-22.png b/docs/guides/onap-operator/onap-portal-admin/attachments/20086819_image2017-12-5_14-57-22.png
new file mode 100644
index 0000000..977808e
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/20086819_image2017-12-5_14-57-22.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/20086820_image2017-12-5_15-8-37.png b/docs/guides/onap-operator/onap-portal-admin/attachments/20086820_image2017-12-5_15-8-37.png
new file mode 100644
index 0000000..88626ea
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/20086820_image2017-12-5_15-8-37.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/20086821_image2017-12-5_15-9-27.png b/docs/guides/onap-operator/onap-portal-admin/attachments/20086821_image2017-12-5_15-9-27.png
new file mode 100644
index 0000000..516adc7
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/20086821_image2017-12-5_15-9-27.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/20086839_image2017-12-5_16-52-40.png b/docs/guides/onap-operator/onap-portal-admin/attachments/20086839_image2017-12-5_16-52-40.png
new file mode 100644
index 0000000..1662438
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/20086839_image2017-12-5_16-52-40.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/20086846_image2017-12-5_16-57-24.png b/docs/guides/onap-operator/onap-portal-admin/attachments/20086846_image2017-12-5_16-57-24.png
new file mode 100644
index 0000000..c2c361f
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/20086846_image2017-12-5_16-57-24.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/onap-portal-admin.rst b/docs/guides/onap-operator/onap-portal-admin/onap-portal-admin.rst
new file mode 100644
index 0000000..81d42f6
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/onap-portal-admin.rst
@@ -0,0 +1,664 @@
+|image2017-10-27_15-56-53.png|
+
+ONAP Portal for Administrators
+==============================
+
+General
+-------
+
+The ONAP Portal platform integrates different ONAP applications into a
+central core. 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 `ONAP Portal SDK
+Documentation <http://onap.readthedocs.io/en/latest/submodules/portal.git/docs/tutorials/index.html>`__\.
+
+Access
+------
+
+Access the ONAP Portal using Mozilla Firefox or Google Chrome(win/mac)
+at the provided URL. For example: `https://<hostname:port>/ONAPPORTAL/login.html`.
+
+Access the ONAP portal via the 8989 LoadBalancer documented `here <https://onap.readthedocs.io/en/latest/submodules/oom.git/docs/oom_user_guide.html#accessing-the-onap-portal-using-oom-and-a-kubernetes-cluster>`__
+
+From the Portal, users access applications directly or by function using
+the `Manage menu`.
+
+See also:
+
+-  `Applications in the Portal`
+
+-  `Application Catalog`
+
+Roles
+-----
+
+The Portal displays different menus for the following functions:
+
+-  Users
+
+-  Portal Admins
+
+-  Application Admins
+
+-  Governor
+
+-  Operator
+
+Each application also defines a distinct set of user roles. See *Users* .
+
+
+Admin Tasks
+-----------
+
+From the ONAP Portal, administrators:
+
+-  access the same functionality accessible to users (see `ONAP Portal
+   for users <#PAGE_1018759>`__)
+
+-  manage users and application admins
+
+-  onboard applications and widgets
+
+-  edit the functional menu
+
+Administrators see the following menu when accessing the ONAP Portal:
+
+|image2017-10-27_14-14-37.png|
+
+Left menu descriptions:
+
+.. _PAGE_1018764:
+
+Admins Menu
+-----------
+
+Use the Admins section to:
+
+|image2017-10-27_14-17-0.png|
+
+View or search for application admins
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From the ONAP Portal Home, click Admins in the left menu.
+
+#. View or search for admins:
+
+-  The Admins table shows all admins in alphabetical order by first
+   name. Select an application from the dropdown list to view admins for
+   a single application.
+
+-  Search for an admin by entering a full or partial search term in the
+   search box. Search by first name, last name, or user ID. Searches are
+   not case-sensitive.
+
+-  Filter further using a combination of the applications dropdown and
+   the search box.
+
+Add an application admin
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From the ONAP Portal Home, click Admins in the left menu.
+
+#. Click Add Admin.The New Admin window displays.
+
+#. Enter any combination of the user's first name, last name in the
+   search field and click Search.Note: A minimum of three characters is
+   required to search.
+
+#. Select the user from the results and click Next.
+
+|image2017-10-27_14-23-38.png|
+
+#. Select an application from the dropdown list.
+
+|image2017-10-27_14-26-38.png|
+
+#. Click Save.
+
+The user can administer and manage users for the applications listed in
+the Admins table.
+
+Modify application admin privileges
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From the ONAP Portal Home, click Admins in the left menu.
+
+#. Search for an admin and then select one by clicking the row in the
+   Admins table (see `View or search for application admins`.
+
+#. Modify the admin's application privileges:
+
+-  Add an application to the Administrates list by selecting it from the
+   dropdown list
+
+-  Delete an application from the Administrates list by clicking the
+   trash icon
+
+|image2017-10-27_14-30-33.png| .
+
+#. Click Save.
+
+Delete an application admin
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To delete an application admin completely, first remove access for each
+application.
+
+#. From the ONAP Portal Home, click Admins in the left menu.
+
+#. Search for a name and then select one by clicking the row in the
+   Admins table (see `View or search for application admins`.
+
+#. Click the trash icon
+
+|image2017-10-27_14-30-51.png|  and click OK to confirm for each
+application in the Administrates list.
+
+#. Click Save.
+
+The application Admin is removed from the table. The Admin is only
+removed from the Admins table when they have no application access.
+
+
+Users Menu
+----------
+
+Use the Users section to:
+
+|image2017-10-27_14-35-46.png|
+
+View or search for users
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From ONAP Portal Home, click Users in the left menu.
+
+#. Select an application from the dropdown list.
+
+#. Enter a full or partial first name, last, name, user ID, or role in
+   the search box; or click the column header to sort that column in
+   alphabetical or reverse alphabetical order.
+
+Add a user
+~~~~~~~~~~
+
+Portal admins can add or manage users for any application. Application
+admins can only add and manage users for their specific applications.
+
+#. From ONAP Portal Home, click Users in the left menu.
+
+#. Click Add User.
+
+#. The New User window displays.
+
+#. Search for or add a new user:
+
+-  To search for a user, enter the user's complete first name, last
+   name, or user ID and click search.
+
+-  To add a new user, click New User, fill in the user details, and
+   click Add New User. The new user appears in the results list.
+
+#. Select the user from the results and click Next.
+
+|image2017-10-27_14-41-13.png|
+
+#. Select a role from the dropdown lists for each application required
+   by the user.
+
+#. Click Save.
+
+The user can access the applications with the roles listed in the Users
+table.
+
+Modify users and roles
+~~~~~~~~~~~~~~~~~~~~~~
+
+#. From ONAP Portal Home, click Users in the left menu.
+
+#. Select an application from the dropdown, search for a user, and
+   select one by clicking the row in the Users table. The user's access
+   and roles display.
+
+|image2017-10-27_15-21-13.png|
+
+#. Modify the user's role for each application:
+
+-  Add or change a user role by selecting or clearing the role from the
+   dropdown list.
+
+-  Remove all the user's roles for an application by clicking the trash
+   icon
+
+|ep_trash_icon.png| .
+
+#. Click Save.
+
+Delete a user
+~~~~~~~~~~~~~
+
+To delete a user completely, remove access for each application.
+
+#. From the ONAP Portal Home, click Users in the left menu.
+
+#. Select an application from the dropdown, search for a user, then
+   click the row in the Users table to select (see `View or search for
+   users`.
+   The user's access and roles display.
+
+#. Click the trash icon
+
+|ep_trash_icon.png|  beside an application and click OK to confirm.
+
+#. Click Save.
+
+The User is removed from the applications. The User is only removed from
+the Users table when they have no application access.
+
+Portal Admins
+-------------
+
+Use the Portal Admins section to:
+
+|image2017-10-27_15-24-5.png|
+
+View or search for Portal Admins
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From ONAP Portal Home, click Portal Admins in the left menu.
+
+#. Enter a full or partial first name, last, name, or ATTUID in the
+   search box, or click the sorting arrows in any column to sort that
+   column in alphabetical or reverse alphabetical order.
+
+Add a Portal Admin
+~~~~~~~~~~~~~~~~~~
+
+Only Portal Admins can add or delete other Portal Admins.
+
+#. From the ONAP Portal Home, click Portal Admins in the left menu.
+
+#. Click Add Portal Admin. The Add New Portal Admin window displays.
+
+#. Search for or add a new user:
+
+-  To search for a user, enter the user's complete first name, last
+   name, or user ID and click search.
+
+-  To add a new user, click New User, fill in the user details, and
+   click Add New User. The new user appears in the results list.
+
+#. Select the user from the results and click Save.
+
+The user is listed in the Portal Admins table and can manage users and
+admins.
+
+Delete a Portal Admin
+~~~~~~~~~~~~~~~~~~~~~
+
+Only Portal Admins can add or delete other Portal Admins.
+
+#. From ONAP Portal Home, click Portal Admins in the left menu.
+
+#. Search for or scroll to a name in the Portal Admins table and click
+   the trash icon in the Delete column.
+
+#. Click OK to confirm.
+
+The Portal Admin is removed from the table.
+
+Application Onboarding
+----------------------
+
+Use the Application Onboarding section to:
+
+|image2017-10-27_15-27-1.png|
+
+Add an application to the Portal
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From the ONAP Portal Home, click Application Onboarding in the left
+   menu.
+
+#. Click Add App.
+
+#. The Application Details window displays.
+
+|image2017-10-27_15-28-31.png|
+
+4. Fill out the fields as described in the table:
+
++---------------------------+------------------------------------------+
+| **Hyperlink only          | Select to add an application with a URL  |
+| application**             | only.                                    |
++===========================+==========================================+
+| **Application name**      | Application name to display in the       |
+|                           | Portal.                                  |
++---------------------------+------------------------------------------+
+| **URL**                   | Application landing page for             |
+|                           | hyperlink-only applications.             |
++---------------------------+------------------------------------------+
+| **REST API URL**          | [Optional] The endpoint for RESTful API  |
+|                           | calls.                                   |
++---------------------------+------------------------------------------+
+| **Username**              | The username for the RESTful API calls.  |
+|                           | Default = Default                        |
++---------------------------+------------------------------------------+
+| **Password**              | Password for the RESTful API call.       |
+|                           | Default = AppPassword!1                  |
++---------------------------+------------------------------------------+
+| **Name Space**            | Namespace value when Application         |
+|                           | registered in AAF.                       |
++---------------------------+------------------------------------------+
+| **Communication Inbox**   | Do not fill out. Populated by the        |
+|                           | application.                             |
++---------------------------+------------------------------------------+
+| **Communication Key**     | Do not fill out. Populated by the        |
+|                           | application.                             |
++---------------------------+------------------------------------------+
+| **Communication Secret**  | Do not fill out. Populated by the        |
+|                           | application.                             |
++---------------------------+------------------------------------------+
+| **Upload image**          | Click Browse to select the application   |
+|                           | image to display in the ONAP Portal.     |
++---------------------------+------------------------------------------+
+| **Allow guest access**    | Select to allow access for users not     |
+|                           | listed as Users or Admins.               |
++---------------------------+------------------------------------------+
+| **Active**                | Select to make the application active.   |
++---------------------------+------------------------------------------+
+| **Centralized**           | Indicate this application is using AAF   |
+|                           | for centralized role management.         |
++---------------------------+------------------------------------------+
+
+5. Click Save.
+
+The application appears in the Applications section and in the
+Application Onboarding table. The Portal Admin receives an email with
+Communications details.
+
+6. Add the application URL to the appropriate Manage menu items:
+
+#. Click Edit Functional Menu in the left menu.
+
+#. Expand the Manage menu to find the correct items.
+
+#. Right-click an item and select Edit.
+
+|ep_editmenu_edit.png|
+
+#. In the URL field, enter the server URL of the new application and
+   click Save.
+
+Collect and forward application communication details
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The Portal administrator forwards communications details and a list of
+servers to the application developer. The application developer adds the
+details to the portal-properties file located in \\<app web
+directory>/WEB-INF/classes.
+
+**Prerequisites:** *Add an application to the Portal*
+
+#. Collect the following details and send them to the application
+   developer.
+
++----------------------------------------+-----------------------------+
+| Key-value pair                         | Obtain from                 |
++========================================+=============================+
+| redirect_url = ** /**                  | The redirect URL defined    |
+| /process_csp                           | as ** /** /process_csp.     |
++----------------------------------------+-----------------------------+
+
+#. Request that the application developer:
+
+#. Add the key-value pairs above to the portal.properties file located
+   in ** /WEB-INF/classes.
+
+#. Add the key-value pair shared_context_rest_url = **  to the
+   system.properties file located in the ** /WEB-INF/conf directory.
+
+#. Restart the application
+
+Delete an application from the Portal
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From the ONAP Portal Home, click Widget Onboarding in the left menu.
+
+#. Search for or scroll to an application in the table and click the
+   trash icon
+
+|ep_trash_icon.png|  in the Delete column.
+
+#. Click OK to confirm.
+
+The application is removed from the Portal.
+
+Widget Onboarding
+-----------------
+
+Use the Widget Onboarding section to:
+
+|image2017-10-27_15-51-18.png|
+
+Add an application widget to the Portal
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From ONAP Portal Home, click Widget Onboarding in the left menu.
+
+#. Click Add Widget.
+
+The Widget Details window displays.
+
+|image2017-10-27_15-52-28.png|
+
+3. Fill out the fields as described in the following table.
+
++------------------+---------------------------------------------------+
+| **Application    | Select from a dropdown list of onboarded          |
+| Name**           | applications.                                     |
++==================+===================================================+
+| **Widget Name**  | The name for the widget that appears in the       |
+|                  | Widgets section of the Portal.                    |
++------------------+---------------------------------------------------+
+| **Width,         | Automatically populated fields.                   |
+| Height**         |                                                   |
++------------------+---------------------------------------------------+
+| **URL**          | Widget landing page.                              |
++------------------+---------------------------------------------------+
+
+4. Click Save.
+
+The widget appears in the Widgets section of the Portal. Users with
+permissions to the widget's application can access the widget.
+
+Remove a widget from the Portal
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From ONAP Portal Home, click Widget Onboarding in the left menu.
+
+#. Search for or scroll to a widget in the table and click the trash
+   icon
+
+|ep_trash_icon.png|  in the Delete column.
+
+#. Click OK to confirm.
+
+The widget is removed from the Portal.
+
+Edit Functional Menu
+--------------------
+
+Edit or rearrange the ONAP Portal functional menus in the Edit
+Functional Menu section.
+
+|image2017-10-31_11-12-22.png|
+
+ONAP Portal menus have 4 levels. The menu levels correspond to how and
+where the menu items appear in the Portal UI.
+
+|image2017-10-31_10-49-27.png|
+
+Use the Edit Functional Menu section to:
+
+Add a menu item
+~~~~~~~~~~~~~~~
+
+#. From ONAP Portal Home, click Edit Functional Menu in the left menu.
+
+#. Use the arrows to expand the menu, then right-click on the intended
+   parent menu item and select Add.
+
+|image2017-10-31_11-16-14.png|
+
+#. Enter a title for the menu item, then enter a URL or select the
+   application to link to from the App dropdown list.
+
+#. Click Save.
+
+#. Click Regenerate Menu to finalize the changes and update the menu.
+
+Edit a menu item
+~~~~~~~~~~~~~~~~
+
+#. From the ONAP Portal Home, click Edit Functional Menu in the left
+   menu.
+
+#. Use the arrows to expand the menu, then right-click on the menu item
+   and select Edit.
+
+#. Make changes to the title, URL, or application and click Continue.
+
+#. Click Regenerate Menu to finalize the changes and update the menu.
+
+|image2017-10-31_11-21-2.png|
+
+Move a menu item
+~~~~~~~~~~~~~~~~
+
+#. From ONAP Portal Home, click Edit Functional Menu in the left menu.
+
+#. Use the arrows to expand the menu.
+
+#. Click and drag a menu item to move it.A blue line appears to indicate
+   where the menu item will move. A blue box indicates the moved item
+   will be a child of that item.
+
+|image2017-10-31_11-23-15.png|
+
+#. Click Regenerate Menu to finalize the changes and update the menu.
+
+Delete a menu item
+~~~~~~~~~~~~~~~~~~
+
+A menu item with children cannot be deleted. Delete all child menu items
+first.
+
+#. From ONAP Portal Home, click Edit Functional Menu in the left menu.
+
+#. Use the arrows to expand the menu, then right-click on the menu item
+   and select Delete.
+
+#. Click OK
+
+#. Click Regenerate Menu to finalize the changes and update the menu.
+
+Portal Microservices Onboarding
+-------------------------------
+
+From left menu Microservice Onboarding section:
+
+|image2017-10-31_11-29-12.png|
+
+Add a microservice widget to the Portal
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From ONAP Portal Home, click Microservice Onboarding in the left
+   menu.
+
+#. Click Add Microservice.
+
+The Microservice Details window displays.
+
+|image2017-10-31_11-34-8.png|
+
+3. Fill out the fields as described in the following table.
+
++---------------------------------+------------------------------------+
+| **Field**                       | Explanation                        |
++=================================+====================================+
+| **Microservice Name**           | The name for the microservice that |
+|                                 | appears in the Microservice        |
+|                                 | section of the Portal.             |
++---------------------------------+------------------------------------+
+| **Microservice Description**    | Describe what the microservice     |
+|                                 | does                               |
++---------------------------------+------------------------------------+
+| **Application Name**            | Select from a dropdown list of     |
+|                                 | onboarded applications.            |
++---------------------------------+------------------------------------+
+| **Microservice End Point URL**  | Enter Microservice URL             |
++---------------------------------+------------------------------------+
+| **Security Type**               | Select from dropdown for           |
+|                                 | Authentication Method              |
++---------------------------------+------------------------------------+
+| **Add User Parameter**          | Enter parameter key and value if   |
+|                                 | applicable to microservice end     |
+|                                 | point URL                          |
++---------------------------------+------------------------------------+
+| **Active**                      | Active check/uncheck to show/hide  |
+|                                 | the microservice                   |
++---------------------------------+------------------------------------+
+
+4. Click Save.
+
+The microservice appears in the Microservices section of the Portal.
+Users with permissions to the Microservice application can access the
+microservice.
+
+Remove a microservice from the Portal
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From ONAP Portal Home, click Microservice Onboarding in the left
+   menu.
+
+#. Search for or scroll to a microservice in the table and click the
+   trash icon
+
+|ep_trash_icon.png|  in the Delete column.
+
+#. Click OK to confirm.
+
+The mocroservice is removed from the Portal.
+
+.. |image2017-10-27_15-56-53.png| image:: attachments/16004343_image2017-10-27_15-56-53.png
+.. |image2017-12-5_15-8-37.png| image:: attachments/20086820_image2017-12-5_15-8-37.png
+.. |image2017-10-27_14-14-37.png| image:: attachments/16004284_image2017-10-27_14-14-37.png
+.. |image2017-10-27_14-17-0.png| image:: attachments/16004288_image2017-10-27_14-17-0.png
+.. |image2017-10-27_14-23-38.png| image:: attachments/16004295_image2017-10-27_14-23-38.png
+.. |image2017-10-27_14-26-38.png| image:: attachments/16004297_image2017-10-27_14-26-38.png
+.. |image2017-10-27_14-30-33.png| image:: attachments/16004301_image2017-10-27_14-30-33.png
+.. |image2017-10-27_14-30-51.png| image:: attachments/16004303_image2017-10-27_14-30-51.png
+.. |image2017-10-27_14-35-46.png| image:: attachments/16004306_image2017-10-27_14-35-46.png
+.. |image2017-10-27_14-41-13.png| image:: attachments/16004309_image2017-10-27_14-41-13.png
+.. |image2017-10-27_15-21-13.png| image:: attachments/16004321_image2017-10-27_15-21-13.png
+.. |ep_trash_icon.png| image:: attachments/1018932_ep_trash_icon.png
+.. |image2017-10-27_15-24-5.png| image:: attachments/16004324_image2017-10-27_15-24-5.png
+.. |image2017-10-27_15-27-1.png| image:: attachments/16004327_image2017-10-27_15-27-1.png
+.. |image2017-10-27_15-28-31.png| image:: attachments/16004329_image2017-10-27_15-28-31.png
+.. |ep_editmenu_edit.png| image:: attachments/1018942_ep_editmenu_edit.png
+.. |image2017-10-27_15-51-18.png| image:: attachments/16004338_image2017-10-27_15-51-18.png
+.. |image2017-10-27_15-52-28.png| image:: attachments/16004340_image2017-10-27_15-52-28.png
+.. |image2017-10-31_11-12-22.png| image:: attachments/16004934_image2017-10-31_11-12-22.png
+.. |image2017-10-31_10-49-27.png| image:: attachments/16004915_image2017-10-31_10-49-27.png
+.. |image2017-10-31_11-16-14.png| image:: attachments/16004936_image2017-10-31_11-16-14.png
+.. |image2017-10-31_11-21-2.png| image:: attachments/16004943_image2017-10-31_11-21-2.png
+.. |image2017-10-31_11-23-15.png| image:: attachments/16004944_image2017-10-31_11-23-15.png
+.. |image2017-10-31_11-29-12.png| image:: attachments/16004954_image2017-10-31_11-29-12.png
+.. |image2017-10-31_11-34-8.png| image:: attachments/16004962_image2017-10-31_11-34-8.png
diff --git a/docs/guides/onap-user/index.rst b/docs/guides/onap-user/index.rst
index c431b31..f8ca1eb 100644
--- a/docs/guides/onap-user/index.rst
+++ b/docs/guides/onap-user/index.rst
@@ -13,7 +13,7 @@
 .. toctree::
    :maxdepth: 1
 
-   onapportal.rst
+   onap-portal-user/onap-portal-user.rst
    design/index.rst
    instantiate/index.rst
    configure/index.rst
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/1018906_ep_home_editwidget.png b/docs/guides/onap-user/onap-portal-user/attachments/1018906_ep_home_editwidget.png
new file mode 100644
index 0000000..6490e9c
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/1018906_ep_home_editwidget.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/16004284_image2017-10-27_14-14-37.png b/docs/guides/onap-user/onap-portal-user/attachments/16004284_image2017-10-27_14-14-37.png
new file mode 100644
index 0000000..1178279
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/16004284_image2017-10-27_14-14-37.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/16004343_image2017-10-27_15-56-53.png b/docs/guides/onap-user/onap-portal-user/attachments/16004343_image2017-10-27_15-56-53.png
new file mode 100644
index 0000000..4e89725
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/16004343_image2017-10-27_15-56-53.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/16004980_image2017-10-31_12-21-53.png b/docs/guides/onap-user/onap-portal-user/attachments/16004980_image2017-10-31_12-21-53.png
new file mode 100644
index 0000000..454c6b9
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/16004980_image2017-10-31_12-21-53.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/20086818_image2017-12-5_14-53-43.png b/docs/guides/onap-user/onap-portal-user/attachments/20086818_image2017-12-5_14-53-43.png
new file mode 100644
index 0000000..e7b808d
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/20086818_image2017-12-5_14-53-43.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/20086819_image2017-12-5_14-57-22.png b/docs/guides/onap-user/onap-portal-user/attachments/20086819_image2017-12-5_14-57-22.png
new file mode 100644
index 0000000..977808e
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/20086819_image2017-12-5_14-57-22.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/20086820_image2017-12-5_15-8-37.png b/docs/guides/onap-user/onap-portal-user/attachments/20086820_image2017-12-5_15-8-37.png
new file mode 100644
index 0000000..88626ea
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/20086820_image2017-12-5_15-8-37.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/20086821_image2017-12-5_15-9-27.png b/docs/guides/onap-user/onap-portal-user/attachments/20086821_image2017-12-5_15-9-27.png
new file mode 100644
index 0000000..516adc7
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/20086821_image2017-12-5_15-9-27.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/20086839_image2017-12-5_16-52-40.png b/docs/guides/onap-user/onap-portal-user/attachments/20086839_image2017-12-5_16-52-40.png
new file mode 100644
index 0000000..1662438
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/20086839_image2017-12-5_16-52-40.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/20086846_image2017-12-5_16-57-24.png b/docs/guides/onap-user/onap-portal-user/attachments/20086846_image2017-12-5_16-57-24.png
new file mode 100644
index 0000000..c2c361f
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/20086846_image2017-12-5_16-57-24.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/onap-portal-user.rst b/docs/guides/onap-user/onap-portal-user/onap-portal-user.rst
new file mode 100644
index 0000000..7ce2f3a
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/onap-portal-user.rst
@@ -0,0 +1,172 @@
+|image2017-10-27_15-56-53.png|
+
+ONAP Portal for Users
+=====================
+
+General
+-------
+
+The ONAP Portal platform integrates different ONAP applications into a
+central core. 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 `ONAP Portal SDK
+Documentation <http://onap.readthedocs.io/en/latest/submodules/portal.git/docs/tutorials/index.html>`__\.
+
+Access
+------
+
+Access the ONAP Portal using Mozilla Firefox or Google Chrome(win/mac)
+at the provided URL. For example: `https://<hostname:port>/ONAPPORTAL/login.html`.
+
+Access the ONAP portal via the 8989 LoadBalancer documented `here <https://onap.readthedocs.io/en/latest/submodules/oom.git/docs/oom_user_guide.html#accessing-the-onap-portal-using-oom-and-a-kubernetes-cluster>`__
+
+From the Portal, users access applications directly or by function using
+the `Manage menu`.
+
+See also:
+
+-  `Applications in the Portal`
+
+-  `Application Catalog`
+
+Roles
+-----
+
+The Portal displays different menus for the following functions:
+
+-  Users
+
+-  Portal Admins
+
+-  Application Admins
+
+-  Governor
+
+-  Operator
+
+Each application also defines a distinct set of user roles. See *Users* .
+
+Portal personalization and features
+-----------------------------------
+
+Show and hide the left menu
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To hide the left menu, click the menu icon. Click the menu icon again to
+show the menu.
+
+|image2017-10-31_12-21-53.png|
+
+Applications
+~~~~~~~~~~~~
+
+Access applications in the Portal directly from the `Application Catalog`
+or using the `Manage menu`.
+All the default applications in the ONAP Portal are integrated, but
+applications may also be onboarded as hyperlink-only. Integrated
+applications open in tabs below the header in the Portal; linked
+applications open in a new browser window. To close an integrated
+application, click the x in the tab.
+
+|image2017-12-5_14-53-43.png|
+
+A maximum of six applications (tabs) can be open at once in the ONAP
+Portal.
+
+Manage menu
+-----------
+
+The Manage menu provides links to applications by function. Choose from
+a list of functional or management tasks for each area. This example
+shows the options in the top-level functional Design category:
+
+|image2017-12-5_14-57-22.png|
+
+Favorites
+~~~~~~~~~
+
+Hover over a menu item and click the star beside it to add it to
+Favorites. Click the star again to remove the item from Favorites.
+
+Editing the Menu
+~~~~~~~~~~~~~~~~
+
+Portal Admins edit and manage the menu. See `Edit Functional Menu`
+
+Support Menu
+------------
+
+The Support menu provides Contact Us and Get Access links. Portal admins
+can add contact details and also edit Support menu. See `Edit Functional Menu`.
+
+Home
+----
+
+Home is the default view after login.
+
+|image2017-12-5_16-52-40.png|
+
+Personalize the Home Page
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Add or remove applications using the `Application Catalog`.
+Sort applications or widgets by clicking the drag handle to drag and
+drop the application or widget to a new location.
+
+|image2017-12-5_16-57-24.png| Add, manage, and edit what appears in the
+widgets by clicking the settings icon and selecting Edit.
+
+|ep_home_editwidget.png|
+
+Application Catalog
+-------------------
+
+Use the Application Catalog to select which application should appear on
+your Home page. Applications with a check mark already appear on the
+Home page.
+
+-  To select an application to appear on the Home page, click the check
+   box in the top right corner of the application tile.
+
+-  To remove an application from the Home page, click the check box
+   again.
+
+-  Use the Filter to view specific applications: All applications,
+   Accessible (currently available) applications, or applications On
+   Home Page.
+
+-  Click the drag handle to sort application tiles in the Application
+   Catalog.
+
+|image2017-12-5_15-8-37.png|
+
+Widget Catalog
+--------------
+
+Widgets are small applications that interact with their host application
+and each other to provide quick access for certain tasks. Use the
+Widgets section to view and interact with widgets.
+
+-  Click a widget tile to open the widget.
+
+-  Click the drag handle to sort widget tiles.
+
+|image2017-12-5_15-9-27.png|
+
+
+.. |image2017-10-27_15-56-53.png| image:: attachments/16004343_image2017-10-27_15-56-53.png
+.. |image2017-10-31_12-21-53.png| image:: attachments/16004980_image2017-10-31_12-21-53.png
+.. |image2017-12-5_14-53-43.png| image:: attachments/20086818_image2017-12-5_14-53-43.png
+.. |image2017-12-5_14-57-22.png| image:: attachments/20086819_image2017-12-5_14-57-22.png
+.. |image2017-12-5_16-52-40.png| image:: attachments/20086839_image2017-12-5_16-52-40.png
+.. |image2017-12-5_16-57-24.png| image:: attachments/20086846_image2017-12-5_16-57-24.png
+.. |ep_home_editwidget.png| image:: attachments/1018906_ep_home_editwidget.png
+.. |image2017-12-5_15-8-37.png| image:: attachments/20086820_image2017-12-5_15-8-37.png
+.. |image2017-12-5_15-9-27.png| image:: attachments/20086821_image2017-12-5_15-9-27.png