[help] Updates to instructions for audio and video conversations

1 files changed, 28 insertions, 36 deletions

diff --git a/help/C/audio-call.page b/help/C/audio-call.page
index c3e973d81..44fad75e9 100644
--- a/help/C/audio-call.page
+++ b/help/C/audio-call.page
@@ -1,15 +1,16 @@
 <page xmlns="http://projectmallard.org/1.0/"
-  type="topic"
-  id="audio-call">
+      xmlns:e="http://projectmallard.org/experimental/"
+      type="topic" style="task"
+      id="audio-call">
 
   <info>
     <link type="guide" xref="index#audio-video"/>
     <link type="seealso" xref="audio-video"/>
-    <desc>
-      Start an audio conversation with one of your contacts.
-    </desc>
+    <desc>Call your contacts over the Internet.</desc>
     <revision pkgversion="2.28" version="0.1" date="2009-08-02" status="stub"/>
-    <revision pkgversion="2.28" version="0.2" date="2009-08-07" status="review"/>
+    <revision pkgversion="2.28" version="0.2" date="2009-08-07" 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>
@@ -23,45 +24,36 @@
 
   <title>Start an audio conversation</title>
 
+  <p>You can call your contacts and have an audio conversation with them.
+  This features only works with certain types of accounts, and it requires
+  the other person to have an application that supports audio calls.</p>
+
+  <comment>
+    <cite date="2009-09-02">Shaun McCance</cite>
+    <p>Link to A/V support matrix</p>
+  </comment>
+
   <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 audio 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>Audio Call</gui>.
-          </p>
-        </item>
-      </list>
+      <p>From the <gui>Contact List</gui> window, click the
+      <media type="image" mime="image/png" src="figures/audio-input-microphone.png">audio call</media>
+      icon next to the name of the contact you wish to call.  Alternatively,
+      right click the contact and choose <gui>Audio 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 an audio conversation into a video one, from the call window choose
-      <guiseq><gui>Call</gui><gui>Send video</gui></guiseq>,
-      or click on the video call icon.
-    </p>
+    <p>To turn an audio conversation into a video 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 select it.</p>
   </note>
 
 </page>