Pandas version checks

  • [X] I have checked that this issue has not already been reported.

  • [X] I have confirmed this bug exists on the latest version of pandas.

  • [X] I have confirmed this bug exists on the main branch of pandas.

Reproducible Example

python make.py html

Issue Description

While trying to build documentation for pandas-dev, the build fails with Sphinx parallel build error Screenshot 2024-10-14 at 19 06 45

Stackoverflow Issue Reference

Expected Behavior

The build should be successful and the docs should be built in local

Installed Versions

INSTALLED VERSIONS ------------------ commit : 2a10e04a099d5f1633abcdfbb2dd9fdf09142f8d python : 3.10.15 python-bits : 64 OS : Darwin OS-release : 23.6.0 Version : Darwin Kernel Version 23.6.0: Fri Jul 5 17:56:39 PDT 2024; root:xnu-10063.141.1~2/RELEASE_ARM64_T8122 machine : arm64 processor : arm byteorder : little LC_ALL : None LANG : en_US.UTF-8 LOCALE : en_US.UTF-8 pandas : 0+untagged.35606.g2a10e04 numpy : 1.26.4 dateutil : 2.9.0 pip : 24.2 Cython : 3.0.11 sphinx : 8.1.1 IPython : 8.28.0 adbc-driver-postgresql: None adbc-driver-sqlite : None bs4 : 4.12.3 blosc : None bottleneck : 1.4.0 fastparquet : 2024.5.0 fsspec : 2024.9.0 html5lib : 1.1 hypothesis : 6.114.1 gcsfs : 2024.9.0post1 jinja2 : 3.1.4 lxml.etree : 5.3.0 matplotlib : 3.9.2 numba : 0.60.0 numexpr : 2.10.1 odfpy : None openpyxl : 3.1.5 psycopg2 : 2.9.9 pymysql : 1.4.6 pyarrow : 17.0.0 pyreadstat : 1.2.7 pytest : 8.3.3 python-calamine : None pytz : 2024.2 pyxlsb : 1.0.10 s3fs : 2024.9.0 scipy : 1.14.1 sqlalchemy : 2.0.35 tables : 3.10.1 tabulate : 0.9.0 xarray : 2024.9.0 xlrd : 2.0.1 xlsxwriter : 3.2.0 zstandard : 0.23.0 tzdata : 2024.2 qtpy : None pyqt5 : None

Comment From: vamsi-verma-s

@Swati-Sneha - Pls try deleting build directory and build again.

Comment From: Swati-Sneha

@vamsi-verma-s I have done that already.

I also asked this in the slack channel, seems I am not the only one facing it.

Comment From: rhshadrach

I can build the docs locally and the CI has been successful. But neither of these are on arm64.

The line count is off because there are some lines injected into the rst files in order to do e.g. import pandas as pd. My guess is the issue is from this code block:

https://github.com/pandas-dev/pandas/blob/68d9dcab5b543adb3bfe5b83563c61a9b8afae77/doc/source/whatsnew/v1.5.0.rst?plain=1#L39-L52

What happens when you run that?

Comment From: Swati-Sneha

What do you mean @rhshadrach ? When I run what? The command: python make.py html or are you refering to something else?

Comment From: rhshadrach

The code in the code-block in my comment.

Comment From: Swati-Sneha

This is what I get when I run it from my terminal, seems okay to me. Screenshot 2024-11-04 at 23 33 37

Comment From: rhshadrach

Can you try python make.py html --num-jobs=1. Hopefully that should give you a stack trace.

Comment From: loicdiridollou

FYI I was bumping into the same issue (on Mac arm m1). The parallel build bumps on different point, always in the whatsnew files but since it is parallel it is not always the same one. However running in linear as recommended by @rhshadrach enables the process to complete without issues.

Comment From: mroeschke

Closing as isn't not exactly clear what the documentation issue was