Zephyr-os thinking about moving away from Breathe

[michaeljones]

Someone has kindly shared this with me. Sad to see a project moving away from Breathe but interesting to see why:

zephyrproject-rtos/zephyr#39702

[michaeljones]

I've spoken to the author of the PR and they've said:

the proposal was made for a few reasons, really:

• Doxygen renders everything out of the box (no need to keep track of manually adding groups in the Sphinx side)
• Sphinx in general is pretty slow when it comes to render a lot of content, (we see this issue with Kconfig pages)
• As you mentioned incremental builds are also an issue, as of today breathe doesn't support them well

[michaeljones]

Thank you for sharing your thoughts @gmarull

[gmarull]

Note: a decision has not been made, it is just a proposal to analyze options.