Hi all, I know you've been busy finalizing v3 spec and discussing new features in v4 spec. When you find time, could you take a look at this as well? I think well-organized docs are also important to further grow the project and the community.
Thanks, Manu On Mon, May 26, 2025 at 11:01 AM Manu Zhang <owenzhang1...@gmail.com> wrote: > Hi all, > > I’ve noticed that the current Docs side navigation > <https://iceberg.apache.org/docs/nightly/> on the Iceberg website is > still primarily structured around Iceberg Java. However, the project has > evolved significantly, with many new language implementations and > integrations. I’d like to highlight a few issues and suggestions for > improvement > > 1. "latest" doc is physically a symlink to the latest version (e.g. > 1.9.0), and it would be clearer to present this as something like > “$iceberg_version (latest)” in the navigation. > 2. Links to PyIceberg, IcebergRust, and IcebergGo are currently nested > under Iceberg Java, making them hard to find. Elevating these to the top > level would make them more accessible. > 3. Contents of (or links to) external integrations are not specific to a > version of Iceberg Java and better moved out. > 4. There is an "Integrations" submenu but it's not clear why AWS, Dell, > JDBC and Nessie are in the submenu while others are not. > 5. The list of integrations is also growing so it would be better to find > a new home for them. > > I've opened issues for 1 <https://github.com/apache/iceberg/issues/12917> > and 2 <https://github.com/apache/iceberg/issues/12910>, and Peter Nguyen > has kindly opened PRs to fix them. > However, I believe a more comprehensive restructure of the Docs side > navigation would better serve the community and reflect the project’s > evolution. > > I'd love to hear your thoughts. > > Thanks, > Manu > > >
