Structure contents to be user facing

This commit is contained in:
Carol Willing 2017-09-02 08:30:29 -05:00 committed by Scott Shawcroft
parent 6d9d683443
commit 676a5b399e

View File

@ -1,5 +1,5 @@
Adafruit CircuitPython API Reference Adafruit CircuitPython API Reference
======================================== ====================================
.. image:: https://travis-ci.org/adafruit/circuitpython.svg?branch=master .. image:: https://travis-ci.org/adafruit/circuitpython.svg?branch=master
:target: https://travis-ci.org/adafruit/circuitpython :target: https://travis-ci.org/adafruit/circuitpython
@ -17,37 +17,64 @@ Adafruit CircuitPython API Reference
:target: https://adafru.it/discord :target: https://adafru.it/discord
:alt: Discord :alt: Discord
Welcome! This is the documentation for Adafruit CircuitPython. It is an open Welcome to the API reference documentation for Adafruit CircuitPython.
source derivative of `MicroPython <https://micropython.org>`_ for use on This contains low-level API docs, and these docs may link out to separate
educational development boards designed and sold by `Adafruit *"getting started"* guides. `Adafruit <https://adafruit.com>`_ has many
<https://adafruit.com>`_. Adafruit CircuitPython features unified Python core excellent tutorials available through the
APIs and a growing list of drivers that work with it. `Adafruit Learning System <https://learn.adafruit.com/>`_.
What is CircuitPython?
----------------------
**CircuitPython** is an open source derivative of
`MicroPython <https://micropython.org>`_ for use on educational development
boards designed and sold by `Adafruit <https://adafruit.com>`_. Adafruit
CircuitPython features unified Python core APIs and a growing list of drivers
of that work with CircuitPython.
What boards use CircuitPython?
------------------------------
The Adafruit Express line of boards are specifically The Adafruit Express line of boards are specifically
designed for use with CircuitPython. They are the designed for use with CircuitPython. This line includes:
`CircuitPlayground Express <https://www.adafruit.com/product/3333>`_,
`Feather M0 Express <https://www.adafruit.com/product/3403>`_,
and `Metro M0 Express <https://www.adafruit.com/product/3505>`_.
Other supported boards include the `Arduino Zero
<https://www.arduino.cc/en/Main/ArduinoBoardZero>`_, `Adafruit Feather M0 Basic
<https://www.adafruit.com/product/2772>`_, `Adafruit Feather HUZZAH
<https://www.adafruit.com/products/2821>`_ and `Adafruit Feather M0 Bluefruit LE
<https://www.adafruit.com/products/2995>`_.
`Adafruit <https://adafruit.com>`_ has many excellent tutorials available * `CircuitPlayground Express <https://www.adafruit.com/product/3333>`_
through the `Adafruit Learning System <https://learn.adafruit.com/>`_. These * `Feather M0 Express <https://www.adafruit.com/product/3403>`_
docs are low-level API docs and may link out to separate getting started guides. * `Metro M0 Express <https://www.adafruit.com/product/3505>`_
Other supported boards include:
* `Arduino Zero <https://www.arduino.cc/en/Main/ArduinoBoardZero>`_
* `Adafruit Feather M0 Basic <https://www.adafruit.com/product/2772>`_
* `Adafruit Feather HUZZAH <https://www.adafruit.com/products/2821>`_
* `Adafruit Feather M0 Bluefruit LE <https://www.adafruit.com/products/2995>`_
.. _contents:
Full Table of Contents
----------------------
.. toctree:: .. toctree::
:maxdepth: 3 :maxdepth: 3
:caption: API and Usage
shared-bindings/index.rst shared-bindings/index.rst
docs/supported_ports.rst docs/supported_ports.rst
docs/troubleshooting.rst docs/troubleshooting.rst
docs/drivers.rst docs/drivers.rst
.. toctree::
:maxdepth: 3
:caption: Developer reference
docs/design_guide docs/design_guide
docs/common_hal docs/common_hal
docs/library/index.rst docs/library/index.rst
.. toctree::
:maxdepth: 3
:caption: About the project
README README
CONTRIBUTING CONTRIBUTING
CODE_OF_CONDUCT CODE_OF_CONDUCT