GH-35403: [Docs] Support sphinx 6 for building the docs

ci/conda_env_sphinx.txt

@@ -21,9 +21,11 @@ doxygen
 ipython
 numpydoc
 pydata-sphinx-theme==0.8
+sphinx-autobuild
 sphinx-design
-sphinx>=4.2,<6
 sphinx-copybutton
+sphinxcontrib-jquery
+sphinx==6.2
 # Requirement for doctest-cython
 pytest-cython
 pandas

docs/requirements.txt

@@ -9,5 +9,6 @@ pydata-sphinx-theme==0.8
 sphinx-autobuild
 sphinx-design
 sphinx-copybutton
-sphinx>=4.2,<6
+sphinxcontrib-jquery
+sphinx==6.2
 pandas

docs/source/conf.py

@@ -115,6 +115,7 @@
     'IPython.sphinxext.ipython_console_highlighting',
     'IPython.sphinxext.ipython_directive',
     'numpydoc',
+    "sphinxcontrib.jquery",
     'sphinx_design',
     'sphinx_copybutton',
     'sphinx.ext.autodoc',

docs/source/cpp/build_system.rst

@@ -45,6 +45,7 @@ This minimal ``CMakeLists.txt`` file compiles a ``my_example.cc`` source
 file into an executable linked with the Arrow C++ shared library:
 
 .. code-block:: cmake
+
    cmake_minimum_required(VERSION 3.16)
 
    project(MyExample)

docs/source/developers/documentation.rst

@@ -92,6 +92,21 @@ format in ``arrow/docs/_build/html``.  In particular, you can point your browser
 at ``arrow/docs/_build/html/index.html`` to read the docs and review any changes
 you made.
 
+.. note::
+
+   If you are working on the Python documentation and are building the documentation
+   with ``pyarrow`` build from source on macOS Monterey, the Python section of the
+   documentation might not be included in the ``_build/html``. In this case, try
+   installing ``pyarrow`` in non-editable mode first before running the ``make html``
+   command.
+
+   .. code-block:: shell
+
+     pushd arrow/docs
+     python -m pip install ../python --quiet
+     make html
+     popd
+
 Building with Docker
 --------------------
 

docs/source/developers/java/building.rst

@@ -199,10 +199,10 @@ CMake
 
       $ cd arrow
       $ brew bundle --file=cpp/Brewfile
-      Homebrew Bundle complete! 25 Brewfile dependencies now installed.
+      # Homebrew Bundle complete! 25 Brewfile dependencies now installed.
       $ brew uninstall aws-sdk-cpp
-      (We can't use aws-sdk-cpp installed by Homebrew because it has
-      an issue: https://github.com/aws/aws-sdk-cpp/issues/1809 )
+      #  (We can't use aws-sdk-cpp installed by Homebrew because it has
+      #  an issue: https://github.com/aws/aws-sdk-cpp/issues/1809 )
       $ export JAVA_HOME=<absolute path to your java home>
       $ mkdir -p java-dist cpp-jni
       $ cmake \

docs/source/format/CDeviceDataInterface.rst

@@ -282,7 +282,7 @@ has the following fields:
     data.
 
 .. seealso::
-    The :ref:`synchronization event types <_c-device-data-interface-event-types>`
+    The :ref:`synchronization event types <c-device-data-interface-event-types>`
     section below.
 
 .. c:member:: int64_t ArrowDeviceArray.reserved[3]
@@ -563,7 +563,7 @@ streaming source of Arrow arrays. It has the following fields:
 .. c:member:: ArrowDeviceType device_type
 
     *Mandatory.* The device type that this stream produces data on. All
-    ``ArrowDeviceArray``s that are produced by this stream should have the
+    ``ArrowDeviceArray`` s that are produced by this stream should have the
     same device type as is set here. This is a convenience for the consumer
     to not have to check every array that is retrieved and instead allows
     higher-level coding constructs for streams.
@@ -675,7 +675,7 @@ is frozen. This means that the ``ArrowDeviceArray`` structure definition
 should not change in any way -- including adding new members.
 
 Backwards-compatible changes are allowed, for example new macro values for
-:c:typedef:`ArrowDeviceType` or converting the reserved 24 bytes into a
+:c:type:`ArrowDeviceType` or converting the reserved 24 bytes into a
 different type/member without changing the size of the structure.
 
 Any incompatible changes should be part of a new specification, for example