GNOME.org
 

[gnome-user-docs] Add topics on some net- topics

commit 5bad9411c005fd73cae1dea3f168b8f2d926df7c
Author: Phil Bull <philbull gmail com>
Date:   Tue Mar 22 01:01:26 2011 -0400

    Add topics on some net- topics

 gnome-help/C/net-wired-connect.page          |   16 +++++--
 gnome-help/C/net-wireless-airplane.page      |   10 ++--
 gnome-help/C/net-wireless-disconnecting.page |   53 +++++++++++++++++++-------
 gnome-help/C/net-wireless-find.page          |   30 ++++++++++++--
 gnome-help/C/net-wireless-hidden.page        |   18 ++++++--
 5 files changed, 93 insertions(+), 34 deletions(-)
---
diff --git a/gnome-help/C/net-wired-connect.page b/gnome-help/C/net-wired-connect.page
index 55c17c6..df96ac9 100644
--- a/gnome-help/C/net-wired-connect.page
+++ b/gnome-help/C/net-wired-connect.page
@@ -4,20 +4,26 @@
   <info>
     <link type="guide" xref="net#wired"/>
     
-    <revision pkgversion="3.0" date="2011-03-20" status="stub"/>
+    <revision pkgversion="3.0" date="2011-03-21" status="review"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
     </credit>
 
-    <desc>XXXXX</desc>
+    <desc>To set-up most wired network connections, all you need to do is plug in a network cable.</desc>
   </info>
 
 <title>Connect to a wired (Ethernet) network</title>
 
-<comment>
- <p>Explain how to connect to a wired network. Mention how you can plug in the network cable, and that it doesn't work if you connect one PC directly to another. Link to troubleshooting topics.</p>
-</comment>
+<p>To set-up most wired network connections, all you need to do is plug in a network cable. The network icon on the top panel should rotate for a few seconds and then will change to a "socket" icon when you are connected.</p>
+
+<p>If this does not happen, you should first of all make sure that your network cable is plugged in. One end of the cable should be plugged into the rectangular Ethernet (network) port on your computer, the other end should be plugged into a switch, router, wall socket or similar (depending on the network setup you have).</p>
+
+<note>
+ <p>You can't plug one computer directly into another one with a network cable (at least, not without some extra setting-up). To connect two computers, you should plug them both into a network hub, router or switch.</p>
+</note>
+
+<p>If you are still not connected, your network may not support automatic set-up (DHCP). In this case you'll have to <link xref="net-manual">configure it manually</link>.</p>
 
 </page>
diff --git a/gnome-help/C/net-wireless-airplane.page b/gnome-help/C/net-wireless-airplane.page
index fa2bf7c..708a61a 100644
--- a/gnome-help/C/net-wireless-airplane.page
+++ b/gnome-help/C/net-wireless-airplane.page
@@ -4,20 +4,20 @@
   <info>
     <link type="guide" xref="net#wireless"/>
     
-    <revision pkgversion="3.0" date="2011-03-20" status="stub"/>
+    <revision pkgversion="3.0" date="2011-03-21" status="review"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
     </credit>
 
-    <desc>XXXXX</desc>
+    <desc>Click the network icon on the top panel and switch Airplane Mode to ON.</desc>
   </info>
 
 <title>Turn off wireless (airplane mode)</title>
 
-<comment>
- <p>Explain how to turn-off the wireless by using the "airplane mode" switch. Explain why you might want to do this.</p>
-</comment>
+<p>If you have your computer on an airplane (or some other area where wireless connections are not allowed), you should switch off your wireless. You may also want to switch off your wireless for other reasons; to save battery power, for example.</p>
+
+<p>To do this, click the network icon on the top panel and switch <gui>Airplane Mode</gui> to <gui>ON</gui>. This will turn off your wireless connection until you switch off airplane mode again.</p>
 
 </page>
diff --git a/gnome-help/C/net-wireless-disconnecting.page b/gnome-help/C/net-wireless-disconnecting.page
index 85c913d..23f32ec 100644
--- a/gnome-help/C/net-wireless-disconnecting.page
+++ b/gnome-help/C/net-wireless-disconnecting.page
@@ -4,31 +4,56 @@
   <info>
     <link type="guide" xref="net#wireless"/>
     <link type="guide" xref="net#problems"/>
-    <revision pkgversion="3.0" date="2011-03-20" status="stub"/>
+    <revision pkgversion="3.0" date="2011-03-22" status="review"/>
 
     <credit type="author">
       <name>Jim Campbell</name>
       <email>jwcampbell gmail com</email>
       <years>2011</years>
     </credit>
+    
+    <credit type="author">
+      <name>Phil Bull</name>
+      <email>philbull gmail com</email>
+    </credit>
 
-    <desc>XXXXX</desc>
+    <desc>You might have low signal, or the network might not be letting you connect properly.</desc>
   </info>
 
-  <title>Why does my wireless network keep disconnecting?</title>
+<title>Why does my wireless network keep disconnecting?</title>
+
+<p>You may find that you have been disconnected from a wireless network even though you wanted to stay connected. Your computer will normally try to reconnect to the network as soon as this happens (the network icon on the top bar will rotate if it is trying to reconnect), but it can be annoying, especially if you were using the internet at the time.</p>
+
+<section id="signal">
+ <title>Weak wireless signal</title>
+
+ <p>A common reason for being disconnected from wireless network is that you have low signal. Wireless networks have a limited range, so if you are too far away from the wireless base station you may not be able to get a strong enough signal to maintain a connection. Walls and other objects between you and the base station can also weaken the signal.</p>
+ 
+ <p>The network icon on the top bar displays how strong your wireless signal is. If the signal looks low, try moving closer to the wireless base station.</p>
+ 
+</section>
+
+<section id="network">
+ <title>Network connection not being established properly</title>
 
-  <comment>
-    <cite date="2011-03-20" href="mailto:jwcampbell gmail com">Jim Campbell</cite>
-    <p>This assumes the reader knows how to.... By the end of this page,
-    the reader will be able to....</p>
-  </comment>
+ <p>Sometimes, when you connect to a wireless network, it may appear that you have successfully connected at first, but then you will be disconnected. This normally happens because your computer was only partially successful in connecting to the network - it managed to establish a connection, but was unable to finalize the connection for some reason and so was disconnected.</p>
+ 
+ <p>A possible reason for this was that you entered the wrong wireless passphrase, or that your computer was not allowed on the network (because the network requires a username to log-in, for example).</p>
+ 
+</section>
 
-  <p>Short introductory text...</p>
+<section id="hardware">
+ <title>Unreliable wireless hardware/drivers</title>
+ 
+ <p>Some wireless network hardware can be a little unreliable. Wireless networks are complicated, so wireless cards and base stations/routers occassionally run into minor problems and may drop connections. This is annoying, but it happens quite regularly with many devices. If you are disconnected from wireless connections from time to time, this may be the only reason. If it happens very regularly, you may want to consider using different hardware.</p>
+ 
+</section>
 
-  <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </steps>
+<section id="busy">
+ <title>Busy wireless networks</title>
+ 
+ <p>Wireless networks in busy places (in universities and coffee shops, for example) often have many computers trying to connect to them at once. Sometimes these networks get too busy and may not be able to handle all of the computers that are trying to connect, so some of them get disconnected.</p>
+ 
+</section>
 
 </page>
diff --git a/gnome-help/C/net-wireless-find.page b/gnome-help/C/net-wireless-find.page
index 4ca338b..1e64d8c 100644
--- a/gnome-help/C/net-wireless-find.page
+++ b/gnome-help/C/net-wireless-find.page
@@ -5,20 +5,40 @@
     <link type="guide" xref="net#wireless"/>
     <link type="seealso" xref="net-wireless-hidden"/>
     
-    <revision pkgversion="3.0" date="2011-03-20" status="stub"/>
+    <revision pkgversion="3.0" date="2011-03-22" status="review"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
     </credit>
 
-    <desc>XXXXX</desc>
+    <desc>The wireless could be turned off or broken, there might be too many wireless networks nearby, or you might be out of range.</desc>
   </info>
 
 <title>I can't see my wireless network in the list</title>
 
-<comment>
- <p>This is the list shown when you click the NM icon. It may be because the network is out of range, or it may be further down the list (there is an expander which shows the full list). It may also be a hidden network.</p>
-</comment>
+<p>There are a number of reasons why you might not be able to see your wireless network on the list of networks which appears when you click the network icon on the top bar.</p>
+
+<list>
+ <item>
+  <p>If no networks are shown in the list, your wireless hardware <link xref="net-no-wireless-connection">could be turned off</link>, or it <link xref="net-wireless-troubleshooting">may not be working properly</link>. Make sure it is turned on.</p>
+ </item>
+ 
+ <item>
+  <p>If there are lots of wireless networks nearby, the network you are looking for might not be on the first page of the list. If this is the case, look at the bottom of the list for an arrow pointing towards the right and hover your mouse over it to display the rest of the wireless networks.</p>
+ </item>
+ 
+ <item>
+  <p>You could be out of range of the network. Try moving closer to the wireless base station/router and see if the network appears in the list after a while.</p>
+ </item>
  
+ <item>
+  <p>The list of wireless networks takes time to update. If you have just turned on your computer or moved to a different location, wait for a minute or so and then check if the network has appeared in the list.</p>
+ </item>
+ 
+ <item>
+  <p>The network could be hidden. You need to <link xref="net-wireless-hidden">connect in a different way</link> if it is a hidden network.</p>
+ </item>
+</list>
+
 </page>
diff --git a/gnome-help/C/net-wireless-hidden.page b/gnome-help/C/net-wireless-hidden.page
index c3bfafa..b8cb399 100644
--- a/gnome-help/C/net-wireless-hidden.page
+++ b/gnome-help/C/net-wireless-hidden.page
@@ -4,20 +4,28 @@
   <info>
     <link type="guide" xref="net#wireless"/>
     
-    <revision pkgversion="3.0" date="2011-03-20" status="stub"/>
+    <revision pkgversion="3.0" date="2011-03-22" status="review"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
     </credit>
 
-    <desc>XXXXX</desc>
+    <desc>Click the network icon on the top bar and select <gui>Connect to Hidden Wireless Network</gui>.</desc>
   </info>
 
 <title>Connect to a hidden wireless network</title>
 
-<comment>
- <p>Explain how to do this. There's a NM option.</p>
-</comment>
+<p>It is possible to set-up a wireless network so that it is "hidden" - that is, it won't show up in the list of networks which is displayed when you click the network icon on the top bar (or the list of wireless networks on any other computer).</p>
+
+<p>To connect to a hidden wireless network, click the network icon on the top bar and select <gui>Connect to Hidden Wireless Network</gui>. In the window that appears, type the network name, choose the type of wireless security and click <gui>Connect</gui>.</p>
+
+<p>You may have to check the settings of the wireless base station/router to see what the network name is. It is sometimes called the <em>BSSID</em> (Service Set Identifier), and looks something like this: <gui>02:00:01:02:03:04</gui>.</p>
+
+<p>You should also check the wireless base station's security settings; look for terms like WEP and WPA.</p>
+
+<note>
+ <p>You may think that hiding your wireless network will improve security by preventing people who don't know about it from connecting. In practice, this is not the case; the network is slightly harder to find but it is still detectable.</p>
+</note>
  
 </page>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]