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

Reply via email to