Example lint and doc TODOs

Author: tannewt

README.rst

@@ -35,9 +35,6 @@ Installing from PyPI
 .. note:: This library is not available on PyPI yet. Install documentation is included
    as a standard element. Stay tuned for PyPI availability!
 
-.. todo:: Remove the above note if PyPI version is/will be available at time of release.
-   If the library is not planned for PyPI, remove the entire 'Installing from PyPI' section.
-
 On supported GNU/Linux systems like the Raspberry Pi, you can install the driver locally `from
 PyPI <https://pypi.org/project/adafruit-circuitpython-pioasm/>`_. To install for current user:
 
@@ -63,7 +60,30 @@ To install in a virtual environment in your current project:
 Usage Example
 =============
 
-.. todo:: Add a quick, simple example. It and other examples should live in the examples folder and be included in docs/examples.rst.
+.. code-block:: python
+
+    import time
+    import rp2pio
+    import board
+    import adafruit_pioasm
+
+    squarewave = """
+    .program squarewave
+        set pins 1 [1]  ; Drive pin high and then delay for one cycle
+        set pins 0      ; Drive pin low
+    """
+
+    assembled = adafruit_pioasm.assemble(squarewave)
+
+    sm = rp2pio.StateMachine(
+        assembled,
+        frequency=80,
+        init=adafruit_pioasm.assemble("set pindirs 1"),
+        first_set_pin=board.LED,
+    )
+    print("real frequency", sm.frequency)
+
+    time.sleep(120)
 
 Contributing
 ============

docs/index.rst

@@ -23,14 +23,15 @@ Table of Contents
 .. toctree::
     :caption: Tutorials
 
-.. todo:: Add any Learn guide links here. If there are none, then simply delete this todo and leave
-    the toctree above for use later.
+    Getting Started with Raspberry Pi Pico and CircuitPython <https://learn.adafruit.com/getting-started-with-raspberry-pi-pico-circuitpython>
 
 .. toctree::
     :caption: Related Products
 
-.. todo:: Add any product links here. If there are none, then simply delete this todo and leave
-    the toctree above for use later.
+    Adafruit ItsyBitsy RP2040 <https://www.adafruit.com/product/4888>
+    Adafruit Feather RP2040 <https://www.adafruit.com/product/4884>
+    Raspberry Pi Pico RP2040 <https://www.adafruit.com/product/4864>
+    Raspberry Pi Pico RP2040 with Loose Headers <https://www.adafruit.com/product/4883>
 
 .. toctree::
     :caption: Other Links

examples/pioasm_neopixel.py

@@ -2,11 +2,10 @@
 #
 # SPDX-License-Identifier: MIT
 
+import time
 import rp2pio
 import board
-import time
 import adafruit_pioasm
-import digitalio
 
 # NeoPixels are 800khz bit streams. Zeroes are 1/3 duty cycle (~416ns) and ones
 # are 2/3 duty cycle (~833ns).

examples/pioasm_simpletest.py

@@ -2,11 +2,10 @@
 #
 # SPDX-License-Identifier: MIT
 
+import time
 import rp2pio
 import board
-import time
 import adafruit_pioasm
-import digitalio
 
 squarewave = """
 .program squarewave