circuitpython/docs
Tony DiCola 00a44fa36c Merge remote-tracking branch 'micropython/master'
Conflicts:
	README.md - Kept Adafruit README.md intact.
	py/emitglue.c - Added xtensa architecture as an OR of the define.
	zephyr/README.md - Fixed spelling mistake.
2016-10-20 23:01:13 +00:00
..
esp8266 Documentation rework to unify the docs together rather than having them 2016-10-18 17:42:47 -07:00
library docs/machine.SPI: Improve descriptions of xfer methods. 2016-10-18 10:14:26 +11:00
pyboard Documentation rework to unify the docs together rather than having them 2016-10-18 17:42:47 -07:00
readthedocs/settings docs: Add RTD local_settings file, to add custom templates. 2014-12-21 11:21:06 +00:00
reference docs/reference: Add constrained.rst doc. 2016-10-11 15:27:20 +11:00
sphinx_selective_exclude docs: Add sphinx_selective_exclude extension suite. 2016-06-12 01:13:39 +03:00
static docs: Change "Micro Python" to "MicroPython" in all places in docs. 2015-06-04 23:53:26 +01:00
templates docs: Add link to PDF version of docs in sidebar. 2016-06-06 11:37:40 +01:00
wipy Documentation rework to unify the docs together rather than having them 2016-10-18 17:42:47 -07:00
README.md Documentation rework to unify the docs together rather than having them 2016-10-18 17:42:47 -07:00
c2rst.py Documentation rework to unify the docs together rather than having them 2016-10-18 17:42:47 -07:00
drivers.rst Update drivers.rst 2016-10-20 18:58:46 +02:00
supported_ports.rst Support markdown. 2016-10-19 10:53:37 -07:00
unsupported_ports.rst Documentation rework to unify the docs together rather than having them 2016-10-18 17:42:47 -07:00

README.md

Adafruit's MicroPython Documentation

The latest documentation can be found at: http://adafruit-micropython.readthedocs.io/en/latest/

The documentation you see there is generated from the files in the whole tree: https://github.com/adafruit/micropython/tree/master

Building the documentation locally

If you're making changes to the documentation, you should build the documentation locally so that you can preview your changes.

Install Sphinx, and optionally (for the RTD-styling), sphinx_rtd_theme, preferably in a virtualenv:

 pip install sphinx
 pip install sphinx_rtd_theme

In micropython/, build the docs:

sphinx-build -v -b html . _build/html

You'll find the index page at micropython/docs/_build/html/index.html.