Replace apt-get with apt

and other miscellaneous changes

docs/development.rst

@@ -32,7 +32,7 @@ within a virtual Python environment:
 
 .. code-block:: console
 
-    $ sudo apt-get install lsb-release build-essential git git-core \
+    $ sudo apt install lsb-release build-essential git git-core \
     >   exuberant-ctags virtualenvwrapper python-virtualenv python3-virtualenv \
     >   python-dev python3-dev
     $ cd
@@ -89,7 +89,7 @@ command should install all required dependencies:
 
 .. code-block:: console
 
-    $ sudo apt-get install texlive-latex-recommended texlive-latex-extra \
+    $ sudo apt install texlive-latex-recommended texlive-latex-extra \
         texlive-fonts-recommended graphviz inkscape
 
 Once these are installed, you can use the "doc" target to build the

docs/faq.rst

@@ -65,7 +65,7 @@ example::
     b = Button(17)
     b.when_pressed = pushed()
 
-In the case above, when assigning to the ``when_pressed``, the thing that is
+In the case above, when assigning to ``when_pressed``, the thing that is
 assigned is the *result of calling* the ``pushed`` function. Because ``pushed``
 doesn't explicitly return anything, the result is ``None``. Hence this is
 equivalent to doing::
@@ -113,7 +113,7 @@ suppress the warnings you've got a couple of options:
 
    .. code-block:: console
 
-       $ GPIOZERO_PIN_FACTORY=pigpio python
+       $ GPIOZERO_PIN_FACTORY=pigpio python3
 
    In this case no warning is issued because there's no fallback; either the
    specified factory loads or it fails in which case an :exc:`ImportError` will

docs/installing.rst

@@ -4,7 +4,8 @@ Installing GPIO Zero
 
 GPIO Zero is installed by default in `Raspbian Jessie`_ and `Raspbian x86`_,
 available from `raspberrypi.org`_. Follow these guides to installing on other
-operating systems, including for PCs using the :doc:`remote GPIO </remote_gpio>` feature.
+operating systems, including for PCs using the :doc:`remote GPIO <remote_gpio>`
+feature.
 
 Raspberry Pi
 ============

docs/recipes.rst

@@ -167,7 +167,8 @@ controlled:
 
 .. literalinclude:: examples/led_board_2.py
 
-See more :class:`LEDBoard` examples in :doc:`recipes_advanced`.
+See more :class:`LEDBoard` examples in the :ref:`advanced LEDBoard recipes
+<ledboard-advanced>`.
 
 LEDBarGraph
 ===========

docs/recipes_advanced.rst

@@ -8,6 +8,8 @@ The following recipes demonstrate some of the capabilities of the GPIO Zero
 library. Please note that all recipes are written assuming Python 3. Recipes
 *may* work under Python 2, but no guarantees!
 
+.. _ledboard-advanced:
+
 LEDBoard
 ========