circuitpython/docs
Scott Shawcroft 4c9fcd6d21 Support markdown. 2016-10-19 10:53:37 -07:00
..
esp8266 Documentation rework to unify the docs together rather than having them 2016-10-18 17:42:47 -07:00
library docs/uos: Add uos.statvfs() documentation. 2016-10-07 13:16:54 +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/isr_rules.rst: Two minor additions to docs for using ISR. 2016-09-07 17:12:42 +10: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 Documentation rework to unify the docs together rather than having them 2016-10-18 17:42:47 -07: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.