[gnome-user-docs] Write topic on VPN connections

[Phil Bull <philbull src gnome org>]

commit 5fe488e58d9830503990994ea015f41704a97e94
Author: Phil Bull <philbull gmail com>
Date:   Fri Apr 1 19:23:49 2011 +0100

    Write topic on VPN connections

 gnome-help/C/net-vpn-connect.page |   42 ++++++++++++++++++++++++++++++++----
 1 files changed, 37 insertions(+), 5 deletions(-)
---
diff --git a/gnome-help/C/net-vpn-connect.page b/gnome-help/C/net-vpn-connect.page
index 3631510..7bd98a8 100644
--- a/gnome-help/C/net-vpn-connect.page
+++ b/gnome-help/C/net-vpn-connect.page
@@ -4,20 +4,52 @@
   <info>
     <link type="guide" xref="net#vpn"/>
     
-    <revision pkgversion="3.0" date="2011-03-20" status="stub"/>
+    <revision pkgversion="3.0" date="2011-04-01" status="review"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
     </credit>
 
-    <desc>XXXXX</desc>
+    <desc>VPNs allow you to connect to a local network over the internet. Learn how to set-up a VPN connection.</desc>
   </info>
 
 <title>Connect to a VPN</title>
 
-<comment>
- <p>Explain what a VPN is, why you might want to connect to one, and how you can actually make the connection. Users might have to install different packages depending on the VPN they are connecting to, e.g. vpnc for Cisco VPNs.</p>
-</comment>
+<p>A VPN (or <em>Virtual Private Network</em>) is a way of connecting to a local network over the internet. For example, say you want to connect to the local network at your workplace while you're on a business trip. You would find an internet connection somewhere (like at a hotel) and then connect to your workplace's VPN. It would be as if you were directly connected to the network at work, but the actual network connection would be through the hotel's internet connection. VPN connections are usually <em>encrypted</em> to prevent people from accessing the local network you're connecting to without logging in.</p>
+
+<p>There are a number of different types of VPN. You may have to install some extra software depending on what type of VPN you're connecting to. Find out the connection details from whoever is in charge of the VPN and see which <em>VPN client</em> you need to use. Then, go to the software installer application and search for the <app>NetworkManager</app> package which works with your VPN (if there is one) and install it.</p>
+
+<note>
+ <p>If there isn't a NetworkManager package for your type of VPN, you will probably have to download and install some client software from the company that provides the VPN software. You'll probably have to follow some different instructions to get that working.</p>
+</note>
+
+<p>Once that's done, you can set up the VPN connection:</p>
+
+<steps>
+ <item>
+  <p>Click the network icon on the top bar and, under <gui>VPN Connections</gui>, select <gui>Configure VPN</gui>.</p>
+ </item>
+ 
+ <item>
+  <p>Click <gui>Add</gui> and choose which kind of VPN connection you have.</p>
+ </item>
+ 
+ <item>
+  <p>Click <gui>Create</gui> and follow the instructions on the screen, entering details like your username and password as you go.</p>
+ </item>
+ 
+ <item>
+  <p>When you've finished setting-up the VPN, click the network icon on the top bar, go to <gui>VPN Connections</gui> and click on the connection you just created. It will try to establish a VPN connection - the network icon will change as it tries to connect.</p>
+ </item>
+ 
+ <item>
+  <p>Hopefully, you will successfully connect to the VPN. If not, you may need to double-check the VPN settings you entered. You can do this by clicking the network icon, clicking <gui>Edit Connections</gui> and going to the <gui>VPN</gui> tab.</p>
+ </item>
+ 
+ <item>
+  <p>To disconnect from the VPN, click the network icon on the top bar and click <gui>Disconnect</gui> under the name of your VPN connection.</p>
+ </item>
+</steps>
 
 </page>