combine docs

Author: lidavidm

.github/workflows/rc.yml

@@ -400,8 +400,8 @@ jobs:
       - name: Prepare docs
         run: |
           mkdir -p docs
-          cp -a target/site/apidocs docs/reference
-          tar -cvzf docs.tar.gz docs
+          cp -a target/site/apidocs reference
+          tar -cvzf reference.tar.gz reference
       - name: Upload binaries
         uses: actions/upload-artifact@65c4c4a1ddee5b72f698fdd19549f0f0fb45cf08 # v4.6.0
         with:
@@ -410,12 +410,12 @@ jobs:
       - name: Upload docs
         uses: actions/upload-artifact@65c4c4a1ddee5b72f698fdd19549f0f0fb45cf08 # v4.6.0
         with:
-          name: release-docs
-          path: docs.tar.gz
+          name: reference
+          path: reference
   docs:
     name: Docs
     needs:
-      - source
+      - binaries
     runs-on: ubuntu-latest
     permissions:
       contents: read
@@ -427,7 +427,9 @@ jobs:
       - name: Download source archive
         uses: actions/download-artifact@fa0a91b85d4f404e444e00e005971372dc801d16 # v4.1.8
         with:
-          name: release-source
+          name: |
+            reference
+            release-source
       - name: Extract source archive
         run: |
           tar -xf apache-arrow-java-*.tar.gz --strip-components=1
@@ -438,13 +440,14 @@ jobs:
           source venv/bin/activate
           pip install -r requirements.txt
           make html
+          tar -xf ../reference.tar.gz -C docs/build/html
       - name: Compress into single artifact to keep directory structure
         run: tar -cvzf docs.tar.gz -C docs/build html
       - name: Upload artifacts
         uses: actions/upload-artifact@65c4c4a1ddee5b72f698fdd19549f0f0fb45cf08 # v4.6.0
         with:
-          name: release-sphinx-docs
-          path: docs.tar.gz
+          name: release-html
+          path: html.tar.gz
   verify:
     name: Verify
     needs: