Error when building the pandas documentation

[thiagogquinto]

System:

Windows 11 22H2 (using WSL-Ubuntu)

Error

I changed a docstring and in the docs there is the information of building the pandas documentation, but when I run python make.py html there is the following error:

reading sources... [ 25%] reference/api/pandas.Period.start_time .. reference/api/pandas.Series.any
Sphinx parallel build error:
RuntimeError: Non Expected exception in `<path>/doc/source/whatsnew/v0.24.0.rst` line 316

Obs: I only edited pandas/core/shared_docs.py.

[JohannaTrost]

Hi @thiagogquinto, I am encountering the same error. Could you please share how you solved this?

When running python make.py --single whatsnew/v0.24.0.rst I get the following output:

+ anaconda3/envs/pandas-dev/bin/ninja
[1/1] Generating write_version_file with a custom command
Running Sphinx v6.2.1
+ anaconda3/envs/pandas-dev/bin/ninja
[1/1] Generating write_version_file with a custom command
loading pickled environment... done
[autosummary] generating autosummary for: index.rst
building [mo]: targets for 0 po files that are out of date
writing output... 
building [html]: targets for 1 source files that are out of date
updating environment: [config changed ('exclude_patterns')] 2 added, 0 changed, 1 removed
WARNING: ources... [100%] whatsnew/v0.24.0                                                                                                                                     
>>>-------------------------------------------------------------------------
Exception in <path>/doc/source/whatsnew/v0.24.0.rst at block ending on line 316
Specify :okexcept: as an option in the ipython:: block to suppress this message
---------------------------------------------------------------------------
NameError                                 Traceback (most recent call last)
Cell In[44], line 1
----> 1 result = pd.read_html(StringIO("""
      2   <table>
      3     <thead>
      4       <tr>
      5         <th>A</th><th>B</th><th>C</th>
      6       </tr>
      7     </thead>
      8     <tbody>
      9       <tr>
     10         <td colspan="2">1</td><td>2</td>
     11       </tr>
     12     </tbody>
     13   </table>"""))

NameError: name 'StringIO' is not defined

<<<-------------------------------------------------------------------------

Exception occurred:
  File "anaconda3/envs/pandas-dev/lib/python3.10/site-packages/IPython/sphinxext/ipython_directive.py", line 584, in process_input
    raise RuntimeError('Non Expected exception in `{}` line {}'.format(filename, lineno))
RuntimeError: Non Expected exception in `<path>/doc/source/whatsnew/v0.24.0.rst` line 316
The full traceback has been saved in /var/folders/f8/v13bbmv53_z7q9w1_d8cgy780000gn/T/sphinx-err-bhobom0i.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!