sphinx-build clean does not clean generated docs by automodapi

[maxnoe]

Is there a way to register "output" directories in extensions so that sphinx-build clean also cleans up the auto-generated output of automodapi?

[pllim]

Yes, you modify the directives under clean: in docs/Makefile.

[maxnoe]

That's what I am doing now, the question was if this could be somehow automatized by the plugin so that the standard makefile "just works"

[pllim]

That I am not sure, maybe @eteq knows.

FWIW if we decide to go ahead with astropy/astropy-sphinx-theme#29 (use pydata-sphinx-theme), then we might not even need this anymore in the future.

[maxnoe]

How does the theme address auto generated docs?

[pllim]

I am hoping the default style would look nice enough that we don't need a custom one...? But you're right, it is not guaranteed and no one has time to tackle it right now.

[maxnoe]

Isn't autogenerating docs pages orthogonal to how the theme makes it look?

[pllim]

While we doing the theme change, I would also be interested to see how numpy and scipy generating their API doc... but I am not speaking for the project.