[totem/wip/hadess/mallard-documentation: 5/87] help: Review adjustment-sound.page

[Bastien Nocera <hadess src gnome org>]

commit cdd8e0ff6674934987629b75a7d72382b7ec9d24
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date:   Wed Mar 7 22:19:27 2012 +0000

    help: Review adjustment-sound.page

 help/C/adjustment-sound.page | 28 ++++++++++++++++++----------
 1 file changed, 18 insertions(+), 10 deletions(-)
---
diff --git a/help/C/adjustment-sound.page b/help/C/adjustment-sound.page
index 16db19d22..6b6b5a79e 100644
--- a/help/C/adjustment-sound.page
+++ b/help/C/adjustment-sound.page
@@ -4,11 +4,15 @@
 
   <info>
     <link type="guide" xref="index#playing-media"/>
-    <desc>Adjust the volume of a movie or music or select a language.</desc>
+    <desc>Adjust the volume of a movie or music, or select a language.</desc>
     <credit type="author">
       <name>Marta Bogdanowicz</name>
       <email>majus85 gmail com</email>
     </credit>
+    <credit type="editor">
+      <name>Ekaterina Gerasimova</name>
+      <email>kittykat3756 gmail com</email>
+    </credit>
     <license>
       <p>Creative Commons Share Alike 3.0</p>
     </license>
@@ -16,21 +20,18 @@
 
   <title>Sound adjustment</title>
 
-  <p>
-  Adjust the volume of played media to your needs. Do it in one of the following
-  ways:
-  </p>
+  <p>You can adjust the volume in a number of different ways:</p>
 
   <list>
     <item>
-      <p>Click <guiseq><gui style="menu">Sound</gui>
-      <gui style="menuitem">Volume Up</gui></guiseq> or use keyboard shortcut
-      <key>Up</key> to make the sound louder.</p>
+      <p>Select <guiseq><gui style="menu">Sound</gui>
+      <gui style="menuitem">Volume Up</gui></guiseq> to make the sound
+      louder.</p>
     </item>
     <item>
        <p>Click <guiseq><gui style="menu">Sound</gui>
-       <gui style="menuitem">Volume Down</gui></guiseq> or use keyboard shortcut
-       <key>Down</key> to make the sound more quiet.</p>
+       <gui style="menuitem">Volume Down</gui></guiseq> to make the sound
+       quieter.</p>
     </item>
     <item>
       <p>Use the <gui>Volume button</gui> to adjust volume. It is located below
@@ -38,6 +39,13 @@
     </item>
   </list>
 
+  <comment>
+    <cite date="2012-03-07">Ekaterina Gerasimova</cite>
+    <p>What if the volume button is greyed out? Where is the information on
+    changing languages? Languages should probably be on a different page
+    anyway…</p>
+  </comment>
+
 <!--  <p>-->
 <!--  Click <guiseq><gui style="menu">Sound</gui>-->
 <!--  <gui style="menuitem">Languages</gui></guiseq> and select the language.-->