Thanks for starting this discussion Manu!

Big +1 to re-organizing the tabs on the main site. I agree with Russell and
think we should make an even bigger change. Happy to continue the
conversation here or we can start a new thread.

For one, I think we can move "Blogs", "Talks", and perhaps even "Vendors"
into a new "Community" tab. The contents in "Blogs" also feel very
vendor-centric to me. Perhaps we should re-evaluate the contents and make
sure it aligns with the Community Guidelines
<https://iceberg.apache.org/community/#community-guidelines>.

In general, the main site is where folks new and old to the project gather.
I'm happy to help drive the effort to make it easier to navigate.

Best,
Kevin Liu

On Mon, Feb 17, 2025 at 1:01 AM Fokko Driesprong <fo...@apache.org> wrote:

> I've left some comments on the PR, thanks for cleaning this up Manu.
>
> Manish, regarding your question. First, I think this is a separate
> discussion, but a valid one. This was also suggested in the past
> <https://github.com/apache/iceberg/pull/9666>, but got closed because I
> was changing diapers. I think it would be good to raise a new PR to add
> this section. Regarding V3, I think this is a constant balance between the
> scope and the timeline, and I think it would be good to track the
> milestones for that reason <https://github.com/apache/iceberg/milestones>
> .
>
> Kind regards,
> Fokko
>
> Op zo 16 feb 2025 om 17:27 schreef Manish Malhotra <
> manish.malhotra.w...@gmail.com>:
>
>> Sorry Manu, I saw the message late.
>> From some time, I was also thinking that docs needs to be realigned to
>> make navigation easier.
>> Thanks for doing the doc refactoring.
>>
>> Agreed Steven and Russel’s suggestions.
>>
>> Wanted to discuss one suggestion,
>> Shall we have a section for “future release/plans”?
>> Where we can talk about some of the important upcoming changes or project
>> with design etc. like v3, Spark 4 etc.
>> I see value in this section, as Iceberg community is so big and wide,
>> this will help.
>>
>> Manu, Russel and Steven WDYT?
>>
>> Thanks
>> Manish
>>
>> On Sun, Feb 16, 2025 at 7:00 AM Manu Zhang <owenzhang1...@gmail.com>
>> wrote:
>>
>>> Russell and Steven,
>>>
>>> Thanks for your great suggestions. Please help review PR
>>> https://github.com/apache/iceberg/pull/12289
>>>
>>> Thanks,
>>> Manu
>>>
>>> On Sat, Feb 15, 2025 at 3:46 AM Russell Spitzer <
>>> russell.spit...@gmail.com> wrote:
>>>
>>>> That sounds good to me , "Spec" Or "Specification"
>>>>
>>>> On Fri, Feb 14, 2025 at 1:41 PM Steven Wu <stevenz...@gmail.com> wrote:
>>>>
>>>>> It makes sense to separate out the technical parts (specs) from the
>>>>> current "Project" group.
>>>>>
>>>>> For the new "technical" content (catalog, term, specs), "Concepts" is
>>>>> probably not accurate. Maybe "Spec" is more appropriate.
>>>>>
>>>>> On Thu, Feb 13, 2025 at 9:41 AM Russell Spitzer <
>>>>> russell.spit...@gmail.com> wrote:
>>>>>
>>>>>> I think we should do an even bigger change. IMHO, Project should have
>>>>>> information about interacting with the project so
>>>>>>
>>>>>> Community
>>>>>> Contributing
>>>>>> Implementation Status
>>>>>> Multi-engine Support
>>>>>> How to Release
>>>>>> ASF
>>>>>>
>>>>>> Then have Concepts include all the technical details
>>>>>> * Spec
>>>>>> Terms
>>>>>>
>>>>>> On Thu, Feb 13, 2025 at 11:27 AM Steven Wu <stevenz...@gmail.com>
>>>>>> wrote:
>>>>>>
>>>>>>> nm. Found the "Terms" from the left navigation menu under "Project".
>>>>>>> Earlier, I was looking for it from the "Project" tab which shows the
>>>>>>> "Community" page.
>>>>>>>
>>>>>>> Anyway, I agree that the content of "Terms" is more aligned with the
>>>>>>> "Concept" group than "Project" group.
>>>>>>>
>>>>>>> On Thu, Feb 13, 2025 at 9:15 AM Steven Wu <stevenz...@gmail.com>
>>>>>>> wrote:
>>>>>>>
>>>>>>>> Manu, how to navigate to the "terms" page? I can't find the "terms"
>>>>>>>> link from the project page.
>>>>>>>>
>>>>>>>> It seems reasonable to move the "Terms" content to the "Concept"
>>>>>>>> page for easier discoverability.
>>>>>>>>
>>>>>>>> On Thu, Feb 13, 2025 at 8:43 AM Manu Zhang <owenzhang1...@gmail.com>
>>>>>>>> wrote:
>>>>>>>>
>>>>>>>>> Does anyone have objections to this change? If not, I'm going to
>>>>>>>>> open a PR.
>>>>>>>>>
>>>>>>>>> On Tue, Feb 11, 2025 at 11:43 AM Manu Zhang <
>>>>>>>>> owenzhang1...@gmail.com> wrote:
>>>>>>>>>
>>>>>>>>>> Hi all,
>>>>>>>>>>
>>>>>>>>>> On the website, we have docs under Concepts with only Catalogs[1]
>>>>>>>>>> and Project/Terms[2] serving similar purposes. Do you think it's a 
>>>>>>>>>> good
>>>>>>>>>> idea to consolidate the two pages? For example, move all items under 
>>>>>>>>>> Terms
>>>>>>>>>> to Concepts for better visibility.
>>>>>>>>>>
>>>>>>>>>> 1. https://iceberg.apache.org/concepts/catalog/
>>>>>>>>>> <https://iceberg.apache.org/concepts/catalog/>
>>>>>>>>>> 2. https://iceberg.apache.org/terms/
>>>>>>>>>>
>>>>>>>>>> Thanks,
>>>>>>>>>> Manu
>>>>>>>>>>
>>>>>>>>>

Reply via email to