Docs build with AutoAPI fails in CI/CD with OOM (Error 137)

[Revathyvenugopal162]

Hello ,

I’m using Sphinx + AutoAPI for a fairly large project as you see here ansys/pydyna#621. The documentation builds fine locally, but in CI/CD (GitHub Actions) the build often fails with:

Error 137 Killed
make: *** [Makefile:27: html] Error 137
Error: The operation was canceled.

From what I understand, this happens because a large number of .rst files are generated and Sphinx runs out of memory when processing them. I already tried limiting parallel jobs (-j 2) and enabling caching, but the issue still occurs.

Could you kindly advise if there is a recommended way to handle large projects with AutoAPI in CI/CD? Any guidance on caching, configuration, or ways to only regenerate documentation for changed modules (instead of rewriting all .rst files every build) would be very helpful.

Thank you very much for your time!