I do agree that we need to restructure the site to make things less cluttered and easier to find. Thanks Manu/Peter for working on this. It would be great to have a few more reviewers that can help out here and add their opinions about the restructure.
Thanks Eduard On Thu, Jun 5, 2025 at 3:26 AM Manu Zhang <owenzhang1...@gmail.com> wrote: > 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 >> >> >>
