Fixing documentation for packetcable

* Indentation level
* Image widths
* Table formatting

Reviewed Content to reflect Lithium Release

Change-Id: I6a0a787ebae776a2111eca7b1511f242a4c24432
Signed-off-by: Colin Dixon <colin@colindixon.com>
Signed-off-by: Mathieu Lemay <mlemay@inocybe.com>

diff --git a/manuals/user-guide/src/main/asciidoc/packetcable/packetcable-user.adoc b/manuals/user-guide/src/main/asciidoc/packetcable/packetcable-user.adoc
index 477c42e2190eaa41930bdbad28c3e24f1c6a33e1..dba6e09b8f93c1a9c9f83462a8cd2675eb99d1e0 100644 (file)
--- a/manuals/user-guide/src/main/asciidoc/packetcable/packetcable-user.adoc
+++ b/manuals/user-guide/src/main/asciidoc/packetcable/packetcable-user.adoc
@@ -1,10 +1,10 @@
 [[pcmm-user-guide-preliminary]]
-= PCMM User Guide (*Preliminary*)
+== PCMM User Guide (*Preliminary*)
 
 [[system-overview]]
-== System Overview
+=== System Overview
 
-These components introduce a DOCSIS QoS Service Flow management using
+These components introduce a DOCSIS QoS Gates management using
 the PCMM protocol. The driver component is responsible for the
 PCMM/COPS/PDP functionality required to service requests from
 PacketCable Provider and FlowManager. Requests are transposed into PCMM
@@ -12,31 +12,27 @@ Gate Control messages and transmitted via COPS to the CMTS. This plugin
 adheres to the PCMM/COPS/PDP functionality defined in the CableLabs
 specification. PacketCable solution is an MDSAL compliant component.
 
-image:Screenshot6.png[Screenshot6.png,title="Screenshot6.png"]
+// .OpenDaylight Architecture
+// image:Screenshot6.png[width=500]
 
-image:Odp_diagram_helium_v6.jpg[Odp_diagram_helium_v6.jpg,title="Odp_diagram_helium_v6.jpg"]
+// [[dependency-map]]
+// === Dependency Map
 
-[[dependency-map]]
-== Dependency Map
+// .OpenDaylight Dependencies
+// image:ODL-Helium-dependency.png[width=500]
 
-image:ODL-Helium-dependency.png[ODL-Helium-dependency.png,title="ODL-Helium-dependency.png"]
+[[packetcable-components-qos]]
+=== Packetcable Components (PCMM QoS Gates) 
 
-[[packetcable-components]]
-== Packetcable Components
+packetcable is comprised of three OpenDaylight bundles
 
-packetcable is comprised of three OpendayLight bundles
-
-[cols=",",options="header",]
+[options="header"]
 |=======================================================================
 |Bundle |Description
-|packetcable-model |Contains the YANG information model for flows and
-nodes
+|packetcable-policy-server |Plugin that provides PCMM model implementation based on CMTS structure and COPS protocol.
 
-|packetcable-provider |Provider hosts the model processing, RESTCONF,
-API implementation, and brokers requests to consumer
+|packetcable-policy-model |The Model provided provides a direct mapping to the underlying QoS Gates of CMTS.
 
-|packetcable-consumer |Consumer hosts packet codec and sends requests to
-driver
 
 |packetcable-driver |The codec for transforming the model into the
 appropriate PCMM Gate message for flows and CMTS connections.
@@ -47,74 +43,29 @@ https://git.opendaylight.org/gerrit/gitweb?p=packetcable.git;a=tree;f=packetcabl
 Model]
 
 [[features-to-install]]
-=== Features to Install
+==== Features to Install
 
 ---------------------------------------------------------------------------------------------------------------------------
-opendaylight-user@root>feature:install odl-restconf odl-l2switch-switch odl-dlux-core odl-mdsal-apidocs odl-packetcable-all
+opendaylight-user@root>feature:install odl-restconf odl-l2switch-switch odl-dlux-core odl-mdsal-apidocs odl-packetcable-policy-all
 ---------------------------------------------------------------------------------------------------------------------------
 
-[[accessing-user-interface-assets]]
-== Accessing User Interface Assets
-
-[[management-ui]]
-=== Management UI
-
-[[install-node.js]]
-==== Install Node.js
-
-Use the following script install_nodejs.sh to guide you through Node.js
-installation on Ubuntu.
-
--------------------------------------------------
-#!/bin/sh 
-
-sudo apt-get install nodejs nodejs-legacy npm git
-sudo npm -g install grunt
-sudo npm -g install grunt-cli
-sudo npm -g install bower
-sudo npm -g install karma
-sudo npm -g install karma-cli
--------------------------------------------------
-
-NOTE: Not needed unless running standalone.
-https://wiki.opendaylight.org/view/OpenDaylight_dlux:Setup_and_Run[Setup
-dLux for Development]
-
-http://localhost:8181/dlux/index.html
-
-user: admin
-
-password: admin
-
-Sign in
-
-image:Screenshot4.png[|Dlux Login,title="|Dlux Login"]
-
-Manage Flows
-
-image:Screenshot3.png[|Dlux Flows,title="|Dlux Flows"]
-
-Manage Nodes
-
-image:Screenshot2.png[|Dlux Nodes,title="|Dlux Nodes"]
-
 [[explore-and-exercise-the-packetcable-rest-api]]
-=== Explore and exercise the PacketCable REST API
+==== Explore and exercise the PacketCable REST API
 
 http://localhost:8181/apidoc/explorer/index.html
 
 link:#RESTCONF_API_Explorer[ See Explorer ]
 
 [[Add CMTS]]
-== Adding a CMTS to OpenDaylight Inventory
+=== Adding a CMTS to OpenDaylight Inventory
 
-Add a CMTS to Opendaylight Inventory
+The RESTConf URLs makes it possible to add a CMTS to OpenDaylight and have it connected.
 
-image:Screenshot1.png[Add CMTS using RESTCONF
-Explorer,title="Add CMTS using RESTCONF Explorer"]
+Add a CMTS to OpenDaylight Inventory
+image:Screenshot1.png[width=500,title="Add a CMTS to OpenDaylight Inventory"]
 
 [[postman]]
-=== Postman
+==== Postman
 
 https://chrome.google.com/webstore/detail/postman-rest-client/fdmmgilgnpjigdojojpjoooidkmcomcm?hl=en[Configure
 the Chrome browser]
@@ -122,5 +73,6 @@ the Chrome browser]
 https://git.opendaylight.org/gerrit/gitweb?p=packetcable.git;a=tree;f=packetcable-client[Download
 and import sample packetcable collection]
 
-image:Screenshot5.png[Postman,title="Postman"]
+
+image:Screenshot5.png[width=500,title="Postman Operations"]