Thanks Robin for the PR and Steven for review. I've submitted a follow-up PR to move links to other language implementations out of Java docs. https://github.com/apache/iceberg/pull/13618. Please help review.
Thanks, Manu On Tue, Jul 22, 2025 at 5:58 AM Kevin Liu <kevinjq...@apache.org> wrote: > Thanks for working on the navigation! I've run it locally and it looks > great. > Like Steven mentioned, we can continue to iterate on the improvements. > Happy to help review more changes, I was a bit late on this one :) > > Best, > Kevin Liu > > On Mon, Jul 21, 2025 at 1:27 PM Steven Wu <stevenz...@gmail.com> wrote: > >> FYI, I have merged Robin's PR for the docs side navigation change, which >> greatly simplified the navigation side panel. If there are more comments or >> requests, they can be followed up separately. >> >> On Thu, Jul 17, 2025 at 2:37 AM Robin Moffatt <ro...@confluent.io.invalid> >> wrote: >> >>> Hi all, >>> >>> There has been a good discussion and some improvements on the PR to >>> improve the left-hand navigation on the docs: >>> https://github.com/apache/iceberg/pull/13491/ >>> I have updated the preview images at the top of the PR to show the >>> current state of the proposal. >>> >>> Further review and comments would be most welcome, please. >>> >>> thanks, Robin >>> >>> On Wed, 9 Jul 2025 at 17:08, Steven Wu <stevenz...@gmail.com> wrote: >>> >>>> I really like the new organization of the navigation panel. It is too >>>> congested currently. >>>> >>>> On Wed, Jul 9, 2025 at 7:22 AM Jean-Baptiste Onofré <j...@nanthrax.net> >>>> wrote: >>>> >>>>> Hi Manu >>>>> >>>>> At first glance, it's a great improvement with a good multi-level menu >>>>> (reducing the first level size of the menu). >>>>> >>>>> Thanks ! >>>>> Regards >>>>> JB >>>>> >>>>> On Tue, Jul 8, 2025 at 11:22 PM Manu Zhang <owenzhang1...@gmail.com> >>>>> wrote: >>>>> > >>>>> > Hi all, >>>>> > >>>>> > Robin has opened https://github.com/apache/iceberg/pull/13491 to >>>>> refactor left-hand navigation. Please help review and share your thoughts >>>>> there. >>>>> > >>>>> > Thanks, >>>>> > Manu >>>>> > >>>>> > On Sat, Jun 7, 2025 at 7:08 AM Kevin Liu <kevinjq...@apache.org> >>>>> wrote: >>>>> >> >>>>> >> Thanks for starting this conversation, Manu! I agree 100%. Having >>>>> well-organized docs is super important for the growth of the community. >>>>> Happy to help out here. >>>>> >> >>>>> >> I see there are a couple of issues already created with the "docs" >>>>> label on github, >>>>> https://github.com/apache/iceberg/issues?q=state%3Aopen%20label%3A%22docs%22 >>>>> >> I'll comment on those tickets individually. >>>>> >> >>>>> >> Regarding the points you brought up in the original email, >>>>> >> 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. >>>>> >> +1 to this change. Looking at the "docs" sub menu, there's also >>>>> "nightly" and it's the default when I navigate to "docs". I would just >>>>> caution to be careful here esp if there's a URL change since Google caches >>>>> some links. >>>>> >> >>>>> >> 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. >>>>> >> +1, I'd like to include links referencing the sub-projects. >>>>> >> - Iceberg-python and Iceberg-rust both have their own website. >>>>> https://py.iceberg.apache.org/ & https://rust.iceberg.apache.org/ >>>>> >> - Iceberg-go currently uses >>>>> https://pkg.go.dev/github.com/apache/iceberg-go >>>>> >> >>>>> >> 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. >>>>> >> +1 to all the above. >>>>> >> >>>>> >> This also reminds me of the previous discussion thread on >>>>> documentation, >>>>> https://lists.apache.org/thread/jnfnf886r4y8q3og668f02pbw8ym7pq6 >>>>> >> I'd like to reorganize the tabs on the main site and perhaps add a >>>>> new "Community" tab. I just created >>>>> https://github.com/apache/iceberg/issues/13261 so I won't forget >>>>> again :) >>>>> >> >>>>> >> Looking forward to these changes! >>>>> >> >>>>> >> Best, >>>>> >> Kevin Liu >>>>> >> >>>>> >> >>>>> >> >>>>> >> On Thu, Jun 5, 2025 at 12:19 AM Eduard Tudenhöfner < >>>>> etudenhoef...@apache.org> wrote: >>>>> >>> >>>>> >>> 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 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 and 2, 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 >>>>> >>>>> >>>>> >>>>> >>>>> >>>> >>> >>> -- >>> *Robin Moffatt* >>> *Sr. Principal Advisor, Streaming Data Technologies* >>> >>
