Documenting an esp32 project with Doxygen/Breathe/Sphinx

[peterdroberts]

I've done some basic searching for this and couldn't find an existing answer.

I've joined a team with existing esp32 code and would like to implement automated documentation for it. Doxygen-style comments are in the code already, but there is not a doxygen output set up.

The project uses the esp-idf style cmake commands with idf_component_register etc.

Currently I can only find documentation on how to document the esp-idf repository itself.

It seems like I could adapt the esp-idf documentation tools for the project I'm working on, but I can't find any documentation on this or examples of anyone who's done it. Am I missing something obvious here and can someone give me links to examples of an implementation?

[ESP-Marius]

We are actually working on decoupling the documentation build system we have from IDF in order to make it easier for other Espressif projects to use it. Seems like this something that could benefit you as well!

For your use-case it seems like you might not need any of functionality we added on-top of the standard doxygen/breathe/sphinx/readthedocs setup though.

Some help getting started can be found here:

• https://docs.readthedocs.io/en/stable/i ... hinx.html

• https://breathe.readthedocs.io/en/late ... start.html

[peterdroberts]

Thank you!