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