From 9770d0a0a8b9dbef9d92ce896f89c68fddabfa78 Mon Sep 17 00:00:00 2001
From: Miruna Paun <Miruna.Paun@enea.com>
Date: Wed, 6 Feb 2019 17:10:01 +0100
Subject: General updates to the Getting Started manual for imageobject
 formating, scaling, fixing overflow and the missing olink ref.

Change-Id: I76067d62e704d96ab82573575904bc9665ddfd1d
---
 .../doc/demo_usecases.xml                          | 18 +++--
 .../doc/device_configuration_and_provisioning.xml  |  4 +-
 .../doc/documentation.xml                          |  7 +-
 .../doc/getting_started_nfv_access.xml             | 88 ++++++----------------
 .../doc/in_band_management.xml                     |  4 +-
 .../doc/introduction.xml                           |  8 +-
 6 files changed, 49 insertions(+), 80 deletions(-)
 mode change 100755 => 100644 doc/book-enea-nfv-access-getting-started/doc/in_band_management.xml

diff --git a/doc/book-enea-nfv-access-getting-started/doc/demo_usecases.xml b/doc/book-enea-nfv-access-getting-started/doc/demo_usecases.xml
index 1686427..31894dd 100644
--- a/doc/book-enea-nfv-access-getting-started/doc/demo_usecases.xml
+++ b/doc/book-enea-nfv-access-getting-started/doc/demo_usecases.xml
@@ -81,7 +81,8 @@
 
           <mediaobject>
             <imageobject>
-              <imagedata align="center" fileref="images/ovs_bridge_zero.png" />
+              <imagedata align="center" fileref="images/ovs_bridge_zero.png"
+                         scale="80" />
             </imageobject>
           </mediaobject>
         </figure>
@@ -145,7 +146,8 @@
 
           <mediaobject>
             <imageobject>
-              <imagedata align="center" fileref="images/vnf_instance.png" />
+              <imagedata align="center" fileref="images/vnf_instance.png"
+                         scale="80" />
             </imageobject>
           </mediaobject>
         </figure>
@@ -183,7 +185,7 @@
           <mediaobject>
             <imageobject>
               <imagedata align="center"
-                         fileref="images/vnf_instance_server.png" />
+                         fileref="images/vnf_instance_server.png" scale="80" />
             </imageobject>
           </mediaobject>
         </figure>
@@ -200,7 +202,7 @@
           <mediaobject>
             <imageobject>
               <imagedata align="center"
-                         fileref="images/vnf_instance_client.png" />
+                         fileref="images/vnf_instance_client.png" scale="80" />
             </imageobject>
           </mediaobject>
         </figure>
@@ -231,7 +233,7 @@ root@qemux86-64:~# iperf3 -c 192.168.10.10</programlisting>
       <mediaobject>
         <imageobject>
           <imagedata align="center"
-                     fileref="images/enea_vnf_demo_overview.svg" />
+                     fileref="images/enea_vnf_demo_overview.svg" scale="95" />
         </imageobject>
       </mediaobject>
     </figure>
@@ -267,7 +269,8 @@ root@qemux86-64:~# iperf3 -c 192.168.10.10</programlisting>
           <mediaobject>
             <imageobject>
               <imagedata align="center"
-                         fileref="images/secondtar_hostinterface.png" />
+                         fileref="images/secondtar_hostinterface.png"
+                         scale="90" />
             </imageobject>
           </mediaobject>
         </figure>
@@ -301,7 +304,8 @@ root@qemux86-64:~# iperf3 -c 192.168.10.10</programlisting>
 
           <mediaobject>
             <imageobject>
-              <imagedata align="center" fileref="images/ovs_bridge_two.png" />
+              <imagedata align="center" fileref="images/ovs_bridge_two.png"
+                         scale="90" />
             </imageobject>
           </mediaobject>
         </figure>
diff --git a/doc/book-enea-nfv-access-getting-started/doc/device_configuration_and_provisioning.xml b/doc/book-enea-nfv-access-getting-started/doc/device_configuration_and_provisioning.xml
index a954df5..3b7c5f8 100644
--- a/doc/book-enea-nfv-access-getting-started/doc/device_configuration_and_provisioning.xml
+++ b/doc/book-enea-nfv-access-getting-started/doc/device_configuration_and_provisioning.xml
@@ -189,7 +189,7 @@
         <mediaobject>
           <imageobject>
             <imagedata align="center"
-                       fileref="images/sriov_interface_type.png" />
+                       fileref="images/sriov_interface_type.png" scale="90" />
           </imageobject>
         </mediaobject>
       </figure>
@@ -255,7 +255,7 @@
           <mediaobject>
             <imageobject>
               <imagedata align="center" fileref="images/vnf_manager.png"
-                         scale="80" />
+                         scale="75" />
             </imageobject>
           </mediaobject>
         </figure>
diff --git a/doc/book-enea-nfv-access-getting-started/doc/documentation.xml b/doc/book-enea-nfv-access-getting-started/doc/documentation.xml
index 84da927..26532ea 100644
--- a/doc/book-enea-nfv-access-getting-started/doc/documentation.xml
+++ b/doc/book-enea-nfv-access-getting-started/doc/documentation.xml
@@ -21,15 +21,16 @@
 
       <itemizedlist>
         <listitem>
-          <para>Enea NFV Access Reference Guide</para>
+          <para>Enea NFV Access Reference Guide. <remark>make this into an
+          olink</remark></para>
         </listitem>
 
         <listitem>
-          <para>Enea NFV Access Getting Started</para>
+          <para>Enea NFV Access Getting Started (the present document).</para>
         </listitem>
 
         <listitem>
-          <para>DeveloperDocs, Developer Documentation for uCPEManager</para>
+          <para>DeveloperDocs, Developer Documentation for uCPEManager.</para>
         </listitem>
       </itemizedlist>
     </listitem>
diff --git a/doc/book-enea-nfv-access-getting-started/doc/getting_started_nfv_access.xml b/doc/book-enea-nfv-access-getting-started/doc/getting_started_nfv_access.xml
index 49dc4d4..e26cfc5 100644
--- a/doc/book-enea-nfv-access-getting-started/doc/getting_started_nfv_access.xml
+++ b/doc/book-enea-nfv-access-getting-started/doc/getting_started_nfv_access.xml
@@ -270,13 +270,9 @@ sdb            8:0            0     111.8G  0  disk
 
           <figure>
             <mediaobject>
-              <imageobject role="fo">
-                <imagedata align="center" contentwidth="600"
-                           fileref="images/screen_1.svg" />
-              </imageobject>
-
-              <imageobject role="html">
-                <imagedata align="center" fileref="images/screen_1.png" />
+              <imageobject>
+                <imagedata align="center" fileref="images/screen_1.png"
+                           scale="80" />
               </imageobject>
             </mediaobject>
           </figure>
@@ -293,13 +289,9 @@ sdb            8:0            0     111.8G  0  disk
 
           <figure>
             <mediaobject>
-              <imageobject role="fo">
-                <imagedata align="center" contentwidth="600"
-                           fileref="images/screen_2.svg" />
-              </imageobject>
-
-              <imageobject role="html">
-                <imagedata align="center" fileref="images/screen_2.png" />
+              <imageobject>
+                <imagedata align="center" fileref="images/screen_2.png"
+                           scale="80" />
               </imageobject>
             </mediaobject>
           </figure>
@@ -316,13 +308,9 @@ sdb            8:0            0     111.8G  0  disk
 
           <figure>
             <mediaobject>
-              <imageobject role="fo">
-                <imagedata align="center" contentwidth="600"
-                           fileref="images/screen_3.svg" />
-              </imageobject>
-
-              <imageobject role="html">
-                <imagedata align="center" fileref="images/screen_3.png" />
+              <imageobject>
+                <imagedata align="center" fileref="images/screen_3.png"
+                           scale="80" />
               </imageobject>
             </mediaobject>
           </figure>
@@ -363,13 +351,9 @@ sdb            8:0            0     111.8G  0  disk
 
           <figure>
             <mediaobject>
-              <imageobject role="fo">
-                <imagedata align="center" contentwidth="600"
-                           fileref="images/screen_7_1.svg" />
-              </imageobject>
-
-              <imageobject role="html">
-                <imagedata align="center" fileref="images/screen_7_1.png" />
+              <imageobject>
+                <imagedata align="center" fileref="images/screen_7_1.png"
+                           scale="80" />
               </imageobject>
             </mediaobject>
           </figure>
@@ -406,13 +390,9 @@ sdb            8:0            0     111.8G  0  disk
 
           <figure>
             <mediaobject>
-              <imageobject role="fo">
-                <imagedata align="center" contentwidth="600"
-                           fileref="images/screen_7_2.svg" />
-              </imageobject>
-
-              <imageobject role="html">
-                <imagedata align="center" fileref="images/screen_7_2.png" />
+              <imageobject>
+                <imagedata align="center" fileref="images/screen_7_2.png"
+                           scale="80" />
               </imageobject>
             </mediaobject>
           </figure>
@@ -441,13 +421,9 @@ sdb            8:0            0     111.8G  0  disk
 
           <figure>
             <mediaobject>
-              <imageobject role="fo">
-                <imagedata align="center" contentwidth="600"
-                           fileref="images/screen_7.svg" />
-              </imageobject>
-
-              <imageobject role="html">
-                <imagedata align="center" fileref="images/screen_7.png" />
+              <imageobject>
+                <imagedata align="center" fileref="images/screen_7.png"
+                           scale="80" />
               </imageobject>
             </mediaobject>
           </figure>
@@ -459,13 +435,9 @@ sdb            8:0            0     111.8G  0  disk
 
           <figure>
             <mediaobject>
-              <imageobject role="fo">
-                <imagedata align="center" contentwidth="600"
-                           fileref="images/screen_8.svg" />
-              </imageobject>
-
-              <imageobject role="html">
-                <imagedata align="center" fileref="images/screen_8.png" />
+              <imageobject>
+                <imagedata align="center" fileref="images/screen_8.png"
+                           scale="80" />
               </imageobject>
             </mediaobject>
           </figure>
@@ -488,13 +460,8 @@ sdb            8:0            0     111.8G  0  disk
 
       <figure>
         <mediaobject>
-          <imageobject role="fo">
-            <imagedata align="center" contentwidth="600"
-                       fileref="images/boot_ena.svg" />
-          </imageobject>
-
-          <imageobject role="html">
-            <imagedata align="center" fileref="images/boot_ena.png" />
+          <imageobject>
+            <imagedata align="center" fileref="images/boot_ena.png" scale="85" />
           </imageobject>
         </mediaobject>
       </figure>
@@ -552,13 +519,8 @@ run</programlisting>
 
       <figure>
         <mediaobject>
-          <imageobject role="fo">
-            <imagedata align="center" contentwidth="600"
-                       fileref="images/efi_menu.svg" />
-          </imageobject>
-
-          <imageobject role="html">
-            <imagedata align="center" fileref="images/efi_menu.png" scale="90" />
+          <imageobject>
+            <imagedata align="center" fileref="images/efi_menu.png" scale="60" />
           </imageobject>
         </mediaobject>
       </figure>
diff --git a/doc/book-enea-nfv-access-getting-started/doc/in_band_management.xml b/doc/book-enea-nfv-access-getting-started/doc/in_band_management.xml
old mode 100755
new mode 100644
index 67a8a5a..358ed44
--- a/doc/book-enea-nfv-access-getting-started/doc/in_band_management.xml
+++ b/doc/book-enea-nfv-access-getting-started/doc/in_band_management.xml
@@ -61,7 +61,7 @@
     <mediaobject>
       <imageobject>
         <imagedata align="center" fileref="images/In-bandManagement2.png"
-                   scale="60" />
+                   scale="55" />
       </imageobject>
     </mediaobject>
   </figure>
@@ -149,7 +149,7 @@
     <mediaobject>
       <imageobject>
         <imagedata align="center" fileref="images/In-bandManagement.png"
-                   scale="70" />
+                   scale="65" />
       </imageobject>
     </mediaobject>
   </figure>
diff --git a/doc/book-enea-nfv-access-getting-started/doc/introduction.xml b/doc/book-enea-nfv-access-getting-started/doc/introduction.xml
index 30934e1..3d8474b 100644
--- a/doc/book-enea-nfv-access-getting-started/doc/introduction.xml
+++ b/doc/book-enea-nfv-access-getting-started/doc/introduction.xml
@@ -102,9 +102,11 @@
       </listitem>
     </itemizedlist>
 
-    <para>For additional information about the features provided in Enea NFV Access,
-    refer to the <olink>Reference Guide</olink> provided with your release. For how to
-    install and run Enea NFV Access on supported devices, please refer to <xref
+    <para>For additional information about the features provided in Enea NFV
+    Access, refer to the Reference Guide <remark>make this into an olink
+    reference to the Ref Guide once the olink is updated with it's new book
+    ID.</remark>provided with your release. For how to install and run Enea
+    NFV Access on supported devices, please refer to <xref
     linkend="plat-release-content">
     Chapter 4, Getting Started with Enea NFV Access</xref>.</para>
   </section>
-- 
cgit v1.2.3-54-g00ecf