[gnome-user-docs/phone-connecting: 5/6] Add a page on tethering, and recommend it

[David King <davidk src gnome org>]

commit c7ac1075b2a264d745c98408fed659466b07ed20
Author: David King <amigadave amigadave com>
Date:   Sat Jul 20 05:48:43 2019 +0100

    Add a page on tethering, and recommend it
    
    As tethering is considerably simpler, and by far the more common method
    on modern phones, recommend it over using a 3G modem.
    
    Related: https://gitlab.gnome.org/GNOME/gnome-user-docs/issues/52

 gnome-help/C/hardware-phone-connecting.page.stub | 14 +++++---
 gnome-help/C/net-mobile.page                     | 15 ++++----
 gnome-help/C/net-tethering.page                  | 46 ++++++++++++++++++++++++
 3 files changed, 62 insertions(+), 13 deletions(-)
---
diff --git a/gnome-help/C/hardware-phone-connecting.page.stub 
b/gnome-help/C/hardware-phone-connecting.page.stub
index d4011bd2..d684da61 100644
--- a/gnome-help/C/hardware-phone-connecting.page.stub
+++ b/gnome-help/C/hardware-phone-connecting.page.stub
@@ -7,10 +7,11 @@
 
     <desc>XXXXX</desc>
 
-    <revision pkgversion="3.0" version="0.1" date="2011-03-25" status="stub"/>
+    <revision pkgversion="3.33.3" date="2019-07-20" status="review"/>
+
     <credit type="author">
-      <name>GNOME Documentation Project</name>
-      <email>gnome-doc-list gnome org</email>
+      <name>David King</name>
+      <email>amigadave amigadave com</email>
     </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
@@ -19,7 +20,10 @@
 <title>Connect a cell phone to your computer</title>
 
 <comment>
- <p>Explain how to connect a cell phone to the computer. Mention that the phone may not be supported. 
Mention bluetooth as a useful way of connecting.</p>
+ <p>Explain how to connect a cell phone to the computer. Mention that the phone
+may not be supported. Mention Bluetooth as a useful way of connecting for file
+transfer (sometimes, and not for iPhones). Does Bluetooth tethering work?
+Mention USB tethering as the best way of connecting to the mobile network.</p>
 </comment>
        
-</page>
\ No newline at end of file
+</page>
diff --git a/gnome-help/C/net-mobile.page b/gnome-help/C/net-mobile.page
index b7dfc9ad..9f95637a 100644
--- a/gnome-help/C/net-mobile.page
+++ b/gnome-help/C/net-mobile.page
@@ -9,7 +9,7 @@
     <revision pkgversion="3.14" date="2014-11-10" status="review"/>
     <revision pkgversion="3.18" date="2015-09-28" status="final"/>
     <revision pkgversion="3.24" date="2017-03-26" status="final"/>
-    <revision pkgversion="3.33" date="2019-07-10" status="candidate"/>
+    <revision pkgversion="3.33.3" date="2019-07-19" status="candidate"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -34,6 +34,12 @@
   <p>You can set up a connection to a cellular (3G) network with your
   computer’s built-in 3G modem, your mobile phone, or an Internet stick.</p>
 
+  <note style="tip">
+  <p>Most phones have a setting called <link xref="net-tethering">USB
+  tethering</link> that requires no setup on the computer, and is generally the
+  better method to connect to the cellular network.</p>
+  </note>
+
   <steps>
     <item><p>If you do not have a built-in 3G modem, connect your phone or
     Internet stick to a USB port on your computer.</p>
@@ -69,11 +75,4 @@
     connection.</p></item>
   </steps>
 
-    <note style = "tip">
-      <p>Some phones have a setting called <em>USB tethering</em> that requires
-      no setup on the computer. When the setting is activated on the phone, the
-      connection will show up as <gui>Ethernet Connected</gui> in the system
-      menu and <gui>USB ethernet</gui> in the network panel.</p>
-    </note>
-
 </page>
diff --git a/gnome-help/C/net-tethering.page b/gnome-help/C/net-tethering.page
new file mode 100644
index 00000000..9acf8ba2
--- /dev/null
+++ b/gnome-help/C/net-tethering.page
@@ -0,0 +1,46 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:its="http://www.w3.org/2005/11/its";
+      type="topic" style="task"
+      id="net-tethering">
+
+  <info>
+    <link type="guide"  xref="net-wireless"/>
+
+    <revision pkgversion="3.33.3" date="2019-07-19" status="review"/>
+
+    <credit type="author">
+      <name>David King</name>
+      <email>amigadave amigadave com</email>
+    </credit>
+
+    <desc>Use your phone to connect to the mobile broadband network.</desc>
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Tether a phone</title>
+
+  <p>You can set up a connection to a cellular (3G) network with your mobile
+  phone.</p>
+
+  <note>
+  <p>Tethering may be restricted for your network operator - check your
+  contract to make sure that tethering is permitted, and how it may impact
+  your data usage limits</p>
+  </note>
+
+  <steps>
+    <item><p>Connect your phone to your computer using an appropriate
+    cable.</p>
+    </item>
+    <item>
+    <p>Tethering is not generally enabled by default, so go into the settings
+    of the phone and make sure that it is set to on.</p>
+    </item>
+    <item>
+    <p>When the setting is activated on the phone, the connection will show up
+    as <gui>Ethernet Connected</gui> in the system menu and
+    <gui>USB ethernet</gui> in the network panel.</p>
+    </item>
+  </steps>
+
+</page>