X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Fdrools%2Fdrools.rst;h=ccbad75afc2885a2a4bd581c8cf573afb750a53a;hb=108dd8ff62cbdfbbe1ba3589afe43582105ea275;hp=90bd05a53c0e3cfab353806ea001f29f4df09f9c;hpb=5fc2fdb0eebfec733acbc26dc9ab933279ea2c83;p=policy%2Fparent.git

diff --git a/docs/drools/drools.rst b/docs/drools/drools.rst
index 90bd05a5..ccbad75a 100644
--- a/docs/drools/drools.rst
+++ b/docs/drools/drools.rst
@@ -3,10 +3,53 @@
 .. _drools-label:
 
 Policy Drools PDP Engine
-------------------------
-.. toctree::
-   :maxdepth: 1
+########################
+
+.. contents::
+    :depth: 1
+
+The Drools PDP, aka PDP-D, is the PDP in the Policy Framework that uses the
+`Drools BRMS <https://www.drools.org/>`__ to enforce policies.
+
+The PDP-D functionality has been partitioned into two functional areas:
+
+- PDP-D Engine.
+- PDP-D Applications.
+
+**PDP-D Engine**
+
+The PDP-D Engine is the infrastructure that *policy applications* use.
+It provides networking services, resource grouping, and diagnostics.
+
+The PDP-D Engine supports the following Tosca Native Policy Types:
+
+- onap.policies.native.Drools
+- onap.policies.native.drools.Controller
+
+These types are used to dynamically add and configure new application controllers.
 
+The PDP-D Engine hosts applications by means of *controllers*.
+*Controllers* may support other Tosca Policy Types.   The
+types supported by the *Control Loop* applications are:
+
+- onap.policies.controlloop.operational.common.Drools
+- onap.policies.controlloop.Operational
+
+
+**PDP-D Applications**
+
+A PDP-D application, ie. a *controller*, contains references to the
+resources that the application needs.   These include networked endpoint references,
+and maven coordinates.
+
+*Control Loop* applications are used in ONAP to enforce operational policies.
+
+
+The following guides offer more information in these two functional areas.
+
+.. toctree::
+   :maxdepth: 2
 
+   pdpdEngine.rst
+   pdpdApps.rst
 
-End of Document