Wrote several power management topics. Ready for review.

1 files changed, 23 insertions, 10 deletions

diff --git a/gnome-help/C/power-batterybroken.page b/gnome-help/C/power-batterybroken.page
index a573a40..95e2162 100644
--- a/gnome-help/C/power-batterybroken.page
+++ b/gnome-help/C/power-batterybroken.page
@@ -1,25 +1,38 @@
 <page xmlns="http://projectmallard.org/1.0/"
-      xmlns:e="http://projectmallard.org/experimental/"
       type="topic"
       id="power-batterybroken">
 
   <info>
     <link type="guide" xref="power#battery"/>
-    <desc>XXX</desc>
-    <revision pkgversion="0.1" version="0.1" date="2010-06-29" status="stub"/>
+    <link type="seealso" xref="power-batteryoptimal"/>
+    
+    <desc>Your battery is probably not broken; it's more likely that it's just old.</desc>
+    <revision pkgversion="3.0" version="0.1" date="2010-12-31" status="draft"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list@gnome.org</email>
     </credit>
+    <credit type="author">
+      <name>Phil Bull</name>
+      <email>philbull@gmail.com</email>
+    </credit>
     
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Why does it say my battery is broken?</title>
-  
-  <comment>
-   <cite date="2010-06-29" href="mailto:gnome-doc-list@gnome.org">GNOME Documentation Project</cite>
-   <p>Message displayed when user logs in for the first time; if laptop battery is old, its maximum capacity will be low and GPM will tell the user that it might be broken. This could panic users - reassurance and explanation is needed.</p>
-  </comment>
-	
+<title>Why does it say my battery is broken?</title>
+
+<p>When you first log in, you might see a message that says:</p>
+<quote>
+ <p><em>Battery may be broken. Your battery has a very low capacity which means that it may be old or broken.</em></p>
+</quote>
+
+<p>This message is displayed when the computer detects that your battery is not capable of storing much charge. The most likely reason for this is that your battery is old; it's probably not broken, so there's no need to worry.</p>
+
+<p>Over time, all laptop batteries lose their ability to store charge. After a while (normally a year or more), the battery will only be able to store a fraction of the charge that it could when it was new. The message above is shown when this happens.</p>
+
+<p>If your computer/battery is relatively new, it should be capable of holding a high percentage of its <link xref="power-batterycapacity">design charge</link>. If it can't, then your battery may be broken and you might need to seek a replacement.</p>
+
+<p>See <link xref="power-batterycapacity"/> for instructions on how to check your battery's capacity.</p>
+
 </page>