GNOME.org
 

[gnome-user-docs] continued work on troubleshooting guide. about halfway done.

commit c6254f4a81bafbe0a6cf43af405a61ce5281c8ee
Author: Jim Campbell <jwcampbell gmail com>
Date:   Mon Apr 4 13:11:22 2011 -0500

    continued work on troubleshooting guide. about halfway done.

 ...et-wireless-troubleshooting-hardware-check.page |   85 ++++++++++++++++++++
 ...net-wireless-troubleshooting-hardware-info.page |   54 ++++++++++++
 ...net-wireless-troubleshooting-initial-check.page |   42 ++++++++++
 gnome-help/C/net-wireless-troubleshooting.page     |   54 +------------
 4 files changed, 185 insertions(+), 50 deletions(-)
---
diff --git a/gnome-help/C/net-wireless-troubleshooting-hardware-check.page b/gnome-help/C/net-wireless-troubleshooting-hardware-check.page
new file mode 100644
index 0000000..9b89954
--- /dev/null
+++ b/gnome-help/C/net-wireless-troubleshooting-hardware-check.page
@@ -0,0 +1,85 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="net-wireless-troubleshooting-hardware-check">
+  <info>
+    <link type="next" xref="net-wireless-troubleshooting"/>
+    
+    <revision pkgversion="3.0" date="2011-03-20" status="stub"/>
+
+
+    <credit type="author">
+      <name>Contributors to the Ubuntu documentation wiki</name>
+    </credit>
+
+    <credit type="author">
+      <name>GNOME Documentation Project</name>
+      <email>gnome-doc-list gnome org</email>
+    </credit>
+
+    <desc>Troubleshoot your connection to a wireless network.</desc>
+  </info>
+
+<title>Resolve problems with wireless connections</title>
+
+  <p>This guide is designed to help you troubleshoot and resolve problems with accessing a wireless network.</p>
+
+  <note><p>Due to the technical nature of trouble-shooting network problems, this guide contains some commands that will need to be entered into a <app>terminal</app> window. While this may seem intimidating at first, these commands present the easiest way of getting the information that you need to restore your network access.</p></note>
+
+  <p>Trouble-shooting problems with wireless networks involves several steps. Throughout this portion of the guide, we will proceed through the following tasks to connect your computer to the internet:</p>
+  <list style="numbered">
+    <item><p>Performing an initial check</p></item>
+    <item><p>Gathering information about your hardware</p></item>
+    <item><p>Checking your hardware</p></item>
+    <item><p>Attempting to create a connection to your wireless router</p></item>
+    <item><p>Performing a check of your modem and router</p></item>
+  </list>
+  <p>After we complete each step, click on the <em>Next</em> link in the upper-right portion of the page. This will take you to the next step in the guide.</p>
+
+  <section id="net-wireless-initial-check">
+    <title>Performing an initial check</title>
+  <p>Our first step will be to see if your computer is already connected to a wireless network.</p>
+  <steps>
+   <item><p>Make sure that your laptop is not connected to a <em>wired</em> internet connection.</p></item>
+   <item><p>If you have an external wireless adapter, make sure that it is plugged-in.</p></item>
+   <item><p>Make sure that your wireless adapter switch is turned on</p></item>
+   <item><p>In the <gui>Top Bar</gui>, make sure that you have not set the <gui>Wireless</gui> setting to <gui>Off</gui>.</p></item>
+   <item><p>Open a <app>terminal</app> window, and enter the following command:</p>
+  <p><cmd>nm-tool</cmd></p>
+   <p>The nm-tool program will display information about your network hardware and connection status. If the wireless connection output section contains the text:</p>
+  <p><code>State: Connected</code></p>
+  <p>then your wireless adapter is working and is connected to your wireless router.</p></item>
+  </steps>
+  <p>If you are connected to your wireless router, but you still cannot access the internet, your router may not be set up correctly, or your Internet Service Provider (ISP) maybe experiencing some technical problems. Review your router and ISP setup guides, or contact your ISP for support.</p>
+  <p>If the output from the <cmd>nm-tool</cmd> command did not indicate that you were connected to the network, click <gui>Next</gui> to proceed to the next portion of the troubleshooting guide.</p>
+  </section>
+<section id="net-hardware-check">  
+  <title>Gather information about your computer and network hardware:</title>
+  <p>For this section, it will be useful to have the follwing items available:</p>
+    <list>
+      <item><p>Your laptop and wireless router</p></item>
+      <item><p>The packaging and contents for your device (particularly the user guide for your router)</p></item>
+      <item><p>A driver disc - even if it only contains Windows drivers</p></item>
+      <item><p>An alternate working internet connection for downloading software and drivers</p></item>
+    </list>
+
+  <p>Additionally, it is helpful to have the following information:</p>
+    <list>
+      <item><p>The name of the device manufacturer</p></item>
+      <item><p>The complete model number of your computer and router</p></item>
+      <item><p>Any version numbers that may be printed on the device or its packaging. These can be crucial, so look carefully.</p></item>
+      <item><p>Anything on the driver disc that identifies either the device itself or the components it uses. Wireless implementation chips are often operated by firmware, a type of software written specifically for that chip.</p></item>
+    </list>
+
+<p>With this information available, we will proceed with the following steps</p>
+  <list>
+    <item><p>Checking your modem and router</p></item>
+    <item><p>Check if your wireless card is enabled and recognized by your computer.</p></item>
+    <item><p>Second step...</p></item>
+    <item><p>Third step...</p></item>
+  </list>
+
+  <p>make sure can identify your networking device</p>
+  <p>PCI device, USB device, internal device</p>
+</section>
+   
+</page>
diff --git a/gnome-help/C/net-wireless-troubleshooting-hardware-info.page b/gnome-help/C/net-wireless-troubleshooting-hardware-info.page
new file mode 100644
index 0000000..7a93c7f
--- /dev/null
+++ b/gnome-help/C/net-wireless-troubleshooting-hardware-info.page
@@ -0,0 +1,54 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="net-wireless-troubleshooting-hardware-info">
+  <info>
+    <link type="next" xref="net-wireless-troubleshooting-hardware-check"/>
+    
+    <revision pkgversion="3.0" date="2011-03-20" status="stub"/>
+
+
+    <credit type="author">
+      <name>Contributors to the Ubuntu documentation wiki</name>
+    </credit>
+
+    <credit type="author">
+      <name>GNOME Documentation Project</name>
+      <email>gnome-doc-list gnome org</email>
+    </credit>
+
+    <desc>Troubleshoot your connection to a wireless network.</desc>
+  </info>
+
+<title>Resolve problems with wireless connections</title>
+
+<section id="net-hardware-check">  
+  <title>Gather information about your computer and network hardware:</title>
+  <p>For this section, it will be useful to have the follwing items available:</p>
+    <list>
+      <item><p>Your laptop and wireless router</p></item>
+      <item><p>The packaging and contents for your device (particularly the user guide for your router)</p></item>
+      <item><p>A driver disc - even if it only contains Windows drivers</p></item>
+      <item><p>An alternate working internet connection for downloading software and drivers</p></item>
+    </list>
+
+  <p>Additionally, it is helpful to have the following information:</p>
+    <list>
+      <item><p>The name of the device manufacturer</p></item>
+      <item><p>The complete model number of your computer and router</p></item>
+      <item><p>Any version numbers that may be printed on the device or its packaging. These can be crucial, so look carefully.</p></item>
+      <item><p>Anything on the driver disc that identifies either the device itself or the components it uses. Wireless implementation chips are often operated by firmware, a type of software written specifically for that chip.</p></item>
+    </list>
+
+<p>With this information available, we will proceed with the following steps</p>
+  <list>
+    <item><p>Checking your modem and router</p></item>
+    <item><p>Check if your wireless card is enabled and recognized by your computer.</p></item>
+    <item><p>Second step...</p></item>
+    <item><p>Third step...</p></item>
+  </list>
+
+  <p>make sure can identify your networking device</p>
+  <p>PCI device, USB device, internal device</p>
+</section>
+
+</page>
diff --git a/gnome-help/C/net-wireless-troubleshooting-initial-check.page b/gnome-help/C/net-wireless-troubleshooting-initial-check.page
new file mode 100644
index 0000000..9dc7b66
--- /dev/null
+++ b/gnome-help/C/net-wireless-troubleshooting-initial-check.page
@@ -0,0 +1,42 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="net-wireless-troubleshooting-initial-check">
+  <info>
+    <link type="next" xref="net-wireless-troubleshooting-hardware-info"/>
+    
+    <revision pkgversion="3.0" date="2011-03-20" status="stub"/>
+
+
+    <credit type="author">
+      <name>Contributors to the Ubuntu documentation wiki</name>
+    </credit>
+
+    <credit type="author">
+      <name>GNOME Documentation Project</name>
+      <email>gnome-doc-list gnome org</email>
+    </credit>
+
+    <desc>Troubleshoot your connection to a wireless network.</desc>
+  </info>
+
+<title>Resolve problems with wireless connections</title>
+
+  <section id="net-wireless-initial-check">
+    <title>Performing an initial check</title>
+  <p>Our first step will be to verify some basic network connectivity information.</p>
+  <steps>
+   <item><p>Make sure that your laptop is not connected to a <em>wired</em> internet connection.</p></item>
+   <item><p>If you have an external wireless adapter (such as a wireless-USB adapater, or a PCMCIA card), make sure that it is inserted into the proper slot on your computer.</p></item>
+   <item><p>If your wireless card is <em>inside</em> of your computer, make sure that your wireless adapter switch is turned on.</p></item>
+   <item><p>In the <gui>Top Bar</gui>, make sure that you have not set the <gui>Wireless</gui> setting to <gui>Off</gui>.</p></item>
+   <item><p>Open a <app>terminal</app> window (such as <app>gnome-terminal</app>), and enter the following command:</p>
+  <p><cmd>nm-tool</cmd></p></item>
+  </steps>
+
+   <p>The <app>nm-tool</app> program will display information about your network hardware and connection status. If output from the wireless connection section contains the text, <code>State: Connected</code>, it means that your wireless adapter is working and it is connected to your wireless router.</p>
+
+  <p>If you are connected to your wireless router, but you still cannot access the internet, your router may not be set up correctly, or your Internet Service Provider (ISP) maybe experiencing some technical problems. Review your router and ISP setup guides, or contact your ISP for support.</p>
+  <p>If the output from the <cmd>nm-tool</cmd> command did not indicate that you were connected to the network, click <gui>Next</gui> to proceed to the next portion of the troubleshooting guide.</p>
+  </section>
+   
+</page>
diff --git a/gnome-help/C/net-wireless-troubleshooting.page b/gnome-help/C/net-wireless-troubleshooting.page
index 82eeaf3..53fc99a 100644
--- a/gnome-help/C/net-wireless-troubleshooting.page
+++ b/gnome-help/C/net-wireless-troubleshooting.page
@@ -4,6 +4,7 @@
   <info>
     <link type="guide" xref="net#wireless" group="first"/>
     <link type="guide" xref="hardware#problems" group="first"/>
+    <link type="next" xref="net-wireless-troubleshooting-initial-check"/>
     
     <revision pkgversion="3.0" date="2011-03-20" status="stub"/>
 
@@ -24,9 +25,9 @@
 
   <p>This guide is designed to help you troubleshoot and resolve problems with accessing a wireless network.</p>
 
-  <note><p>Due to the technical nature of trouble-shooting network problems, this guide contains some commands that will need to be entered into a <app>terminal</app> window. While this may seem intimidating at first, these commands present the easiest way of getting the information that you need to restore your network access.</p></note>
+  <note><p>Due to the technical nature of trouble-shooting network problems, this guide contains some commands that will need to be entered into a <app>terminal</app> window. While this may seem intimidating at first, do not be afraid! The guide will direct you at each step.</p></note>
 
-  <p>Trouble-shooting problems with wireless networks involves several steps. Throughout this portion of the guide, we will proceed through the following tasks to connect your computer to the internet:</p>
+  <p>We will proceed through the following tasks to connect your computer to the internet:</p>
   <list style="numbered">
     <item><p>Performing an initial check</p></item>
     <item><p>Gathering information about your hardware</p></item>
@@ -34,53 +35,6 @@
     <item><p>Attempting to create a connection to your wireless router</p></item>
     <item><p>Performing a check of your modem and router</p></item>
   </list>
-  <p>After we complete each step, click on the <em>Next</em> link in the upper-right portion of the page. This will take you to the next step in the guide.</p>
-
-  <section id="net-wireless-initial-check">
-    <title>Performing an initial check</title>
-  <p>Our first step will be to see if your computer is already connected to a wireless network.</p>
-  <steps>
-   <item><p>Make sure that your laptop is not connected to a <em>wired</em> internet connection.</p></item>
-   <item><p>If you have an external wireless adapter, make sure that it is plugged-in.</p></item>
-   <item><p>Make sure that your wireless adapter switch is turned on</p></item>
-   <item><p>In the <gui>Top Bar</gui>, make sure that you have not set the <gui>Wireless</gui> setting to <gui>Off</gui>.</p></item>
-   <item><p>Open a <app>terminal</app> window, and enter the following command:</p>
-  <p><cmd>nm-tool</cmd></p>
-   <p>The nm-tool program will display information about your network hardware and connection status. If the wireless connection output section contains the text:</p>
-  <p><code>State: Connected</code></p>
-  <p>then your wireless adapter is working and is connected to your wireless router.</p></item>
-  </steps>
-  <p>If you are connected to your wireless router, but you still cannot access the internet, your router may not be set up correctly, or your Internet Service Provider (ISP) maybe experiencing some technical problems. Review your router and ISP setup guides, or contact your ISP for support.</p>
-  <p>If the output from the <cmd>nm-tool</cmd> command did not indicate that you were connected to the network, click <gui>Next</gui> to proceed to the next portion of the troubleshooting guide.</p>
-  </section>
-<section id="net-hardware-check">  
-  <title>Gather information about your computer and network hardware:</title>
-  <p>For this section, it will be useful to have the follwing items available:</p>
-    <list>
-      <item><p>Your laptop and wireless router</p></item>
-      <item><p>The packaging and contents for your device (particularly the user guide for your router)</p></item>
-      <item><p>A driver disc - even if it only contains Windows drivers</p></item>
-      <item><p>An alternate working internet connection for downloading software and drivers</p></item>
-    </list>
-
-  <p>Additionally, it is helpful to have the following information:</p>
-    <list>
-      <item><p>The name of the device manufacturer</p></item>
-      <item><p>The complete model number of your computer and router</p></item>
-      <item><p>Any version numbers that may be printed on the device or its packaging. These can be crucial, so look carefully.</p></item>
-      <item><p>Anything on the driver disc that identifies either the device itself or the components it uses. Wireless implementation chips are often operated by firmware, a type of software written specifically for that chip.</p></item>
-    </list>
-
-<p>With this information available, we will proceed with the following steps</p>
-  <list>
-    <item><p>Checking your modem and router</p></item>
-    <item><p>Check if your wireless card is enabled and recognized by your computer.</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </list>
-
-  <p>make sure can identify your networking device</p>
-  <p>PCI device, USB device, internal device</p>
-</section>
+  <p>To get started, click on the <em>Next</em> link in the upper-right portion of the page. This link, and others like it on following pages, will take you through each step in the guide.</p>
    
 </page>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]