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