From 84e9e3bf231907d816ef03cd120e574cbf3cee58 Mon Sep 17 00:00:00 2001 From: Saryu Shah Date: Fri, 29 Sep 2017 15:53:37 +0000 Subject: [PATCH] Updates to policy documentation Included the table of contents in api and arch doc ------------------------------------------------------------- Change-Id: I50a977cd3c9781c1f2b5804d9043f097246e2528 Issue-Id: POLICY-241 Signed-off-by: Saryu Shah --- docs/platform/architecture.rst | 4 ++++ docs/platform/offeredapis.rst | 11 +++++++---- 2 files changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/platform/architecture.rst b/docs/platform/architecture.rst index 25dd083ca..3a56c8890 100644 --- a/docs/platform/architecture.rst +++ b/docs/platform/architecture.rst @@ -4,6 +4,10 @@ Architecture ------------ + +.. contents:: + :depth: 3 + POLICY is a subsystem of ONAP that maintains, distributes, and operates on the set of rules that underlie ONAP’s control, orchestration, and management functions. POLICY provides a logically centralized environment for the creation and management of policies, including conditional rules. This provides the capability to **create** and **validate** policies/rules, **identify overlaps**, **resolve conflicts**, and **derive** additional policies as needed. Policies are used to **control**, **influence**, and help **ensure compliance** with goals. Policies can support infrastructure, products and services, operation automation, and security. Users, including network and service designers, operations engineers, and security experts, can easily **create**, **change**, and **manage** policy rules from the POLICY Manager in the ONAP Portal. diff --git a/docs/platform/offeredapis.rst b/docs/platform/offeredapis.rst index 6f522635b..4b3c7fefb 100644 --- a/docs/platform/offeredapis.rst +++ b/docs/platform/offeredapis.rst @@ -4,6 +4,10 @@ Offered APIs ============ + +.. contents:: + :depth: 2 + The Policy subsystem of ONAP maintains, distributes, and operates on the set of rules that underlie ONAP’s control, orchestration, and management functions. Policy provides a centralized environment for the creation and management of easily-updatable conditional rules. It enables users to validate policies and rules, identify and resolve overlaps and conflicts, and derive additional policies where needed. The following operations are supported by the policy API: * Create policies on the PAP @@ -22,12 +26,9 @@ The Policy subsystem of ONAP maintains, distributes, and operates on the set of POLICY Engine Services ^^^^^^^^^^^^^^^^^^^^^^ -The figure below represents the target POLICY Architecture. - .. image:: https://wiki.onap.org/download/attachments/1015898/PolicyEngineApiList.png?api=v2 - POLICY API Details ^^^^^^^^^^^^^^^^^^ @@ -36,8 +37,10 @@ POLICY API Details .. swaggerv2doc:: https://wiki.onap.org/download/attachments/1015898/api-docs-09192017.json?api=v2 +Additional Information +^^^^^^^^^^^^^^^^^^^^^^ -Additional information can be found at `PolicyApi link`_. +Additional information, including examples, can be found at `PolicyApi link`_. .. _PolicyApi link: https://wiki.onap.org/display/DW/Policy+API -- 2.16.6