Made Boxes Guide more new user centric, polished some of the technical language and made the section labels make more sense and created an outline for the chapter

1 files changed, 100 insertions, 45 deletions

diff --git a/en-US/Boxes.xml b/en-US/Boxes.xml
index dcb64b4..79b0095 100644
--- a/en-US/Boxes.xml
+++ b/en-US/Boxes.xml
@@ -4,7 +4,7 @@
 <chapter id="Intro_Boxes">
 		<title>Introduction to Boxes</title>
 		<para>
-			Boxes is a simple graphical interface for managing and using virtual machines.
+			Boxes is a simple graphical interface for managing and using virtual machines. Boxes can also connect to computers via VNC. Or Boxes can connect via SPICE or Quemu.
 		</para>
 		<para>
 			Boxes uses <application>qemu-kvm</application>, <application>libvirt-glib</application>, and <application>spice-gtk</application> to allow users to easily manage virtual machines and connect to remote machines
@@ -17,27 +17,8 @@
 			<listitem><para>Select and create favorite virtual machines or connections </para></listitem>		
 		</itemizedlist>
 </section>
-<section id="sec-handy-boxes-notes">
-	<title>Handy Notes about Boxes</title>
-			<itemizedlist>
-				<listitem>
-					<para>Boxes uses <application>libvertd</application> and many <application>libvertd</application> commands can be used for Boxes virtual machines
-				</para>			
-			</listitem>
-			<listitem>
-				<para>Boxes keeps the virtual machine disks or images in:<filename class="directory">/home/$USER/.local/share/gnome-boxes/images
-			</filename>
-				</para>		
-			</listitem>
-				<listitem>
-					<para>Boxes keeps the configuration files for virtual machines in:<filename class="directory">/home/$USER/.config/share/gnome-boxes
-			</filename>
-				</para>			
-			</listitem>
-		</itemizedlist>
-		</section> 
 <section id="sec-create-vm-in-boxes">
-	<title>Create a Virtual Machine In Boxes</title>
+	<title>How do I create a virtual machine in Boxes</title>
 		<procedure><title>Create a Virtual Machine In Boxes</title>
 			<step>
  				<para>
@@ -61,7 +42,7 @@
 			</step>
 			<step>
  				<para>
- 					Select the ISO Image that was previously downloaded to the Downloads folder, otherwise click <guilabel>select a file</guilabel> to find one somewhere else
+ 					Select the ISO Image that was previously downloaded to the Downloads folder, otherwise click <guilabel>select a file</guilabel> to find one somewhere else.<emphasis> Boxes will try to autodetect ISO files in your Downloads folder, but it will not always recognize them.</emphasis> 
  				</para>
 			</step>
 			<step>
@@ -86,32 +67,13 @@
 			</step>
 		</procedure>
 </section>
-<section id="sec-options-available-created-vm">
-	<title>Options available in a Boxes virtual machine</title>
-		<note>
-			<para> 
-				Virtual machine settings can be changed by clicking on the <guilabel>screwdriver/wrench icon</guilabel> to access:
-			</para>
-		</note>
-	<itemizedlist>
-		<listitem><para>Sharing the clipboard</para></listitem>
-		<listitem><para>Resize Guest</para></listitem>
-		<listitem><para>Redirect New USB Devices to the Virtual Machine</para></listitem>
-		<listitem><para>Redirect currently plugged in USB devices to the Virtual machine</para></listitem>
-		<listitem><para>Create Snapshots of the Virtual Machine from the snapshot heading</para></listitem>
-		<listitem><para>Force Shutdown, by clicking "Force Shutdown" in the lower left hand corner</para></listitem>
-	</itemizedlist>
-	<para> 
-		To exit the settings menu, <emphasis>press the arrow pointing <guilabel>back</guilabel> or to the left on the top left hand side of the menu bar</emphasis>. This will return you to your virtual machine console
-	</para>
-</section>
 <section id="sec-connect-to-remote-machine">
-	<title>How to connect to remote machines via Boxes</title>
+	<title>How do I connect to other computers in Boxes?</title>
 	<note>
 		<para>Boxes Supports three protocols: SPICE, Qemu, and VNC</para>
 	</note>
 	<procedure>
-		<title>Connect to a remote machine in Boxes</title>
+		<title>To connect to another computer using Boxes:</title>
 		<step>
  			<para>
   				Open Boxes
@@ -159,8 +121,101 @@
 		</step>
 		</procedure>
 		</section>
-<section id="sec-libvirt-boxes">
-			 <title>Libvirt tools useful in boxes</title>
+<section id="sec-change-settings">
+	<title>How do I change the settings of a machine in boxes?</title>
+	<itemizedlist>
+	  <listitem><para>On the listing of machines, right click on the machine and then choose <guilabel>Properties</guilabel></para></listitem>
+		<listitem><para>If the machine is running, click on the screwdriver and wrench icon</para></listitem>
+</itemizedlist>
+<para>
+	Once you have accessed the settings menu you can change various items of the virtual machine:
+</para>	
+	<itemizedlist>
+		<listitem><para>Sharing the clipboard</para></listitem>
+		<listitem><para>Resize Guest</para></listitem>
+		<listitem><para>Redirect New USB Devices to the Virtual Machine</para></listitem>
+		<listitem><para>Redirect currently plugged in USB devices to the Virtual machine</para></listitem>
+		<listitem><para>Create Snapshots of the Virtual Machine from the snapshot heading</para></listitem>
+		<listitem><para>Force Shutdown, by clicking "Force Shutdown" in the lower left hand corner</para></listitem>
+	</itemizedlist>
+	<para> 
+		To exit the settings menu, <emphasis>press the arrow pointing <guilabel>back</guilabel> or to the left on the top left hand side of the menu bar</emphasis>. This will return you to your virtual machine console
+	</para>
+</section>
+<!-- This is rather advanced process that is going to take some testing as it does not look Boxes supports this via the GUI
+<section id="Move-VM">
+<title>How do I move a Virtual Machine between computers?</title>
+<para>
+To Move a Virtual Machine made in Boxes takes two steps:
+</para>
+<orderedlist>
+	  <listitem><para>Move of the virtual hard drive that is kept in:<filename class="directory">/home/$USER/.local/share/gnome-boxes/images
+			</filename></para></listitem>
+		<listitem><para>Move of the XML configuration file that is kept in: <filename class="directory">/home/$USER/.config//gnome-boxes
+			</filename></para></listitem>
+</orderedlist>
+<procedure><title>Move a VM Hard drive "image" file between Computers</title>
+	<step><para>Open your home folder via files
+</para>
+</step>
+<step><para>Press CTRL+H to view hidden files
+</para></step>]
+<step><para>Open the<emphasis> .local</emphasis> folder
+</para></step>]
+<step><para>Open the <emphasis>share</emphasis> folder
+</para></step>]
+<step><para>Open the <emphasis>gnome-boxes</emphasis> folder
+</para></step>]
+<step><para>Open the <emphasis>images</emphasis> folder
+</para></step>]
+<step><para>Right Click on the file of the virtual machine and copy it to remove-able media or network share
+</para></step>
+<step><para>On the receiving computer, do the steps in reverse order, ultimately placing the hard drive file in: <filename class="directory">/home/$USER/.local/share/gnome-boxes/images
+			</filename>
+</para></step>
+</procedure>
+<procedure><title>Move a VM Hard drive "Config" file between Computers</title>
+	<step><para>Open your home folder via files
+</para>
+</step>
+<step><para>Press CTRL+H to view hidden files
+</para></step>]
+<step><para>Open the<emphasis> .config</emphasis> folder
+</para></step>]
+<step><para>Open the <emphasis>share</emphasis> folder
+</para></step>]
+<step><para>Open the <emphasis>gnome-boxes</emphasis> folder
+</para></step>]
+<step><para>Open the <emphasis>images</emphasis> folder
+</para></step>]
+<step><para>Right Click on the file of the virtual machine and copy it to remove-able media or network share
+</para></step>
+<step><para>On the receiving computer, do the steps in reverse order, ultimately placing the hard drive file in: <filename class="directory">/home/$USER/.local/share/gnome-boxes/images
+			</filename>
+</para></step>
+</procedure>
+</section> -->
+<section id="sec-tips-tricks">
+	<title>Boxes Tips and Tricks</title>
+			<itemizedlist>
+				<listitem>
+					<para>Boxes uses <application>libvertd</application> and many <application>libvertd</application> commands can be used for Boxes virtual machines
+				</para>			
+			</listitem>
+			<listitem>
+				<para>Boxes keeps the virtual machine disks or images in:<filename class="directory">/home/$USER/.local/share/gnome-boxes/images
+			</filename>
+				</para>		
+			</listitem>
+				<listitem>
+					<para>Boxes keeps the configuration files for virtual machines in:<filename class="directory">/home/$USER/.config/share/gnome-boxes
+			</filename>
+				</para>			
+			</listitem>
+		</itemizedlist>
+		</section> 
+<section id="sec-advanced-items">
+			 <title>Advanced Commands in Boxes</title>
 				<para>
 					You can start and stop virtual machines from the command line as well as using the boxes interface 
 				</para>