Format Opflex project documentation as asciidoc

Change-Id: I49c3b19e32d6ebe067aa9335d94321077aa4cb22
Signed-off-by: Rob Adams <[email protected]>

Author: readams

manuals/developer-guide/src/main/asciidoc/bk-developers-guide.adoc

@@ -68,6 +68,12 @@ include::neutron/neutron.adoc[]
 
 include::openflowjava/odl-openflowjava-protocol-dev.adoc[]
 
+include::opflex/libopflex-dev.adoc[]
+
+include::opflex/genie-dev.adoc[]
+
+include::opflex/agent-ovs-dev.adoc[]
+
 include::ovsdb/ovsdb-developer.adoc[]
 
 include::reservation/reservation-dev.adoc[]

manuals/developer-guide/src/main/asciidoc/opflex/agent-ovs-dev.adoc

@@ -0,0 +1,28 @@
+== OpFlex agent-ovs Developer Guide
+
+=== Overview
+agent-ovs is a policy agent that works with OVS to enforce a
+group-based policy networking model with locally attached virtual
+machines or containers. The policy agent is designed to work well with
+orchestration tools like OpenStack.
+
+=== agent-ovs Architecture
+agent-ovs uses libopflex to communicate with an OpFlex-based policy
+repository to enforce policy on network endpoints attached to OVS by
+an orchestration system.
+
+The key components are:
+
+* Agent - coordinates startup and configuration
+* Renderers - Renderers are responsible for rendering policy.  This is
+  a very general mechanism but the currently-implemented renderer is
+  the stitched-mode renderer that can work along with with hardware
+  fabrics such as ACI that support policy enforcement.
+* EndpointManager - Keep track of network endpoints and declare them
+  to the endpoint repository
+* PolicyManager - Keep track of and index policies
+* FlowManager - render policies to OVS
+
+=== API Reference Documentation
+Internal API documentation can be found here:
+https://jenkins.opendaylight.org/opflex/job/opflex-merge/ws/agent-ovs/doc/html/index.html

manuals/developer-guide/src/main/asciidoc/opflex/genie-dev.adoc

@@ -0,0 +1,18 @@
+== OpFlex genie Developer Guide
+
+=== Overview
+Genie is a tool for code generation from a model.  It supports
+generating C\++ and Java code.  C++ can be generated suitable for use
+with libopflex. C++ and Java can be generated as a plain set of
+objects.
+
+=== Group-based Policy Model
+The group-based policy model is included with the genie tool and can
+be found under the MODEL directory.  By running mvn exec:java,
+libmodelgbp will be generated as a library project that, when built
+and installed, will work with libopflex.  This model is used by the
+OVS agent.
+
+=== API Reference Documentation
+Complete API documentation for the generated libmodelgbp can be found here:
+https://jenkins.opendaylight.org/opflex/job/opflex-merge/ws/libopflex/doc/html/index.html