Thanks for all of the comments and feedback! @asingh yes I think once we release the new site with versioned docs, we can start to add things like docker images and more examples. I have some ideas there but PRs will definitely be welcome! Also I agree, a getting started page with docker examples would be a good landing-page item with a Learn More button that takes you directly to a page with more details.
@omar the font on the Navbar is definitely smaller, mainly to fit all of the items. If we go with a drop down menu instead, we can increase the font size. Jack and I have been putting the finishing touches on the site. I’m looking forward to its release this coming week! -Sam On Wed, Feb 2, 2022 at 12:34 PM Ashish Singh <asi...@apache.org> wrote: > The website is really great. Thanks Sam! > > Is there any plan to link docker images for users to download and try out > the examples listed on the homepage? If yes, should we maybe add it > explicitly on the homepage (somewhat at bottom after all the use-cases)? > Doesn't have to be in the first version. > > > On Tue, Feb 1, 2022 at 1:50 PM Omar Al-Safi <o...@oalsafi.com> wrote: > >> Also, wouldn't it make sense to add a section to reach the >> integration page from the landing page directly (let's see a drop down >> menu) at the top section? >> >> Regards, >> >> On Tue, Feb 1, 2022 at 10:46 PM Omar Al-Safi <o...@oalsafi.com> wrote: >> >>> Looking good, thanks Sam! >>> >>> However, is it me or is the top section a bit smaller in comparison to >>> the overall page? >>> >>> [image: Screenshot 2022-02-01 at 22.40.49.png] >>> >>> Regards, >>> Omar >>> >>> On Tue, Feb 1, 2022 at 9:09 PM Kyle Bendickson <k...@tabular.io> wrote: >>> >>>> +1 from me. This looks great. Thank you for all your hard work, Sam! >>>> >>>> On Tue, Feb 1, 2022 at 10:33 AM Jack Ye <yezhao...@gmail.com> wrote: >>>> >>>>> +1, amazing website! And now the website repo is separated we can >>>>> continue to iterate and deploy quickly without affecting the main repo, so >>>>> no need to be 100% perfect as of now. >>>>> >>>>> I will update the 0.13 release note against the new website and we can >>>>> announce them together. >>>>> >>>>> Best, >>>>> Jack Ye >>>>> >>>>> On Tue, Feb 1, 2022 at 8:26 AM Ryan Blue <b...@tabular.io> wrote: >>>>> >>>>>> Good catch. Looks like the anchor links on the spec page are broken. >>>>>> We'll have to get those fixed. >>>>>> >>>>>> I think we should move forward with the update and fix these as we >>>>>> come across them. It's inevitable that we'll have some broken things in a >>>>>> big change, but we don't want to block this improvement on being 100% >>>>>> perfect. >>>>>> >>>>>> On Tue, Feb 1, 2022 at 1:21 AM Ajantha Bhat <ajanthab...@gmail.com> >>>>>> wrote: >>>>>> >>>>>>> Nice looking website. >>>>>>> >>>>>>> Is the shared link the final version ? I couldn't see the markdown >>>>>>> anchor tag inside https://iceberg.redai.dev/spec/ >>>>>>> It will be useful to have that for sharing specific parts of the >>>>>>> spec. >>>>>>> >>>>>>> Also some pages are in light theme and some are in dark theme. >>>>>>> Better to have a unified theme. >>>>>>> >>>>>>> +1 for versioning and overall work. >>>>>>> >>>>>>> Thanks, >>>>>>> Ajantha >>>>>>> >>>>>>> On Tue, Feb 1, 2022 at 1:47 PM Eduard Tudenhoefner < >>>>>>> edu...@dremio.com> wrote: >>>>>>> >>>>>>>> +1 on the procedure and the new site looks amazing >>>>>>>> >>>>>>>> On Tue, Feb 1, 2022 at 3:38 AM Ryan Blue <b...@tabular.io> wrote: >>>>>>>> >>>>>>>>> +1 from me. I think the new site looks great and it is a big >>>>>>>>> improvement to have version-specific docs. Thanks for all your work on >>>>>>>>> this, Sam! >>>>>>>>> >>>>>>>>> On Mon, Jan 31, 2022 at 5:48 PM Sam Redai <s...@tabular.io> wrote: >>>>>>>>> >>>>>>>>>> Hey Everyone, >>>>>>>>>> >>>>>>>>>> With 0.13.0's approval for release, I think this would be a good >>>>>>>>>> time to have a discussion around the proposed versioned >>>>>>>>>> documentation site, >>>>>>>>>> powered by Hugo. The site is ready to be released and the source >>>>>>>>>> code for >>>>>>>>>> the site can be found in the apache/iceberg-docs repository: >>>>>>>>>> https://github.com/apache/iceberg-docs. >>>>>>>>>> >>>>>>>>>> In order for everyone to see a dev version of the site live, I've >>>>>>>>>> deployed it temporarily to: https://iceberg.redai.dev >>>>>>>>>> >>>>>>>>>> The markdown files will remain in the apache/iceberg repository >>>>>>>>>> and will represent the latest unreleased documentation. PRs for >>>>>>>>>> changes to >>>>>>>>>> documentation will be made against the apache/iceberg repository. >>>>>>>>>> During a >>>>>>>>>> release, the current version of the docs will be copied from >>>>>>>>>> apache/iceberg, to apache/iceberg-docs, where a new version can then >>>>>>>>>> be >>>>>>>>>> deployed by creating a version branch. With the current >>>>>>>>>> configuration, a >>>>>>>>>> new version of the documentation site is deployed for each branch >>>>>>>>>> name, for >>>>>>>>>> example creating an `0.13.0` branch will deploy an `0.13.0` version >>>>>>>>>> of the >>>>>>>>>> site. A particular version can be reached at /docs/<version>. We >>>>>>>>>> will also >>>>>>>>>> maintain a `latest` branch which will be a clone of the latest >>>>>>>>>> version >>>>>>>>>> branch. All links at the top level (such as from the landing-page) >>>>>>>>>> will >>>>>>>>>> link to the `docs/latest` site. >>>>>>>>>> >>>>>>>>>> If everyone is ok with this, I'll reach out to the ASF infra team >>>>>>>>>> to begin the process. >>>>>>>>>> >>>>>>>>>> Thanks! >>>>>>>>>> -Sam >>>>>>>>>> >>>>>>>>> >>>>>>>>> >>>>>>>>> -- >>>>>>>>> Ryan Blue >>>>>>>>> Tabular >>>>>>>>> >>>>>>>> >>>>>> >>>>>> -- >>>>>> Ryan Blue >>>>>> Tabular >>>>>> >>>>>