jorisvandenbossche commented on code in PR #36296:
URL: https://github.com/apache/arrow/pull/36296#discussion_r1253038478
##########
docs/source/developers/documentation.rst:
##########
@@ -87,6 +87,14 @@ These two steps are mandatory and must be executed in order.
not sufficiently comprehensive. Portions of the Python API documentation
will also not build without CUDA support having been built.
+.. note::
+
+ If you are working on the Python documentation and are building the
documentation
+ with ``pyarrow`` build from source on macOS Monterey, Python section of the
+ documentation might not be included in the ``_build/html``. In this case run
+ ``python -m pip install ../python --quiet --no-dependencies python`` before
+ running the ``make html`` command.
Review Comment:
This is essentially installing the package in non-editable mode, right?
Maybe mention that explicitly to clarify what the command is exactly doing
Also, what does the `--no-dependencies python` do?
--
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]
