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

Reply via email to