khjoshi94 opened a new pull request, #15694:
URL: https://github.com/apache/iceberg/pull/15694

   ### Summary
   
   This PR adds a dedicated documentation page describing the `Arrow ↔ Iceberg` 
type mapping for the `Java` implementation. While the mapping logic exists in 
`ArrowSchemaUtil`, it has not previously been documented in the user-facing 
documentation.
   
   The new page lives under `docs/docs/` and is grouped under a new `"Apache 
Arrow"` section within the `Integrations` category in `mkdocs.yml`. This 
creates a future‑proof home for Arrow-related documentation. A cross-link has 
also been added to `api.md` so users working with `Arrow` utilities can easily 
discover the mapping reference.
   
   ### Included
   
   - New page: docs/docs/arrow-type-mapping.md
   - New "Apache Arrow" subsection under Integrations in mkdocs.yml
   - Cross-link added to docs/docs/api.md
   - Iceberg → Arrow mapping table
   - Notes on decimals, timestamps, lists, maps, and UUIDs
   - Format-version notes for v3 types
   - Clarification that Java does not currently implement Arrow → Iceberg 
conversion
   - Implementation references
   
   ### Motivation
   
   Iceberg exposes Arrow schemas during vectorized reads, and users integrating 
with Arrow-based systems need a clear reference for how Iceberg types map to 
Arrow types. Creating a dedicated Apache Arrow section also provides a natural 
home for future Arrow-related documentation.
   
   ### Related Issues
   
   Fixes #15666
   
   ### Testing
   
   Locally deployed and verified.
   <img width="1834" height="996" alt="Screen Shot 2026-03-20 at 1 40 47 AM" 
src="https://github.com/user-attachments/assets/a43fb938-ea3f-4d1f-a0ab-f9ac5f14243f";
 />
   <img width="1801" height="1002" alt="Screen Shot 2026-03-20 at 1 41 20 AM" 
src="https://github.com/user-attachments/assets/b46e9c5b-986b-42fb-998c-8e2a9bbda769";
 />
   
   


-- 
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]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to