Re: a patch and hello

[Kelly Sinnott <ksinnott5ht gmail com>]

Hello all!

I just finished working on the hardware-cardreader.page stub, and
wanted to submit my patch to the list for feedback. I found a
screenshot to be very helpful in describing how mounted cards appear
in Nautilus. If screenshots are inappropriate or not really used, let
me know.

Also, I believe I haven't introduced myself yet. I'm Kelly, I live in
Las Vegas and found my way here through the Women's Outreach program.
I'm glad I did, I've been a user of Open Source software for a couple
years now and have wanted to jump in and help for quite awhile.
Anyway, in IRC my default is "stick", but I may change it since
stickster seems to have the territory covered, especially in terms of
IRC keywords. (I'm not particularly attached to the name, it
just...stuck) On twitter and identi.ca my name is "polymathica", feel
free to follow me, though it's a bit stream-of-consciousness and not
as linux-y as some.

Short version: I've attached a patch for hardware-cardreader.page.stub
with optional screenshot/figure, I'm new to docs, stick on IRC (for
now) and polymathica on twitter/identi.ca.
The screenshot is at http://oi53.tinypic.com/2quug0g.jpg .

Thanks!

Kelly

From 7af24e30c1621d4ef77e136d466407a178924da8 Mon Sep 17 00:00:00 2001
From: Kelly Sinnott <ksinnott5ht gmail com>
Date: Wed, 13 Apr 2011 18:18:06 -0700
Subject: [PATCH] steps for troubleshooting media card reader issues with screenshot to clarify

line breaks

 Changes to be committed:
	new file:   gnome-help/C/figures/hardware-cardreader.png
	modified:   gnome-help/C/hardware-cardreader.page.stub
---
 gnome-help/C/figures/hardware-cardreader.png |  Bin 0 -> 63233 bytes
 gnome-help/C/hardware-cardreader.page.stub   |   54 ++++++++++++++++++++++++-
 2 files changed, 51 insertions(+), 3 deletions(-)
 create mode 100644 gnome-help/C/figures/hardware-cardreader.png

diff --git a/gnome-help/C/figures/hardware-cardreader.png b/gnome-help/C/figures/hardware-cardreader.png
new file mode 100644
index 0000000000000000000000000000000000000000..0aa8e5258c1c25d70443c066cfdf9638d56295c5
GIT binary patch

(I have taken out the binary and just uploaded the image instead to:
http://oi53.tinypic.com/2quug0g.jpg )


diff --git a/gnome-help/C/hardware-cardreader.page.stub b/gnome-help/C/hardware-cardreader.page.stub
index 99ce701..9a666f3 100644
--- a/gnome-help/C/hardware-cardreader.page.stub
+++ b/gnome-help/C/hardware-cardreader.page.stub
@@ -6,7 +6,7 @@
     <link type="guide" xref="media#photos"/>
     <link type="guide" xref="hardware#problems"/>
     
-    <desc>XXXXX</desc>
+    <desc>Troubleshoot media card readers</desc>
     
     <revision pkgversion="3.0" version="0.1" date="2011-03-25" status="stub"/>
     <credit type="author">
@@ -20,7 +20,55 @@
 <title>My media card reader doesn't work</title>
 
 <comment>
- <p>Explain that some media card readers don't work with Linux due to driver issues. You can usually connect the digital camera directly via USB, though.</p>
+ <p>Explain that some media card readers don't work with Linux due to driver issues. 
+You can usually connect the digital camera directly via USB, though.</p>
 </comment>
-	
+
+<p>Many computers contain readers for SD, MMC, SM, MS, CF, and other storage media 
+cards. These should be automatically detected and mounted by Linux. Here are some 
+troubleshooting steps:</p>
+
+<steps>
+<item>
+<p> Make sure that the card is put in correctly. Many cards look as though they are 
+“upside down” when correctly inserted. Also make sure that the card is firmly seated 
+in the slot; some cards, especially CF, require a small amount of force to insert 
+correctly. (Be careful not to push too hard! If you come up against something solid, 
+do not force it.)</p>
+</item>
+
+<item>
+<p> Open <app>Files</app> by using the <gui>Activities</gui> menu. Does the inserted
+ card appear in the <gui>Devices</gui> list in the left sidebar? (If the sidebar is not 
+visible, press <key>F9</key> or  click <guiseq><gui>View</gui><gui> Sidebar</gui>
+<gui> Show Sidebar</gui></guiseq>.) Sometimes the card appears in this list but is not 
+mounted; click it once to mount. </p>
+</item>
+
+<item>
+<p>If your card does not show up in the sidebar, click <guiseq><gui>Go</gui><gui>Computer</gui>. 
+If your card reader is correctly configured, the reader should come up as a drive 
+when no card is present, and the card itself when the card has been mounted.</p>
+</item>
+
+<figure>
+  <desc>In the depicted <gui>Computer</gui> window, a correctly-configured card 
+reader is represented by four drives: <gui>CompactFlash</gui>, <gui>MemoryStick</gui>, 
+<gui>SecureDigital</gui>, and <gui>SmartMedia</gui>. Only the SD card is mounted, and 
+is visible in the left column.</desc>
+  <media type="image" mime="image/png" src="figures/hardware-cardreader.png"/>
+</figure>
+
+<item>
+<p>If you see the card reader but not the card, the problem may be with the card itself. 
+Try a different card or check the card on a different reader if possible.</p>
+</item>
+</steps>
+
+<p>If no cards or drives are available in the <gui>Computer</gui> folder, 
+it is possible that your card reader does not work with Linux due to driver issues. 
+If your card reader is internal (inside the computer instead of sitting outside) 
+this is more likely. The best solution is to directly connect your device 
+(camera, cell phone, etc.) to a USB port on the computer. USB external card 
+readers are also available, and are far more well-supported by Linux.</p>
 </page>
-- 
1.7.4.4