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