Migrate RTD/MkDocs build to Python 3
marcelstoer opened this issue · comments
I wanted to enable the RTD docs build for @jmattsson's dev-esp32-idf4
branch so we can announce that branch in the docs early. The build failed with "Could not find a version that satisfies the requirement ziglang>=0.8.0". Checking the RTD logs made me realize we're still using Python 2 to build the docs.
Upgrading to Python 3 (in the RTD settings) worked but the build failed again but for a different reason. Maybe it's because the MkDocs version we (or RTD?) use is ancient as well.
Maybe have a look at readthedocs/readthedocs.org#5474? It looks like the same issue we're hitting, and there seems to be solution(s) there :)
WIP https://nodemcu.readthedocs.io/en/update-rtd-mkdocs/
A couple of changes were required.