jorisvandenbossche commented on pull request #11726: URL: https://github.com/apache/arrow/pull/11726#issuecomment-990030486
Can you add `numpydoc` to `conda_env_sphinx.txt`? Looking at the doc build on CI, there are some warnings: ``` /arrow/docs/source/python/api/filesystems.rst.rst:38: WARNING: autosummary: stub file not found 'HadoopFileSystem'. Check your autosummary_generate setting. /arrow/docs/source/docstring of pyarrow.Array.rst:33: WARNING: autosummary: stub file not found 'pyarrow.Array.buffers'. Check your autosummary_generate setting. /arrow/docs/source/docstring of pyarrow.Array.rst:33: WARNING: autosummary: stub file not found 'pyarrow.Array.cast'. Check your autosummary_generate setting. /arrow/docs/source/docstring of pyarrow.Array.rst:33: WARNING: autosummary: stub file not found 'pyarrow.Array.dictionary_encode'. Check your autosummary_generate setting. ... ``` (I can also try to take a look at this next week) Another set look like: ``` /opt/conda/envs/arrow/lib/python3.9/site-packages/pyarrow/parquet.py:docstring of pyarrow.parquet.write_table:120: WARNING: undefined label: python:bltin-boolean-values (if the link has no caption the label must precede a section header) ``` we might need to add "bool" (and some other words) to the list of things that should not be linked (see `numpydoc_xref_ignore` option at https://numpydoc.readthedocs.io/en/latest/install.html#configuration) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
