fix documentation problems

Author: dhalbert

adafruit_bluefruit_connect/__init__.py

@@ -21,7 +21,7 @@
 # THE SOFTWARE.
 """
 `adafruit_bluefruit_connect`
-====================================================
+============================
 
 This module helps you to communicate with the Adafruit Bluefruit Connect app or use its protocols.
 
@@ -32,7 +32,7 @@
 
 **Hardware:**
 
-   inline format: "* `Adafruit Feather nRF52840 Express <https://www.adafruit.com/product/4062>`_"
+   Adafruit Feather nRF52840 Express <https://www.adafruit.com/product/4062>
 
 **Software and Dependencies:**
 

adafruit_bluefruit_connect/button_packet.py

@@ -20,7 +20,7 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 # THE SOFTWARE.
 """
-`adafruit_bluefruit_connect.controller_packet`
+`adafruit_bluefruit_connect.button_packet`
 ====================================================
 
 Bluefruit Connect App Button data packet (button_name, pressed/released)

adafruit_bluefruit_connect/location_packet.py

@@ -20,7 +20,7 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 # THE SOFTWARE.
 """
-`adafruit_bluefruit_connect.controller_packet`
+`adafruit_bluefruit_connect.location_packet`
 ====================================================
 
 Bluefruit Connect App geographical location packet.

adafruit_bluefruit_connect/packet.py

@@ -59,7 +59,7 @@ class Packet:
 
     @classmethod
     def register_packet_type(cls):
-        """Register a new packet type, using this class and its `cls._TYPE_HEADER`
+        """Register a new packet type, using this class and its ``cls._TYPE_HEADER``.
         The ``from_bytes()`` and ``from_stream()`` methods will then be able
         to recognize this type of packet.
         """
@@ -97,11 +97,11 @@ def from_stream(cls, stream):
         """Read the next packet from the incoming stream. Wait as long as the timeout
         set on stream, using its own preset timeout.
         Return None if there was no input, otherwise return an instance
-        of one of the packet classes registered with `Packet`.
+        of one of the packet classes registered with ``Packet``.
         Raise an Error if the packet was not recognized or was malformed
 
         :param stream stream: an input stream that provides standard stream read operations,
-          such as `ble.UARTServer` or `busio.UART`.
+          such as ``ble.UARTServer`` or ``busio.UART``.
         """
         header = stream.read(2)
         if len(header) != 2 or header[0] != ord(b'!'):

docs/api.rst

@@ -4,5 +4,26 @@
 .. If your library file(s) are nested in a directory (e.g. /adafruit_foo/foo.py)
 .. use this format as the module name: "adafruit_foo.foo"
 
-.. automodule:: adafruit_bluefruit_connect
+.. automodule:: adafruit_bluefruit_connect.packet
+   :members:
+
+.. automodule:: adafruit_bluefruit_connect.accelerometer_packet
+   :members:
+
+.. automodule:: adafruit_bluefruit_connect.button_packet
+   :members:
+
+.. automodule:: adafruit_bluefruit_connect.color_packet
+   :members:
+
+.. automodule:: adafruit_bluefruit_connect.gyro_packet
+   :members:
+
+.. automodule:: adafruit_bluefruit_connect.location_packet
+   :members:
+
+.. automodule:: adafruit_bluefruit_connect.magnetometer_packet
+   :members:
+
+.. automodule:: adafruit_bluefruit_connect.quaternion_packet
    :members:

docs/examples.rst

@@ -6,3 +6,9 @@ Ensure your device works with this simple test.
 .. literalinclude:: ../examples/bluefruit_connect_simpletest.py
     :caption: examples/bluefruit_connect_simpletest.py
     :linenos:
+
+This test demonstrates controlling an Adafruit Crickit board with Bluetooth.
+
+.. literalinclude:: ../examples/bluefruit_connect_crickit_test.py
+    :caption: examples/bluefruit_connect_crickit_test.py
+    :linenos: