docs: Backport last V2 changes to V1 docs. (#748)

microbit-carlos · web-flow · commit fe0e8dde0c35 · 2022-06-17T17:20:27.000+01:00
The main change is removing the Installation page, as I forgot to remove the file in PR #745 Took the opportunity to add a few very minor formatting changes from the v2-docs branch, which wil reduce the diff with the main branch.
diff --git a/docs/devguide/installation.rst b/docs/devguide/installation.rst
diff --git a/docs/index.rst b/docs/index.rst
@@ -8,9 +8,10 @@ BBC micro:bit MicroPython documentation
 
 Welcome!
 
-The BBC micro:bit is a small computing device for children. One of the
-languages it understands is the popular Python programming language. The
-version of Python that runs on the BBC micro:bit is called MicroPython.
+The `BBC micro:bit <https://microbit.org>`_ is a small computing device for
+children. One of the languages it understands is the popular Python programming
+language. The version of Python that runs on the BBC micro:bit is called
+MicroPython.
 
 This documentation includes lessons for teachers
 and API documentation for developers (check out the index on the left). We hope
diff --git a/docs/microbit_micropython_api.rst b/docs/microbit_micropython_api.rst
@@ -73,9 +73,12 @@ The LED display is exposed via the `display` object::
 Pins
 ----
 
-Provide digital and analog input and output functionality, for the pins in the connector. Some pins are connected internally to the I/O that drives the LED matrix and the buttons.
+Provide digital and analog input and output functionality, for the pins in the
+connector. Some pins are connected
+internally to the I/O that drives the LED matrix and the buttons.
 
-Each pin is provided as an object directly in the ``microbit`` module.  This keeps the API relatively flat, making it very easy to use:
+Each pin is provided as an object directly in the ``microbit`` module.  This
+keeps the API relatively flat, making it very easy to use:
 
     * pin0
     * pin1
@@ -102,7 +105,8 @@ Each of these pins are instances of the ``MicroBitPin`` class, which offers the
     # sets the period of the PWM output of the pin in microseconds
     # (see https://en.wikipedia.org/wiki/Pulse-width_modulation)
     pin.set_analog_period_microseconds(int)
-    # returns boolean
+    # Only available for touch pins 0, 1, and 2. Returns boolean if the pin
+    # is touched
     pin.is_touched()
 
 Images
diff --git a/docs/music.rst b/docs/music.rst
@@ -109,12 +109,12 @@ Functions
 
     If ``wait`` is set to ``True``, this function is blocking.
 
-    If ``duration`` is negative the pitch is played continuously until either the
-    blocking call is interrupted or, in the case of a background call, a new
-    frequency is set or ``stop`` is called (see below).
+    If ``duration`` is negative the pitch is played continuously until either
+    the blocking call is interrupted or, in the case of a background call, a
+    new frequency is set or ``stop`` is called (see below).
 
 .. py:function:: stop(pin=pin0)
-    
+
     Stops all music playback on a given pin, eg. ``music.stop(pin1)``. 
     If no pin is given, eg. ``music.stop()`` pin0 is assumed.
 
