History

Angus Gratton e1b03f08af Merge branch 'bugfix/doc_macro_definitions_v4.2' into 'release/v4.2' doc: Fix macro definitions for different targets (v4.2) See merge request espressif/esp-idf!9566		2020-07-20 08:25:33 +08:00
..
_static	Merge branch 'feature/coredump_data_in_elf_format_doc_update' into 'master'	2020-05-28 02:25:47 +08:00
en	Merge branch 'feature/sphinx_idf_theme_pip_v4.2' into 'release/v4.2'	2020-07-10 12:56:43 +08:00
extensions	doc: custom list filter directive	2020-02-20 18:08:05 +08:00
idf_extensions	docs: Redirect all of Doxygen stderr to the warnings log	2020-07-10 14:53:16 +10:00
latex_templates	doc: add latex and PDF generation to build_docs	2020-04-15 17:14:22 +08:00
zh_CN	Merge branch 'doc/check_docs_multi_builder_v4.2' into 'release/v4.2'	2020-07-08 23:50:36 +08:00
build_docs.py	docs: fix check_docs not working for multiple builders	2020-07-06 12:27:02 +08:00
check_lang_folder_sync.sh	global: use '/usr/bin/env bash' instead of '/usr/bin/bash' in shebangs	2020-04-03 01:10:02 +02:00
conf_common.py	doc: Fix passing of build macros to Doxygen	2020-07-10 14:53:15 +10:00
Doxyfile	docs: Redirect all of Doxygen stderr to the warnings log	2020-07-10 14:53:16 +10:00
doxygen-known-warnings.txt	docs: Resolve doxygen & Sphinx warnings	2020-02-07 16:37:45 +11:00
get_github_rev.py	docs: add 'edit-on-github' link to html theme	2020-05-06 17:25:23 +08:00
page_redirects.txt	Add redirect link from user-guide-kaluga-1-v1.2 to user-guide-esp32-s2-kaluga-1-kit	2020-05-18 17:28:03 +08:00
README.md	docs: use new sphinx_idf_theme theme, add variables to allow theme to build version footer	2020-03-16 14:36:23 +11:00
requirements.txt	docs: update sphinx_idf_theme documentation	2020-07-06 10:55:32 +08:00
sanitize_version.py	docs: deploy docs to production server from CI	2020-03-16 14:36:23 +11:00
sphinx-known-warnings.txt	docs: fix check_docs not working for multiple builders	2020-07-06 12:27:02 +08:00
TEMPLATE_EXAMPLE_README.md	examples: Update system examples README	2019-08-28 16:19:40 +08:00

README.md

Documentation Source Folder

This folder contains source files of ESP-IDF documentation available in English and 中文.

The sources do not render well in GitHub and some information is not visible at all.

Use actual documentation generated within about 20 minutes on each commit:

Hosted Documentation

The above URLs are all for the master branch latest version. Click the drop-down in the bottom left to choose a stable version or to download a PDF.

Building Documentation

The documentation build requirements Python 3 and running the wrapper ./build_docs.py tool. Running ./build_docs.py --help will give a summary of available options.

See Documenting Code in the ESP-IDF Programming Guide for full information about setting up to build the docs, and how to use the ./build_docs.py tool.