Merge pull request #13 from jposada202020/improving_docs

improving_docs

Author: kattni

README.rst

@@ -55,14 +55,13 @@ To install in a virtual environment in your current project:
 Usage Example
 =============
 
-.. code-block:: python
+.. code-block:: python3
 
     import time
     import board
-    import busio
     import adafruit_lsm303dlh_mag
 
-    i2c = busio.I2C(board.SCL, board.SDA)
+    i2c = board.I2C()  # uses board.SCL and board.SDA
     sensor = adafruit_lsm303dlh_mag.LSM303DLH_Mag(i2c)
 
     while True:

adafruit_lsm303dlh_mag.py

@@ -89,7 +89,31 @@
 class LSM303DLH_Mag:
     """Driver for the Driver for the LSM303DLH's 'magnetometer.
 
-    :param busio.I2C i2c_bus: The I2C bus the LSM303DLH is connected to.
+    :param ~busio.I2C i2c: The I2C bus the device is connected to.
+
+
+    **Quickstart: Importing and using the device**
+
+        Here is an example of using the :class:`LSM303DLH_Mag` class.
+        First you will need to import the libraries to use the sensor
+
+        .. code-block:: python
+
+            import board
+            import adafruit_lsm303dlh_mag
+
+        Once this is done you can define your `board.I2C` object and define your sensor object
+
+        .. code-block:: python
+
+            i2c = board.I2C()  # uses board.SCL and board.SDA
+            sensor = adafruit_lsm303dlh_mag.LSM303DLH_Mag(i2c)
+
+        Now you have access to the :attr:`magnetic` attribute
+
+        .. code-block:: python
+
+            mag_x, mag_y, mag_z = sensor.magnetic
 
     """
 

docs/examples.rst

@@ -7,6 +7,20 @@ Ensure your device works with these simple tests.
     :caption: examples/lsm303dlh_mag_simpletest.py
     :linenos:
 
+Fast Data Reading Example
+-------------------------
+
+Fast readings example
+
 .. literalinclude:: ../examples/lsm303dlh_mag_fast.py
     :caption: examples/lsm303dlh_mag_fast.py
     :linenos:
+
+Compass Example
+---------------
+
+Magnetic compass example
+
+.. literalinclude:: ../examples/lsm303dlh_mag_compass.py
+    :caption: examples/lsm303dlh_mag_compass.py
+    :linenos:

docs/index.rst

@@ -23,6 +23,11 @@ Table of Contents
 .. toctree::
     :caption: Tutorials
 
+    Adafruit LIS3DH Triple-Axis Accelerometer Breakout Learning Guide <https://learn.adafruit.com/adafruit-circuit-playground-express>
+
+    Circuit Playground Express Learning Guide <https://learn.adafruit.com/adafruit-circuit-playground-express>
+
+
 .. toctree::
     :caption: Related Products
 

examples/lsm303dlh_mag_compass.py

@@ -5,10 +5,9 @@
 import time
 from math import atan2, degrees
 import board
-import busio
 import adafruit_lsm303dlh_mag
 
-i2c = busio.I2C(board.SCL, board.SDA)
+i2c = board.I2C()  # uses board.SCL and board.SDA
 sensor = adafruit_lsm303dlh_mag.LSM303DLH_Mag(i2c)
 
 

examples/lsm303dlh_mag_fast.py

@@ -4,10 +4,9 @@
 """ Read data from the magnetometer and print it out, ASAP! """
 
 import board
-import busio
 import adafruit_lsm303dlh_mag
 
-i2c = busio.I2C(board.SCL, board.SDA)
+i2c = board.I2C()  # uses board.SCL and board.SDA
 sensor = adafruit_lsm303dlh_mag.LSM303DLH_Mag(i2c)
 
 while True:

examples/lsm303dlh_mag_simpletest.py

@@ -5,10 +5,9 @@
 
 import time
 import board
-import busio
 import adafruit_lsm303dlh_mag
 
-i2c = busio.I2C(board.SCL, board.SDA)
+i2c = board.I2C()  # uses board.SCL and board.SDA
 sensor = adafruit_lsm303dlh_mag.LSM303DLH_Mag(i2c)
 
 while True: