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