[help] Updates to instructions for audio and video conversations

1 files changed, 24 insertions, 33 deletions

diff --git a/help/C/video-call.page b/help/C/video-call.page
index 018e2edeb..6e4e4732f 100644
--- a/help/C/video-call.page
+++ b/help/C/video-call.page
@@ -1,15 +1,19 @@
 <page xmlns="http://projectmallard.org/1.0/"
-  type="topic"
-  id="video-call">
+      xmlns:e="http://projectmallard.org/experimental/"
+      type="topic" style="task"
+      id="video-call">
 
   <info>
     <link type="guide" xref="index#audio-video"/>
     <link type="seealso" xref="audio-video"/>
+    <link type="seealso" xref="audio-call"/>
     <desc>
       Start a video conversation with one of your contacts.
     </desc>
     <revision pkgversion="2.28" version="0.1" date="2009-08-02" status="stub"/>
-    <revision pkgversion="2.28" version="0.2" date="2009-08-14" status="review"/>
+    <revision pkgversion="2.28" version="0.2" date="2009-08-14" status="review">
+      <e:review by="shaunm@gnome.org" date="2009-09-04" status="done"/>
+    </revision>
     <credit type="author">
       <name>Milo Casagrande</name>
       <email>milo@ubuntu.com</email>
@@ -22,45 +26,32 @@
   </info>
   <title>Start a video conversation</title>
 
+  <p>If you have a webcam, you can call your contacts and have an video
+  conversation with them.  This features only works with certain types of
+  accounts, and it requires the other person to have an application that
+  supports video calls.</p>
+
   <steps>
     <item>
-      <p>
-        From the <gui>Contact List</gui> window, perform one of the following:
-      </p>
-      <list>
-        <item>
-          <p>
-            Select the contact you want to have a conversation with, and click
-            on the video call icon next to their name.
-          </p>
-        </item>
-        <item>
-          <p>
-            Right-click on the name of the contact you want to have a conversation with, and
-            choose <gui>Video Call</gui>.
-          </p>
-        </item>
-      </list>
+      <p>From the <gui>Contact List</gui> window, click the
+      <media type="image" mime="image/png" src="figures/camera-web.png">video call</media>
+      icon next to the name of the contact you wish to call.  Alternatively,
+      right click the contact and choose <gui>Video Call</gui>.</p>
     </item>
     <item>
-      <p>
-        A new window will open. When the connection is established, you will
-        see written, at the bottom of the window, <gui>Connected</gui> and the total
-        conversation time.
-      </p>
+      <p>A new window will open. When the connection is established, you will
+      see <gui>Connected</gui> at the bottom of the window, along with the
+      total conversation time.</p>
     </item>
     <item>
-      <p>
-        To close the conversation, click on <gui>Hang up</gui>.
-      </p>
+      <p>To end the conversation, choose <guiseq><gui>Call</gui><gui>Hang up</gui></guiseq>.</p>
     </item>
   </steps>
   <note style="tip">
-    <p>
-      To turn a video conversation into an audio one, from the call window deselect
-      <guiseq><gui>Call</gui><gui>Send video</gui></guiseq>,
-      or click on the video call icon.
-    </p>
+    <p>To turn a video conversation into an adio conversation, choose
+    <guiseq><gui>Call</gui><gui>Send video</gui></guiseq>, or click the
+    <media type="image" mime="image/png" src="figures/camera-web.png">video call</media>
+    toolbar button to deselect it.</p>
   </note>