mirror of https://github.com/espressif/esp-idf.git synced 2024-10-05 20:47:46 -04:00

History

Marius Vikhammer 548fd02d10 docs: initial update of programming guide for C3 Updates "front page" content, get-started, and api-guides with C3 content Enable building and publishing of C3 docs in CI		2021-02-01 15:40:02 +08:00
..
en	style: format python files with isort and double-quote-string-fixer	2021-01-26 10:49:01 +08:00
page_redirects.txt	docs: Adds CI tests for the doc building process.	2020-07-28 17:48:19 +08:00
README.md	docs: Adds CI tests for the doc building process.	2020-07-28 17:48:19 +08:00
test_docs.py	style: format python files with isort and double-quote-string-fixer	2021-01-26 10:49:01 +08:00
test_sphinx_idf_extensions.py	docs: initial update of programming guide for C3	2021-02-01 15:40:02 +08:00

README.md

Documentation Test Folder

This folder contains the files needed for running tests the ESP-IDF documentation building system.

Tests are divided into two categories: unit tests and integration tests:

Unit Tests

The Sphinx IDF extensions are unit-tested in test_sphinx_idf_extensions.py

Integration Tests

Due to the thigh integration with Sphinx some functionality is difficult to test with simple unit tests.

To check that the output from the Sphinx build process is as expected test_docs.py builds a test subset of the documentation, found in the en folder. The HTML output is then checked to see that it contains the expected content.

Running Tests

Both test_sphinx_idf_extensions.py and test_docs.py are run as part of the host_test stage of the CI pipeline.

It's also possible to run the tests locally by running the following commands from the test folder:

./test_sphinx_idf_extensions.py
./test_docs.py

Note that test_docs.py tries to build a test subset of the documentation, and thus requires your environment to be set up for building documents. See Documenting Code for instructions on how to set up the build_docs environment.