Welcome!

Apache Iceberg tracks issues in GitHub and prefers to receive contributions as pull requests.

Community discussions happen primarily on the dev mailing list, on the #iceberg channel on the ASF’s Slack workspace, and on specific Github issues.

Contributing

The Iceberg Project is hosted on Github at https://github.com/apache/iceberg.

The Iceberg community prefers to receive contributions as Github pull requests.

Issues

Issues are tracked in GitHub:

Slack

We use the #iceberg channel on the ASF’s Slack workspace. You get can an invitation to join this workspace at https://s.apache.org/slack-invite. Please note that this link occasionally breaks when Slack does an upgrade. If you encounter problems using it, please let us know by sending an email to dev@iceberg.apache.org.

Mailing Lists

Iceberg has four mailing lists:

Setting up IDE and Code Style

Configuring Code Formatter for IntelliJ IDEA

In the Settings/Preferences dialog go to Editor > Code Style > Java. Click on the gear wheel and select Import Scheme to import IntelliJ IDEA XML code style settings. Point to intellij-java-palantir-style.xml and hit OK (you might need to enable Show Hidden Files and Directories in the dialog). The code itself can then be formatted via Code > Reformat Code.

See also the IntelliJ Code Style docs and Reformat Code docs for additional details.

Running Benchmarks

Some PRs/changesets might require running benchmarks to determine whether they are affecting the baseline performance. Currently there is no “push a single button to get a performance comparison” solution available, therefore one has to run JMH performance tests on their local machine and post the results on the PR.

See Benchmarks for a summary of available benchmarks and how to run them.