BUG: RTD build is broken

[bsipocz]

Something has changed in the past couple of days.

Besides seeing some upstream depecation warnings (e.g. we may need to pin the sphinx version as a workaround), there are a bunch of astroquery related new warnings for no-index pages:

/home/docs/checkouts/readthedocs.org/user_builds/astroquery/envs/latest/lib/python3.11/site-packages/astroquery/jplhorizons/core.py:docstring of astroquery.jplhorizons.core.HorizonsClass:1: WARNING: duplicate object description of astroquery.jplhorizons.core.HorizonsClass, other instance in api/astroquery.jplhorizons.HorizonsClass, use :no-index: for one of them
/home/docs/checkouts/readthedocs.org/user_builds/astroquery/envs/latest/lib/python3.11/site-packages/astroquery/mpc/core.py:docstring of astroquery.mpc.core.MPCClass:1: WARNING: duplicate object description of astroquery.mpc.core.MPCClass, other instance in api/astroquery.mpc.MPCClass, use :no-index: for one of them
/home/docs/checkouts/readthedocs.org/user_builds/astroquery/envs/latest/lib/python3.11/site-packages/astroquery/imcce/core.py:docstring of astroquery.imcce.core.MiriadeClass:1: WARNING: duplicate object description of astroquery.imcce.core.MiriadeClass, other instance in api/astroquery.imcce.MiriadeClass, use :no-index: for one of them
/home/docs/checkouts/readthedocs.org/user_builds/astroquery/envs/latest/lib/python3.11/site-packages/astroquery/jplsbdb/core.py:docstring of astroquery.jplsbdb.core.SBDBClass:1: WARNING: duplicate object description of astroquery.jplsbdb.core.SBDBClass, other instance in api/astroquery.jplsbdb.SBDBClass, use :no-index: for one of them
/home/docs/checkouts/readthedocs.org/user_builds/astroquery/envs/latest/lib/python3.11/site-packages/astroquery/imcce/core.py:docstring of astroquery.imcce.core.SkybotClass:1: WARNING: duplicate object description of astroquery.imcce.core.SkybotClass, other instance in api/astroquery.imcce.SkybotClass, use :no-index: for one of them
/home/docs/checkouts/readthedocs.org/user_builds/astroquery/envs/latest/lib/python3.11/site-packages/astroquery/imcce/core.py:docstring of astroquery.imcce.core.MiriadeClass:1: WARNING: duplicate object description of astroquery.imcce.core.MiriadeClass, other instance in api/astroquery.solarsystem.MiriadeClass, use :no-index: for one of them
/home/docs/checkouts/readthedocs.org/user_builds/astroquery/envs/latest/lib/python3.11/site-packages/astroquery/imcce/core.py:docstring of astroquery.imcce.core.SkybotClass:1: WARNING: duplicate object description of astroquery.imcce.core.SkybotClass, other instance in api/astroquery.solarsystem.SkybotClass, use :no-index: for one of them
/home/docs/checkouts/readthedocs.org/user_builds/astroquery/envs/latest/lib/python3.11/site-packages/astroquery/jplhorizons/core.py:docstring of astroquery.jplhorizons.core.HorizonsClass:1: WARNING: duplicate object description of astroquery.jplhorizons.core.HorizonsClass, other instance in api/astroquery.solarsystem.HorizonsClass, use :no-index: for one of them
/home/docs/checkouts/readthedocs.org/user_builds/astroquery/envs/latest/lib/python3.11/site-packages/astroquery/jplsbdb/core.py:docstring of astroquery.jplsbdb.core.SBDBClass:1: WARNING: duplicate object description of astroquery.jplsbdb.core.SBDBClass, other instance in api/astroquery.solarsystem.SBDBClass, use :no-index: for one of them
/home/docs/checkouts/readthedocs.org/user_builds/astroquery/envs/latest/lib/python3.11/site-packages/astroquery/mpc/core.py:docstring of astroquery.mpc.core.MPCClass:1: WARNING: duplicate object description of astroquery.mpc.core.MPCClass, other instance in api/astroquery.solarsystem.MPCClass, use :no-index: for one of them

The unrelated deprecations are these:

/home/docs/checkouts/readthedocs.org/user_builds/astroquery/envs/latest/lib/python3.11/site-packages/readthedocs_ext/readthedocs.py:106: RemovedInSphinx90Warning: 'sphinx.builders.html.StandaloneHTMLBuilder.css_files' is deprecated. Check CHANGES for Sphinx API modifications.
  if inject_css and theme_css not in app.builder.css_files:
/home/docs/checkouts/readthedocs.org/user_builds/astroquery/envs/latest/lib/python3.11/site-packages/readthedocs_ext/readthedocs.py:106: RemovedInSphinx90Warning: The str interface for _CascadingStyleSheet objects is deprecated. Use css.filename instead.
  if inject_css and theme_css not in app.builder.css_files:
/home/docs/checkouts/readthedocs.org/user_builds/astroquery/envs/latest/lib/python3.11/site-packages/readthedocs_ext/readthedocs.py:120: RemovedInSphinx90Warning: 'sphinx.builders.html.StandaloneHTMLBuilder.script_files' is deprecated. Check CHANGES for Sphinx API modifications.
  hasattr(app.builder, 'script_files'),
/home/docs/checkouts/readthedocs.org/user_builds/astroquery/envs/latest/lib/python3.11/site-packages/readthedocs_ext/readthedocs.py:121: RemovedInSphinx90Warning: 'sphinx.builders.html.StandaloneHTMLBuilder.script_files' is deprecated. Check CHANGES for Sphinx API modifications.
  js_file not in app.builder.script_files,
/home/docs/checkouts/readthedocs.org/user_builds/astroquery/envs/latest/lib/python3.11/site-packages/readthedocs_ext/readthedocs.py:121: RemovedInSphinx90Warning: The str interface for _JavaScript objects is deprecated. Use js.filename instead.
  js_file not in app.builder.script_files,

[bsipocz]

cc @pllim in case she run into some of these elsewhere already before I spend any time diving into the rabbit hole. (I suspect this is all due to serving the same classes from two namespaces, and I'm certain there are cases for this in astropy, too)

[pllim]

Yeah, looks similar to astropy/astropy#11723 . Marten fixed that in astropy/astropy#14140

Not sure about the deprecation warnings. I don't think I seen those, but astropy now uses pydata-sphinx-theme so 🤷‍♀️

[bsipocz]

Ahh, this got broken due to sphinx-automodapi 0.18.0 and astropy/sphinx-automodapi#190

[bsipocz]

I'll just pin sphinx-automodapi for now for a quick fix, and will have to rethink the namespaces and module aliasing in and out of e.g. solarsystem.