search

apache / arrow-site

Mirror of Apache Arrow site
Apache License 2.0
31 stars 106 forks source link

[Website] Publish update to PyArrow install docs for conda-forge package split #520

Open amoeba opened 1 month ago

amoeba commented 1 month ago

https://github.com/apache/arrow/pull/41135 updated the PyArrow install docs to mention the recent split of PyArrow into three separate packages. It will be included in the v17 release but I think we should publish an update to the website before then.

amoeba commented 1 month ago

I was going to just send a PR with an updated https://github.com/apache/arrow-site/blob/asf-site/docs/python/install.html but my diff was really noisy and looked like it'd break the built site. @raulcd do we have documented steps for how you build the docs when you create PRs like https://github.com/apache/arrow-site/pull/515? I'm following https://arrow.apache.org/docs/developers/documentation.html#building-docs like I normally do.

jorisvandenbossche commented 1 month ago

We build the dev docs in CI and upload them, so another approach I would have tried is to just take the latest dev build, take the specific install.html page, and then replace the existing one with that, just reverting a few small things like the version number.

I would expect this to work OK at this point, because the setup to build the dev docs and the 16.1.0 docs should not differ much (like, it's not that we updated sphinx in the meantime, which would otherwise create a much bigger diff)