From 9669470d73287472015a9083432014bb8747bb09 Mon Sep 17 00:00:00 2001
From: sommersoft <sommersoft@gmail.com>
Date: Wed, 13 Feb 2019 19:00:18 -0600
Subject: [PATCH 1/9] add docs folder

---
 docs/_static/favicon.ico | Bin 0 -> 4414 bytes
 docs/conf.py             | 164 +++++++++++++++++++++++++++++++++++++++
 docs/index.rst           |  32 ++++++++
 3 files changed, 196 insertions(+)
 create mode 100644 docs/_static/favicon.ico
 create mode 100644 docs/conf.py
 create mode 100644 docs/index.rst

diff --git a/docs/_static/favicon.ico b/docs/_static/favicon.ico
new file mode 100644
index 0000000000000000000000000000000000000000..5aca98376a1f7e593ebd9cf41a808512c2135635
GIT binary patch
literal 4414
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

literal 0
HcmV?d00001

diff --git a/docs/conf.py b/docs/conf.py
new file mode 100644
index 00000000..1e4b1a24
--- /dev/null
+++ b/docs/conf.py
@@ -0,0 +1,164 @@
+# -*- coding: utf-8 -*-
+
+import os
+import sys
+sys.path.insert(0, os.path.abspath('..'))
+
+# -- General configuration ------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    'sphinx.ext.autodoc',
+    'sphinx.ext.intersphinx',
+    'sphinx.ext.napoleon',
+    'sphinx.ext.todo',
+]
+
+# TODO: Please Read!
+# Uncomment the below if you use native CircuitPython modules such as
+# digitalio, micropython and busio. List the modules you use. Without it, the
+# autodoc module docs will fail to generate with a warning.
+# autodoc_mock_imports = ["digitalio", "busio"]
+
+
+intersphinx_mapping = {'python': ('https://docs.python.org/3.4', None),
+                       'BusDevice': ('https://circuitpython.readthedocs.io/projects/busdevice/en/latest/', None),
+                       'Register': ('https://circuitpython.readthedocs.io/projects/register/en/latest/', None),
+                       'CircuitPython': ('https://circuitpython.readthedocs.io/en/latest/', None)
+                       }
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+source_suffix = '.rst'
+
+# The master toctree document.
+master_doc = 'index'
+
+# General information about the project.
+project = u'Adafruit CircuitPython Bundle'
+copyright = u'2019 Adafruit'
+author = u'Adabot'
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The short X.Y version.
+version = u'1.0'
+# The full version, including alpha/beta/rc tags.
+release = u'1.0'
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This patterns also effect to html_static_path and html_extra_path
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store', '.env', 'CODE_OF_CONDUCT.md']
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+#
+default_role = "any"
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+#
+add_function_parentheses = True
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = 'sphinx'
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = False
+
+# If this is True, todo emits a warning for each TODO entries. The default is False.
+todo_emit_warnings = True
+
+napoleon_numpy_docstring = False
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
+
+if not on_rtd:  # only import and set the theme if we're building docs locally
+    try:
+        import sphinx_rtd_theme
+        html_theme = 'sphinx_rtd_theme'
+        html_theme_path = [sphinx_rtd_theme.get_html_theme_path(), '.']
+    except:
+        html_theme = 'default'
+        html_theme_path = ['.']
+else:
+    html_theme_path = ['.']
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+# The name of an image file (relative to this directory) to use as a favicon of
+# the docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+#
+html_favicon = '_static/favicon.ico'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = 'AdafruitBundleLibrarydoc'
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+     # The paper size ('letterpaper' or 'a4paper').
+     #
+     # 'papersize': 'letterpaper',
+
+     # The font size ('10pt', '11pt' or '12pt').
+     #
+     # 'pointsize': '10pt',
+
+     # Additional stuff for the LaTeX preamble.
+     #
+     # 'preamble': '',
+
+     # Latex figure (float) alignment
+     #
+     # 'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (master_doc, 'AdafruitBundleLibrary.tex', u'AdafruitBundle Documentation',
+     author, 'manual'),
+]
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (master_doc, 'AdafruitBundlelibrary', u'Adafruit Bundle Documentation',
+     [author], 1)
+]
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (master_doc, 'AdafruitBundleLibrary', u'Adafruit Bundle Documentation',
+     author, 'AdafruitBundleLibrary', 'One line description of project.',
+     'Miscellaneous'),
+]
diff --git a/docs/index.rst b/docs/index.rst
new file mode 100644
index 00000000..b82297bf
--- /dev/null
+++ b/docs/index.rst
@@ -0,0 +1,32 @@
+.. include:: ../README.rst
+
+Table of Contents
+=================
+
+.. toctree::
+    :maxdepth: 4
+    :hidden:
+
+    self
+
+.. toctree::
+
+    Drivers
+
+.. toctree::
+    :caption: Other Links
+
+    Download <https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases/latest>
+    CircuitPython Reference Documentation <https://circuitpython.readthedocs.io>
+    CircuitPython Support Forum <https://forums.adafruit.com/viewforum.php?f=60>
+    Discord Chat <https://adafru.it/discord>
+    Adafruit Learning System <https://learn.adafruit.com>
+    Adafruit Blog <https://blog.adafruit.com>
+    Adafruit Store <https://www.adafruit.com>
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`

From 1ded2bb27f4c11fe103acdd0e5beae8a4bd3e00c Mon Sep 17 00:00:00 2001
From: sommersoft <sommersoft@gmail.com>
Date: Wed, 13 Feb 2019 19:04:37 -0600
Subject: [PATCH 2/9] add .readthedocs.yml

---
 .readthedocs.yml | 2 ++
 1 file changed, 2 insertions(+)
 create mode 100644 .readthedocs.yml

diff --git a/.readthedocs.yml b/.readthedocs.yml
new file mode 100644
index 00000000..8b77f690
--- /dev/null
+++ b/.readthedocs.yml
@@ -0,0 +1,2 @@
+python:
+    version: 3

From 909eb8d9467d78fcf1baeeb0683b0eb111ff28c0 Mon Sep 17 00:00:00 2001
From: sommersoft <sommersoft@gmail.com>
Date: Wed, 13 Feb 2019 19:07:45 -0600
Subject: [PATCH 3/9] inital add of drivers.rst

---
 docs/drivers.rst | 252 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 252 insertions(+)
 create mode 100644 docs/drivers.rst

diff --git a/docs/drivers.rst b/docs/drivers.rst
new file mode 100644
index 00000000..148db804
--- /dev/null
+++ b/docs/drivers.rst
@@ -0,0 +1,252 @@
+.. _adafruit-libndrivers:
+
+Additional Adafruit Libraries and Drivers on GitHub
+===================================================
+
+These are libraries and drivers available in separate GitHub repos. They are
+designed for use with CircuitPython and may or may not work with
+`MicroPython <https://micropython.org>`_.
+
+.. _bundle_installation:
+
+Bundle
+------
+
+We provide a bundle of all our libraries to ease installation of drivers and
+their dependencies. The bundle is primarily geared to the Adafruit Express line
+of boards which feature a relatively large external flash. With Express boards,
+its easy to copy them all onto the filesystem. However, if you don't have
+enough space simply copy things over as they are needed.
+
+The bundles are available `on GitHub <https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases>`_.
+
+To install them:
+
+#. `Download <https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases>`_
+   and unzip the latest zip that's not a source zip.
+#. Copy the ``lib`` folder to the ``CIRCUITPY`` or ``MICROPYTHON``.
+
+Foundational
+------------
+
+These libraries provide critical functionality to many of the drivers below. It
+is recommended to always have them installed onto the CircuitPython file system in
+the ``lib/`` directory. Some drivers may not work without them.
+
+.. toctree::
+
+   Register Library <https://circuitpython.readthedocs.io/projects/register/en/latest/>
+   BusDevice Library <https://circuitpython.readthedocs.io/projects/busdevice/en/latest/>
+
+Board-specific Helpers
+----------------------
+
+These libraries tie lower-level libraries together to provide an easy, out-of-box experience for
+specific boards.
+
+.. toctree::
+
+    Adafruit CircuitPlayground Express <https://circuitpython.readthedocs.io/projects/circuitplayground/en/latest/>
+    Adafruit FeatherWings <https://circuitpython.readthedocs.io/projects/featherwing/en/latest/>
+
+Helper Libraries
+-----------------
+
+These libraries build on top of the low level APIs to simplify common tasks.
+
+.. toctree::
+
+    USB Human Interface Device (Keyboard and Mouse) <https://circuitpython.readthedocs.io/projects/hid/en/latest/>
+    Waveform Generation <https://circuitpython.readthedocs.io/projects/waveform/en/latest/>
+    OneWire <https://circuitpython.readthedocs.io/projects/onewire/en/latest/>
+    Ring Tone Text Transfer Language (RTTTL) <https://circuitpython.readthedocs.io/projects/rtttl/en/latest/>
+    InfraRed Remote <https://circuitpython.readthedocs.io/projects/irremote/en/latest/>
+    Fancy LED (similar to FastLED) <https://circuitpython.readthedocs.io/projects/fancyled/en/latest/>
+    SimpleIO <https://circuitpython.readthedocs.io/projects/simpleio/en/latest/>
+    AVR programming <https://circuitpython.readthedocs.io/projects/avrprog/en/latest/>
+    DC Motor and Servo <https://circuitpython.readthedocs.io/projects/motor/en/latest/>
+    SD Card <https://circuitpython.readthedocs.io/projects/sd/en/latest/>
+    Image Load <https://circuitpython.readthedocs.io/projects/imageload/en/latest/>
+    miniQR Non-hardware QR code generator <https://circuitpython.readthedocs.io/projects/miniqr/en/latest/>
+    Slideshow <https://circuitpython.readthedocs.io/projects/slideshow/en/latest/>
+    LED Animation <https://circuitpython.readthedocs.io/projects/led-animation/en/latest/>
+    Bluetooth Low Energy (BLE)  <https://circuitpython.readthedocs.io/projects/ble/en/latest/>
+    Bluefruit LE Connect App  <https://circuitpython.readthedocs.io/projects/bluefruitconnect/en/latest/>
+
+Blinky
+--------
+
+Multi-color led drivers.
+
+.. toctree::
+
+    NeoPixel <https://circuitpython.readthedocs.io/projects/neopixel/en/latest/>
+    DotStar <https://circuitpython.readthedocs.io/projects/dotstar/en/latest/>
+    WS2801 <https://circuitpython.readthedocs.io/projects/ws2801/en/latest/>
+    Pixie <https://circuitpython.readthedocs.io/projects/pixie/en/latest/>
+
+Displays
+-------------
+
+Drivers used to display information. Either pixel or segment based.
+
+.. toctree::
+
+    RGB Displays <https://circuitpython.readthedocs.io/projects/rgb_display/en/latest/>
+    Character LCD <https://circuitpython.readthedocs.io/projects/charlcd/en/latest/>
+    HT16K33 LED Matrices and Segment Displays <https://circuitpython.readthedocs.io/projects/ht16k33/en/latest/>
+    IS31FL3731 Charlieplexed LED Matrix <https://circuitpython.readthedocs.io/projects/is31fl3731/en/latest/>
+    MAX7219 LED Matrix <https://circuitpython.readthedocs.io/projects/max7219/en/latest/>
+    SSD1306 OLED Driver <https://circuitpython.readthedocs.io/projects/ssd1306/en/latest/>
+    E-Paper Display <https://circuitpython.readthedocs.io/projects/epd/en/latest/>
+
+Real-time clocks
+-----------------
+
+Chips that keep current calendar time with a backup battery. The current date and time is available
+through ``datetime``.
+
+.. toctree::
+
+    DS1307 Real-time Clock (5V RTC Breakout) <https://circuitpython.readthedocs.io/projects/ds1307/en/latest/>
+    DS3231 Real-time Clock (Precision RTC) <https://circuitpython.readthedocs.io/projects/ds3231/en/latest/>
+    PCF8523 Real-time Clock (Adalogger RTC) <https://circuitpython.readthedocs.io/projects/pcf8523/en/latest/>
+
+Motion Sensors
+----------------
+
+Motion relating sensing including ``acceleration``, ``magnetic``, ``gyro``, and ``orientation``.
+
+.. toctree::
+
+    ADXL34x 3 Axis Accelerometer <https://circuitpython.readthedocs.io/projects/adxl34x/en/latest/>
+    BNO055 Accelerometer, Magnetometer, Gyroscope and Absolution Orientation <https://circuitpython.readthedocs.io/projects/bno055/en/latest/>
+    FXAS21002C Gyroscope <https://circuitpython.readthedocs.io/projects/fxas21002c/en/latest/>
+    FXOS8700 Accelerometer <https://circuitpython.readthedocs.io/projects/fxos8700/en/latest/>
+    GPS Global Position <https://circuitpython.readthedocs.io/projects/gps/en/latest/>
+    L3GD20 Gyroscope <https://circuitpython.readthedocs.io/projects/l3gd20/latest/>
+    LIS3DH Accelerometer <https://circuitpython.readthedocs.io/projects/lis3dh/en/latest/>
+    LSM303 Accelerometer and Magnetometer <https://circuitpython.readthedocs.io/projects/lsm303/en/latest/>
+    LSM9DS0 Accelerometer, Magnetometer, Gyroscope and Temperature <https://circuitpython.readthedocs.io/projects/lsm9ds0/en/latest/>
+    LSM9DS1 Accelerometer, Magnetometer, Gyroscope and Temperature <https://circuitpython.readthedocs.io/projects/lsm9ds1/en/latest/>
+    MLX90390 3 Axis Mangetometer <https://circuitpython.readthedocs.io/projects/mlx90393/en/latest/>
+    MMA8451 3 axis accelerometer <https://circuitpython.readthedocs.io/projects/mma8451/en/latest/>
+
+Environmental Sensors
+----------------------
+
+Sense attributes of the environment including ``temperature``, ``relative_humidity``, ``pressure``,
+equivalent carbon dioxide (``eco2`` / ``eCO2``), and total volatile organic compounds (``tvoc`` /
+``TVOC``).
+
+.. toctree::
+
+    AM2320 Temperature and Humidity <https://circuitpython.readthedocs.io/projects/am2320/en/latest/>
+    BME280 Temperature, Humidity and Pressure <https://circuitpython.readthedocs.io/projects/bme280/en/latest/>
+    BME680 Temperature, Humidity, Pressure and Gas <https://circuitpython.readthedocs.io/projects/bme680/en/latest/>
+    BMP280 Barometric Pressure and Altitude <https://circuitpython.readthedocs.io/projects/bmp280/en/latest/>
+    BMP3xx Barometric Pressure and Altimeter <https://circuitpython.readthedocs.io/projects/bmp3xx/en/latest/>
+    CCS811 Air Quality <https://circuitpython.readthedocs.io/projects/ccs811/en/latest/>
+    DHT Temperature and Humidity <https://circuitpython.readthedocs.io/projects/dht/en/latest/>
+    DS18x20 Temperature <https://circuitpython.readthedocs.io/projects/ds18x20/en/latest/>
+    HTU21D Temperature and Humidity <https://circuitpython.readthedocs.io/projects/htu21d/en/latest/>
+    MAX31865 Thermocouple Amplifier, Temperature <https://circuitpython.readthedocs.io/projects/max31865/en/latest/>
+    MAX31855 Thermocouple Amplifier, Temperature <https://circuitpython.readthedocs.io/projects/max31855/en/latest/>
+    MAX31856 Thermocouple Amplifier, Temperature <https://circuitpython.readthedocs.io/projects/max31856/en/latest/>
+    MCP9808 Temperature <https://circuitpython.readthedocs.io/projects/mcp9808/en/latest/>
+    MP115A2 Barometric Pressure, Temperature <https://circuitpython.readthedocs.io/projects/mpl115a2/en/latest/>
+    MPL3115A2 Barometric Pressure, Altitude and Temperature Sensor <https://circuitpython.readthedocs.io/projects/mpl3115a2/en/latest/>
+    MPRLS Ported Absolute Pressure <https://circuitpython.readthedocs.io/projects/mprls/en/latest/>
+    SGP30 Air Quality <https://circuitpython.readthedocs.io/projects/sgp30/en/latest/>
+    SHT31-D Temperature and Humidity <https://circuitpython.readthedocs.io/projects/sht31d/en/latest/>
+    Si7021 Temperature and Humidity <https://circuitpython.readthedocs.io/projects/si7021/en/latest/>
+    Thermistor Temperature <https://circuitpython.readthedocs.io/projects/thermistor/en/latest/>
+    TMP007 Contactless Temperature <https://circuitpython.readthedocs.io/projects/tmp007/en/latest/>
+    MLX90614 Contactless Temperature <https://circuitpython.readthedocs.io/projects/mlx90614/en/latest/>
+
+Light Sensors
+---------------
+
+These sensors detect light related attributes such as ``color``, ``light`` (unit-less), and
+``lux`` (light in SI lux).
+
+.. toctree::
+
+    APDS9960 Proximity, Light, RGB, and Gesture <https://circuitpython.readthedocs.io/projects/apds9960/en/latest/>
+    AS726x Color Spectrum Sensor <https://circuitpython.readthedocs.io/projects/as726x/en/latest/>
+    TCS34725 Color Sensor <https://circuitpython.readthedocs.io/projects/tcs34725/en/latest/>
+    TSL2561 Light Sensor <https://circuitpython.readthedocs.io/projects/tsl2561/en/latest/>
+    TSL2591 High Dynamic Range Light Sensor <https://circuitpython.readthedocs.io/projects/tsl2591/en/latest/>
+    VCNL4010 Proximity and Light <https://circuitpython.readthedocs.io/projects/vcnl4010/en/latest/>
+    VEML6070 UV Index <https://circuitpython.readthedocs.io/projects/veml6070/en/latest/>
+    VEML6075 UV Index <https://circuitpython.readthedocs.io/projects/veml6075/en/latest/>
+
+Distance Sensors
+------------------
+
+These sensors measure the ``distance`` to another object and may also measure light level (``light`` and ``lux``).
+
+.. toctree::
+
+    Garmin LIDARLite I2C <https://circuitpython.readthedocs.io/projects/lidarlite/en/latest/>
+    TFmini IR Time of Flight ~30cm - 12m <https://circuitpython.readthedocs.io/projects/tfmini/en/latest/>
+    VL6180x 5 - 100 mm <https://circuitpython.readthedocs.io/projects/vl6180x/en/latest/>
+    VL53L0x ~30 - 1000 mm <https://circuitpython.readthedocs.io/projects/vl53l0x/en/latest/>
+    HC-SR04 Ultrasonic Range Sensors <https://circuitpython.readthedocs.io/projects/hcsr04/en/latest/>
+
+Radio
+--------
+
+These chips communicate to other's over radio.
+
+.. toctree::
+
+    Adafruit Bluefruit LE SPI Friend <https://circuitpython.readthedocs.io/projects/bluefruitspi/en/latest/>
+    RFM9x LoRa <https://circuitpython.readthedocs.io/projects/rfm9x/en/latest/>
+    RFM69 Packet Radio <https://circuitpython.readthedocs.io/projects/rfm69/en/latest/>
+    PN532 NFC/RFID <https://circuitpython.readthedocs.io/projects/pn532/en/latest/>
+
+IO Expansion
+--------------
+
+These provide functionality similar to `analogio`, `digitalio`, `pulseio`, and `touchio`.
+
+.. toctree::
+
+    Adafruit SeeSaw <https://circuitpython.readthedocs.io/projects/seesaw/en/latest/>
+    ADS1x15 Analog-to-Digital Converter  <https://circuitpython.readthedocs.io/projects/ads1x15/en/latest/>
+    Crickit Robotics Boards <https://circuitpython.readthedocs.io/projects/crickit/en/latest/>
+    DS2413 OneWire GPIO Expander <https://circuitpython.readthedocs.io/projects/ds2413/en/latest/>
+    FocalTech Capacitive Touch <https://circuitpython.readthedocs.io/projects/focaltouch/en/latest/>
+    MCP230xx GPIO Expander <https://circuitpython.readthedocs.io/projects/mcp230xx/en/latest/>
+    MCP4725 Digital-to-Analog Converter <https://circuitpython.readthedocs.io/projects/mcp4725/en/latest/>
+    PCA9685 16 x 12-bit PWM Driver <https://circuitpython.readthedocs.io/projects/pca9685/en/latest/>
+    TLC5947 24 x 12-bit PWM Driver <https://circuitpython.readthedocs.io/projects/tlc5947/en/latest/>
+    TLC59711 12 x 16-bit PWM Driver <https://circuitpython.readthedocs.io/projects/tlc59711/en/latest/>
+    MPR121 Capacitive Touch Sensor <https://circuitpython.readthedocs.io/projects/mpr121/en/latest/>
+    TCA9548 I2C Multiplexer <https://circuitpython.readthedocs.io/projects/tca9548a/en/latest/>
+    MCP3xxx SPI ADC <https://circuitpython.readthedocs.io/projects/mcp3xxx/en/latest/>
+
+Miscellaneous
+----------------
+
+.. toctree::
+
+    CAP1188 8-Key Capacitive Touch <https://circuitpython.readthedocs.io/projects/cap1188/en/latest/>
+    Si4713 Stereo FM Transmitter <https://circuitpython.readthedocs.io/projects/si4713/en/latest/>
+    AMG88xx Grid-Eye IR Camera <https://circuitpython.readthedocs.io/projects/amg88xx/en/latest/>
+    Trellis 4x4 Keypad <https://circuitpython.readthedocs.io/projects/trellis/en/latest/>
+    NeoTrellis 4x4 Keypad <https://circuitpython.readthedocs.io/projects/neotrellis/en/latest/>
+    NeoTrellis M4 4x8 Keypad <https://circuitpython.readthedocs.io/projects/trellism4/en/latest/>
+    DRV2605 Haptic Motor Controller <https://circuitpython.readthedocs.io/projects/drv2605/en/latest/>
+    MAX9744 Audio Amplifier  <https://circuitpython.readthedocs.io/projects/max9744/en/latest/>
+    Si5351 Clock Generator <https://circuitpython.readthedocs.io/projects/si5351/en/latest/>
+    Thermal Printer <https://circuitpython.readthedocs.io/projects/thermal_printer/en/latest/>
+    VC0706 TTL Camera <https://circuitpython.readthedocs.io/projects/vc0706/en/latest/>
+    INA219 High Side Current <https://circuitpython.readthedocs.io/projects/ina219/en/latest/>
+    Fingerprint <https://circuitpython.readthedocs.io/projects/fingerprint/en/latest/>
+    STMPE610 Resistive Touchscreen <https://circuitpython.readthedocs.io/projects/stmpe610/en/latest/>
+    Matrix Keypad <https://circuitpython.readthedocs.io/projects/matrixkeypad/en/latest/>
+    VS1053 Audio Codec <https://circuitpython.readthedocs.io/projects/vs1053/en/latest/>
+    FRAM Non-Volatile Memory <https://circuitpython.readthedocs.io/projects/fram/en/latest/>
+    74HC595 Shift Register <https://circuitpython.readthedocs.io/projects/74hc595/en/latest/>

From 1c6d1037b6bc6694eab5283666ef1b844e93ef73 Mon Sep 17 00:00:00 2001
From: sommersoft <sommersoft@gmail.com>
Date: Wed, 13 Feb 2019 19:15:12 -0600
Subject: [PATCH 4/9] add drivers to index.rst

---
 docs/index.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/index.rst b/docs/index.rst
index b82297bf..d5814b3d 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -10,8 +10,10 @@ Table of Contents
     self
 
 .. toctree::
+    :maxdepth: 4
+    :caption: Drivers
 
-    Drivers
+    drivers
 
 .. toctree::
     :caption: Other Links

From 9344bbfbdd86133cade90f0e3ce6ba0ab48a27fc Mon Sep 17 00:00:00 2001
From: sommersoft <sommersoft@gmail.com>
Date: Wed, 13 Feb 2019 19:18:31 -0600
Subject: [PATCH 5/9] add Sphinx and sphinx-rtd-theme to requirements.txt

---
 requirements.txt | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/requirements.txt b/requirements.txt
index 5bef2946..4bef26cf 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1 +1,3 @@
 circuitpython-build-tools
+Sphinx
+sphinx-rtd-theme

From 8698d1e46d8a5d7ce2c73aa3d14cf781d5c78416 Mon Sep 17 00:00:00 2001
From: sommersoft <sommersoft@gmail.com>
Date: Wed, 13 Feb 2019 19:40:01 -0600
Subject: [PATCH 6/9] add sphinx build to travis

---
 .travis.yml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 8a3ce6a5..1bac5f86 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -19,4 +19,6 @@ deploy:
   on:
     tags: true
 
-script: circuitpython-build-bundles --filename_prefix adafruit-circuitpython-bundle --library_location libraries --library_depth 2
+script:
+- circuitpython-build-bundles --filename_prefix adafruit-circuitpython-bundle --library_location libraries --library_depth 2
+- cd docs && sphinx-build -E -W -b html . _build/html && cd ..

From f6d11782126762945d99f4eabbb5716986e6f8d4 Mon Sep 17 00:00:00 2001
From: sommersoft <sommersoft@gmail.com>
Date: Wed, 13 Feb 2019 19:48:44 -0600
Subject: [PATCH 7/9] remove bus_device, register, and CP from intersphinx
 mapping

---
 docs/conf.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index 1e4b1a24..71ff1fac 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -23,11 +23,11 @@
 # autodoc_mock_imports = ["digitalio", "busio"]
 
 
-intersphinx_mapping = {'python': ('https://docs.python.org/3.4', None),
-                       'BusDevice': ('https://circuitpython.readthedocs.io/projects/busdevice/en/latest/', None),
+intersphinx_mapping = {'python': ('https://docs.python.org/3.4', None)}
+                       """'BusDevice': ('https://circuitpython.readthedocs.io/projects/busdevice/en/latest/', None),
                        'Register': ('https://circuitpython.readthedocs.io/projects/register/en/latest/', None),
                        'CircuitPython': ('https://circuitpython.readthedocs.io/en/latest/', None)
-                       }
+                       }"""
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']

From 3a7961b1d16c45deb7a6fe257e2b6875554805ea Mon Sep 17 00:00:00 2001
From: sommersoft <sommersoft@gmail.com>
Date: Wed, 13 Feb 2019 21:22:26 -0600
Subject: [PATCH 8/9] rename & reformat README.md to README.rst

---
 README.md  | 64 -----------------------------------
 README.rst | 97 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 97 insertions(+), 64 deletions(-)
 delete mode 100644 README.md
 create mode 100644 README.rst

diff --git a/README.md b/README.md
deleted file mode 100644
index 0ec3f6ec..00000000
--- a/README.md
+++ /dev/null
@@ -1,64 +0,0 @@
-# Adafruit CircuitPython Library Bundle
-
-[![Doc Status](https://readthedocs.org/projects/circuitpython/badge/?version=latest)](https://circuitpython.readthedocs.io/en/latest/docs/drivers.html)
-[![Discord](https://img.shields.io/discord/327254708534116352.svg)](https://discord.gg/nBQh6qu)
-
-This repo bundles a bunch of useful CircuitPython libraries into an easy to
-download zip file. CircuitPython boards can ship with the contents of the zip to
-make it easy to provide a lot of libraries by default.
-
-# Use
-To use the bundle download the zip (not source zip) from the
-[latest release](https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases/latest),
-unzip it and copy over the subfolders, such as `lib`, into the root of your
-CircuitPython device. Make sure to indicate that it should be merged with the
-existing folder when it exists.
-
-## CPython
-**DO NOT** use this to install libraries on a Linux computer, such as the Raspberry Pi, with regular Python (aka CPython). Instead, use the python3 version of `pip` to install the libraries you want to use. It will automatically install dependencies for you. For example:
-
-`pip3 install adafruit-circuitpython-lis3dh`
-
-# Development
-
-After you clone this repository you must run `git submodule init`
-and then `git submodule update`.
-
-## Updating libraries
-To update the libraries run `update-submodules.sh`. The script will fetch the
-latest code and update to the newest tag (not master).
-
-To find libraries with commits that haven't been included in a release do:
-
-    git submodule foreach "git log --oneline HEAD...origin/master"
-
-## Adding a library
-Determine the best location within `libraries` (`libraries/drivers/` or
-`libraries/helpers/`)for the new library and then run:
-
-    git submodule add <git url> libraries/<target directory>
-
-The target directory should omit any CircuitPython specific prefixes such as
-`adafruit-circuitpython` to simplify the listing.
-
-## Removing a library
-Only do this if you are replacing the module with an equivalent:
-
-    git submodule deinit libraries/<target directory>
-    git rm libraries/<target directory>
-
-## Building the bundle
-To build this bundle locally you'll need to install the
-`circuitpython-build-tools <https://github.com/adafruit/circuitpython-build-tools>`_ package.
-
-    python3 -m venv .env
-    source .env/bin/activate
-    pip install circuitpython-build-tools
-
-Once installed, make sure you are in the virtual environment:
-
-    source .env/bin/activate
-
-Then run the build:
-
-    circuitpython-build-bundles --filename_prefix adafruit-circuitpython-bundle --library_location libraries --library_depth 2
diff --git a/README.rst b/README.rst
new file mode 100644
index 00000000..5270d18e
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,97 @@
+Adafruit CircuitPython Library Bundle
+=======================================
+
+.. image:: https://readthedocs.org/projects/adafruit-circuitpython-bundle/badge/?version=latest
+    :target: https://circuitpython.readthedocs.io/projects/bundle/en/latest/
+    :alt: Documentation Status
+
+.. image:: https://img.shields.io/discord/327254708534116352.svg
+    :target: https://discord.gg/nBQh6qu
+    :alt: Discord
+
+.. image:: https://travis-ci.com/adafruit/Adafruit_CircuitPython_Bundle.svg?branch=master
+    :target: https://travis-ci.com/adafruit/Adafruit_CircuitPython_Bundle
+    :alt: Build Status
+
+This repo bundles a bunch of useful CircuitPython libraries into an easy to
+download zip file. CircuitPython boards can ship with the contents of the zip to
+make it easy to provide a lot of libraries by default.
+
+Use
+=====
+To use the bundle download the zip (not source zip) from the
+`latest release <https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases/latest>`_,
+unzip it and copy over the subfolders, such as ``lib``, into the root of your
+CircuitPython device. Make sure to indicate that it should be merged with the
+existing folder when it exists.
+
+CPython
+--------
+**DO NOT** use this to install libraries on a Linux computer, such as the Raspberry Pi,
+with regular Python (aka CPython). Instead, use the python3 version of ``pip`` to install
+the libraries you want to use. It will automatically install dependencies for you. For example:
+
+.. code::
+
+    pip3 install adafruit-circuitpython-lis3dh
+
+Development
+============
+
+After you clone this repository you must run ``git submodule init``
+and then ``git submodule update``.
+
+Updating libraries
+-------------------
+To update the libraries run ``update-submodules.sh``. The script will fetch the
+latest code and update to the newest tag (not master).
+
+To find libraries with commits that haven't been included in a release do:
+
+.. code::
+
+    git submodule foreach "git log --oneline HEAD...origin/master"
+
+Adding a library
+-----------------
+Determine the best location within ``libraries`` (``libraries/drivers/`` or
+``libraries/helpers/``)for the new library and then run:
+
+.. code::
+
+    git submodule add <git url> libraries/<target directory>
+
+The target directory should omit any CircuitPython specific prefixes such as
+``adafruit-circuitpython`` to simplify the listing.
+
+Removing a library
+-------------------
+Only do this if you are replacing the module with an equivalent:
+
+.. code::
+
+    git submodule deinit libraries/<target directory>
+    git rm libraries/<target directory>
+
+Building the bundle
+--------------------
+To build this bundle locally you'll need to install the
+`circuitpython-build-tools <https://github.com/adafruit/circuitpython-build-tools>`_ package.
+
+.. code::
+
+    python3 -m venv .env
+    source .env/bin/activate
+    pip install circuitpython-build-tools
+
+Once installed, make sure you are in the virtual environment:
+
+.. code::
+
+    source .env/bin/activate
+
+Then run the build:
+
+.. code::
+
+    circuitpython-build-bundles --filename_prefix adafruit-circuitpython-bundle --library_location libraries --library_depth 2

From 0538a6b15c96d0df3b7006979905daa8a3a3eb72 Mon Sep 17 00:00:00 2001
From: sommersoft <sommersoft@gmail.com>
Date: Wed, 13 Feb 2019 21:23:08 -0600
Subject: [PATCH 9/9] working version; Sphinx builds locally

---
 docs/conf.py     |  4 ----
 docs/drivers.rst | 23 ++---------------------
 docs/index.rst   |  2 +-
 3 files changed, 3 insertions(+), 26 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index 71ff1fac..c5d33677 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -24,10 +24,6 @@
 
 
 intersphinx_mapping = {'python': ('https://docs.python.org/3.4', None)}
-                       """'BusDevice': ('https://circuitpython.readthedocs.io/projects/busdevice/en/latest/', None),
-                       'Register': ('https://circuitpython.readthedocs.io/projects/register/en/latest/', None),
-                       'CircuitPython': ('https://circuitpython.readthedocs.io/en/latest/', None)
-                       }"""
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
diff --git a/docs/drivers.rst b/docs/drivers.rst
index 148db804..395a191e 100644
--- a/docs/drivers.rst
+++ b/docs/drivers.rst
@@ -1,31 +1,12 @@
 .. _adafruit-libndrivers:
 
-Additional Adafruit Libraries and Drivers on GitHub
+Adafruit Sponsored Libraries and Drivers on GitHub
 ===================================================
 
 These are libraries and drivers available in separate GitHub repos. They are
 designed for use with CircuitPython and may or may not work with
 `MicroPython <https://micropython.org>`_.
 
-.. _bundle_installation:
-
-Bundle
-------
-
-We provide a bundle of all our libraries to ease installation of drivers and
-their dependencies. The bundle is primarily geared to the Adafruit Express line
-of boards which feature a relatively large external flash. With Express boards,
-its easy to copy them all onto the filesystem. However, if you don't have
-enough space simply copy things over as they are needed.
-
-The bundles are available `on GitHub <https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases>`_.
-
-To install them:
-
-#. `Download <https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases>`_
-   and unzip the latest zip that's not a source zip.
-#. Copy the ``lib`` folder to the ``CIRCUITPY`` or ``MICROPYTHON``.
-
 Foundational
 ------------
 
@@ -209,7 +190,7 @@ These chips communicate to other's over radio.
 IO Expansion
 --------------
 
-These provide functionality similar to `analogio`, `digitalio`, `pulseio`, and `touchio`.
+These provide functionality similar to ``analogio``, ``digitalio``, ``pulseio``, and ``touchio``.
 
 .. toctree::
 
diff --git a/docs/index.rst b/docs/index.rst
index d5814b3d..ed31013b 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -11,7 +11,7 @@ Table of Contents
 
 .. toctree::
     :maxdepth: 4
-    :caption: Drivers
+    :caption: Drivers & Helpers
 
     drivers