docs update

Author: Martin O'Hanlon

docs/developing.rst

@@ -40,11 +40,11 @@ Install sphinx using ::
 
 To test the documentation build, run the following command from the docs directory ::
 
-    $ make html
+    $ ./make html
 
 The website will be built in the directory docs/_build/html.
 
-Documentation can be viewed at `picozero.readthedocs.io`_ and is automatically built and deployed on commit.
+Documentation can be viewed at `picozero.readthedocs.io`_ and is automatically built and deployed on push to github.
 
 .. _picozero.readthedocs.io: https://picozero.readthedocs.io
 

docs/examples/led_blink.py

@@ -1,5 +1,4 @@
 from picozero import LED
-from time import sleep
 
 led = LED(14)
 

docs/examples/led_pulse.py

@@ -1,5 +1,5 @@
-from time import sleep
 from picozero import LED
+from time import sleep
 from math import sin, radians
 
 led = LED(14) 

docs/examples/led_pulse_method.py

@@ -0,0 +1,5 @@
+from picozero import LED
+
+led = LED(14) 
+
+led.pulse()

docs/examples/pico_temperature.py

@@ -1,7 +1,7 @@
 # Choose View -> Plotter in Thonny to see a graph of the results
 
-from time import sleep
 from picozero import pico_temp_sensor
+from time import sleep
 
 while True:
     print(pico_temp_sensor.temp)

docs/examples/robot_rover_square.py

@@ -1,5 +1,4 @@
 from picozero import Robot
-from time import sleep
 
 robot_rover = Robot(left=(14,15), right=(12,13))
 

docs/gettingstarted.rst

@@ -2,9 +2,13 @@
 ..
 .. SPDX short identifier: MIT
 
+===============
 Getting started
 ===============
 
+Install using Thonny
+====================
+
 Requirements
 ------------
 
@@ -20,36 +24,53 @@ Once Thonny is installed, you will need to ensure that you are using the latest
 
 .. _Pico guide: https://learning-admin.raspberrypi.org/en/projects/introduction-to-the-pico/3
 
-Use the MicroPython interpreter
--------------------------------
+Select the MicroPython interpreter
+----------------------------------
 
 You can change which interpreter you are using in Thonny by selecting the desired option at the bottom right of the screen. Make sure that **MicroPython (Raspberry Pi Pico)** is selected.
 
 .. image:: images/thonny-switch-interpreter.jpg
+    :alt: Selecting MicroPython (Raspberry Pi Pico) from the interpreter menu in the bottom right of the Thonny IDE
 
 Install picozero from PyPI in Thonny
 ------------------------------------
 
 To install picozero within Thonny, select **Tools** > **Manage packages...**
 
 .. image:: images/thonny-manage-packages.jpg
+    :alt: Selecting Manage Packages from the Tools menu in Thonny
 
 Search for `picozero` on PyPI.
 
 .. image:: images/thonny-packages-picozero.jpg
+    :alt: picozero entered in the Search box of the Manage Packages window in Thonny
 
 Click on **install** to download the package.
 
 .. image:: images/thonny-install-package.jpg
+    :alt: Information about the picozero package shown in the Manage Packages window
+
+Manual install
+==============
+
+picozero can be installed by copying the ``picozero.py`` code to your Raspberry Pi Pico.
+
+Either clone the picozero `GitHub repository`_ or copy the code from the `picozero.py`_ file and save it on your main computer.
+
+.. _GitHub repository: https://github.com/RaspberryPiFoundation/picozero
+.. _picozero.py: https://raw.githubusercontent.com/RaspberryPiFoundation/picozero/master/picozero/picozero.py?token=GHSAT0AAAAAABRLTKWZDBSYBE54NJ7AIZ6MYSENI2A
+
+Create a new file called picozero.py, copy code into the file and save it on your Raspberry Pi Pico.
 
-Other install options
----------------------
+Copy picozero.py using Thonny
+-----------------------------
 
-You can use the Thonny file manager to transfer a ``picozero.py`` file to your Raspberry Pi Pico.
+Alternatively, you can use the Thonny file manager to transfer the ``picozero.py`` file to your Raspberry Pi Pico.
 
 In the **View** menu, ensure that the **Files** option has a tick. This will let you see the files.
 
 .. image:: images/thonny-view-files.jpg
+    :alt: The Files option selected from the View menu
 
 Either clone the picozero `GitHub repository`_ or copy the code from the `picozero.py`_ file and save it on your main computer.
 
@@ -63,10 +84,12 @@ In Thonny, navigate to the cloned directory or location you saved the file in an
 Right click on the file and select the **Upload to /** option. You should see a copy of the ``picozero.py`` file on the Raspberry Pi Pico.
 
 .. image:: images/thonny-upload-files.jpg
+    :alt: The "Upload to /" option selected in the picozero.py file menu
 .. image:: images/thonny-copy-picozero.jpg
+    :alt: The picozero.py file shown in the Raspberry Pi Pico file viewer.
 
 Write a program to control the onboard LED
-------------------------------------------
+==========================================
 
 The following code will blink the onboard LED at a frequency of once per second.::
 
@@ -79,8 +102,8 @@ The following code will blink the onboard LED at a frequency of once per second.
         pico_led.off()
         sleep(0.5)
 
-Run a program on your computer
-------------------------------
+Run the program on your computer
+--------------------------------
 
 You can choose to run the program from your computer.
 
@@ -92,8 +115,8 @@ Choose to save the script on **This computer** and provide a filename.
 
 .. image:: images/save-this-computer.png
 
-Run a program on your Raspberry Pi Pico
-----------------------------------
+Run the program on your Raspberry Pi Pico
+-----------------------------------------
 
 You can choose to run the program from the Raspberry Pi Pico.
 

docs/recipes.rst

@@ -114,8 +114,12 @@ Create a pulse effect:
 
 .. literalinclude:: examples/led_pulse.py
 
+Alternatively, you can use the :meth:`~picozero.LED.pulse` method.
+
+.. literalinclude:: examples/led_pulse_method.py
+
 Buttons
-------
+-------
 
 You can connect buttons and switches to a Raspberry Pi Pico and detect when they are pressed. 
 
@@ -142,7 +146,7 @@ Turn the :obj:`pico_led` on when a :class:`Button` is pressed and off when it is
 .. literalinclude:: examples/button_led.py
 
 RGB LEDs
-------
+--------
 
 Set colours with an :class:`RGBLED`:
 
@@ -176,7 +180,7 @@ The default for :meth:`~picozero.RGBLED.cycle` is to cycle from red to green, th
 .. literalinclude:: examples/rgb_cycle.py
 
 Potentiometer
----------------
+-------------
 
 Print the value, voltage, and percent reported by a potentiometer:
 
@@ -198,7 +202,7 @@ Control an active buzzer that plays a note when powered:
 .. literalinclude:: examples/buzzer.py
 
 Speaker
---------
+-------
 
 Control a passive buzzer or speaker that can play different tones or frequencies:
 
@@ -246,7 +250,7 @@ Move a motor connected via two pins (forward and backward) and a motor controlle
 .. literalinclude:: examples/motor_move.py
 
 Robot rover
--------------
+-----------
 
 Make a simple two-wheeled robot rover.