+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
